Text Area

class marimo.ui.text_area(value: str = '', placeholder: str = '', max_length: int | None = None, disabled: bool = False, debounce: bool | int = True, rows: int | None = None, *, label: str = '', on_change: Callable[[str], None] | None = None, full_width: bool = False)

A text area that is larger than ui.text.

Example.

text_area = mo.ui.text_area()

Attributes.

  • value: a string of the text area contents

Initialization Args.

  • value: initial value of the text area

  • placeholder: placeholder text to display when the text area is empty

  • max_length: maximum length of input

  • disabled: whether the input is disabled

  • debounce: whether the input is debounced. If number, debounce by that many milliseconds. If True, then value is only emitted on Ctrl+Enter or when the input loses focus.

  • rows: number of rows of text to display

  • label: text label for the element

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

  • full_width: whether the input should take up the full width of its container

Public methods

Inherited from UIElement

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

Create a submittable form out of this UIElement.

send_message(message, buffers)

Send a message to the element rendered on the frontend from the backend.

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.