# `gradio_modal` PyPI - Version A popup modal component ## Installation ```bash pip install gradio_modal ``` ## Usage ```python import gradio as gr from gradio_modal import Modal with gr.Blocks() as demo: with gr.Tab("Tab 1"): text_1 = gr.Textbox(label="Input 1") text_2 = gr.Textbox(label="Input 2") text_1.submit(lambda x:x, text_1, text_2) show_btn = gr.Button("Show Modal") gr.Examples( [["Text 1", "Text 2"], ["Text 3", "Text 4"]], inputs=[text_1, text_2], ) with gr.Tab("Tab 2"): gr.Markdown("This is tab 2") with Modal(visible=False) as modal: gr.Markdown("Hello world!") show_btn.click(lambda: Modal(visible=True), None, modal) if __name__ == "__main__": demo.launch() ``` ## `Modal` ### Initialization
name type default description
visible ```python bool ``` False If False, modal will be hidden.
elem_id ```python str | None ``` None An optional string that is assigned as the id of this component in the HTML DOM. Can be used for targeting CSS styles.
elem_classes ```python list[str] | str | None ``` None An optional string or list of strings that are assigned as the class of this component in the HTML DOM. Can be used for targeting CSS styles.
allow_user_close ```python bool ``` True If True, user can close the modal (by clicking outside, clicking the X, or the escape key).
render ```python bool ``` True If False, component will not render be rendered in the Blocks context. Should be used if the intention is to assign event listeners now but render the component later.
### Events | name | description | |:-----|:------------| | `blur` | This listener is triggered when the Modal is unfocused/blurred. |