Form

class marimo.ui.form(element: UIElement[S, T], *, bordered: bool = True, loading: bool = False, submit_button_label: str = 'Submit', submit_button_tooltip: str | None = None, submit_button_disabled: bool = False, clear_on_submit: bool = False, show_clear_button: bool = False, clear_button_label: str = 'Clear', clear_button_tooltip: str | None = None, validate: Callable[[Mapping[str, Mapping[str, JSONType] | Sequence[JSONType] | str | int | float | bool | MIME | None] | Sequence[Mapping[str, JSONType] | Sequence[JSONType] | str | int | float | bool | MIME | None] | str | int | float | bool | MIME | None], str | None] | None = None, label: str = '', on_change: Callable[[T | None], None] | None = None)

A submittable form linked to a UIElement.

Use a form to prevent sending UI element values to Python until a button is clicked.

The value of a form is the value of the underlying element the last time the form was submitted.

Example.

# Create a form with chaining
form = mo.ui.slider(1, 100).form()

# Create a form with multiple elements
form = mo.md('''
    **Your form.**

    {name}

    {date}
''').batch(
    name=mo.ui.text(label='name'),
    date=mo.ui.date(label='date'),
).form(show_clear_button=True, bordered=False)

# Instantiate a form directly
form = mo.ui.form(element=mo.ui.slider(1, 100))

Attributes.

• value: the value of the wrapped element when the form’s submit button was last clicked

• element: a copy of the wrapped element

Initialization Args.

• element: the element to wrap

• bordered: whether the form should have a border

• loading: whether the form should be in a loading state

• submit_button_label: the label of the submit button

• submit_button_tooltip: the tooltip of the submit button

• submit_button_disabled: whether the submit button should be disabled

• clear_on_submit: whether the form should clear its contents after submitting

• show_clear_button: whether the form should show a clear button

• clear_button_label: the label of the clear button

• clear_button_tooltip: the tooltip of the clear button

• validate: a function that takes the form’s value and returns an error message if the value is invalid, or None if the value is valid

• label: text label for the form

• on_change: optional callback to run when this element’s value changes

Public methods

Inherited from UIElement

form([label, bordered, loading, ...])

Create a submittable form out of this UIElement.

Inherited from Html

batch(**elements)	Convert an HTML object with templated text into a UI element.
center()	Center an item.
right()	Right-justify.
left()	Left-justify.
callout([kind])	Create a callout containing this HTML element.
style(style)	Wrap an object in a styled container.

Public Data Attributes:

Inherited from UIElement

value

The element’s current value.

Inherited from Html

text	A string of HTML representing this element.

---