Form Dialog

FormDialog embeds a Form in a dialog. Pass data= to generate fields automatically from a dict, or items= for an explicit layout.

Usage

Auto-generated fields

Pass a dict to data=. Keys become field labels; values are the initial field contents:

from bootstack.dialogs import FormDialog

dlg = FormDialog(
    title="Edit Profile",
    data={"username": "alice", "bio": "", "website": ""},
)
dlg.show()

if dlg.result:
    update_profile(dlg.result)

The returned result is a dict with the same keys as data, filled with the user’s input. It is None when the user cancels.

Multiple columns

Use col_count= to lay fields out in multiple columns:

dlg = FormDialog(
    title="Shipping Address",
    data={"street": "", "city": "", "state": "", "zip": ""},
    col_count=2,
)
dlg.show()

Reactive updates

Use on_data_change= to respond to every field change while the dialog is open:

def on_change(data):
    print(f"Current values: {data}")

dlg = FormDialog(
    title="Live Preview",
    data={"title": "", "description": ""},
    on_data_change=on_change,
)
dlg.show()

Resizable dialog

Pass resizable=True to allow the user to resize the dialog window:

dlg = FormDialog(
    title="Notes",
    data={"content": ""},
    resizable=True,
    min_size=(400, 200),
)
dlg.show()

See also

Dialog — Dialog for fully custom layouts without a built-in form.

Form — standalone Form widget for embedding inside an app window.

API

The complete reference for FormDialog lives on the Dialogs API page. At a glance:

FormDialog

A dialog window that embeds a Form for structured data entry.

Full Example

from bootstack.dialogs import FormDialog
def show_simple():
    dlg = FormDialog(
        title="New Contact",
        data={"name": "", "email": "", "phone": ""},
    )
    dlg.show()

def show_multi_col():
    dlg = FormDialog(
        title="Shipping Address",
        data={"street": "", "city": "", "state": "", "zip": ""},
        col_count=2,
    )
    dlg.show()

with bs.App(title="Form Dialog", size=(680, 400), padding=20, gap=16) as app:

    with bs.HStack(gap=8):
        bs.Button("New Contact",      on_click=show_simple)
        bs.Button("Address (2 cols)", on_click=show_multi_col)

app.run()