Dictionary

class marimo.ui.dictionary(elements: dict[str, marimo._plugins.ui._core.ui_element.UIElement[Any, Any]], *, label: str = '', on_change: Callable[[dict[str, object]], None] | None = None)

A dictionary of UI elements.

Use a dictionary to - create a set of UI elements at runtime - group together logically related UI elements - keep the number of global variables in your program small

The UI elements in the dictionary are clones of the original elements: interacting with the dictionary will not update the original elements, and vice versa.

Examples.

A heterogeneous collection of UI elements:

d = mo.ui.dictionary({
        "slider": mo.ui.slider(1, 10),
        "text": mo.ui.text(),
        "date": mo.ui.date()
    })

# d.value returns a dict with keys "slider", "text", "date"
d.value

Some number of UI elements, determined at runtime:

mo.ui.dictionary({
    f"option {i}": mo.ui.slider(1, 10)
    for i in range random.randint(4, 8)
})

Attributes.

• value: a dict holding the values of the UI elements, keyed by their names.

• elements: a dict of the wrapped elements (clones of the originals)

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

Initialization Args.

• elements: a dict mapping names to UI elements to include

• label: a descriptive name for the dictionary to trigger value updates

Public methods

Inherited from UIElement

form([label])

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.

Public Data Attributes:

Inherited from _batch_base

elements

Inherited from UIElement

value

The element’s current value.

Inherited from Html

text	A string of HTML representing this element.

---