Table

class marimo.ui.table(data: ListOrTuple[str | int | float | bool | MIME | None] | ListOrTuple[Dict[str, JSONType]] | Dict[str, ListOrTuple[JSONType]] | 'IntoDataFrame', pagination: bool | None = None, selection: Literal['single', 'multi'] | None = 'multi', page_size: int = 10, show_column_summaries: bool = True, format_mapping: Dict[str, str | Callable[..., Any]] | None = None, freeze_columns_left: Sequence[str] | None = None, freeze_columns_right: Sequence[str] | None = None, *, label: str = '', on_change: Callable[[List[JSONType] | Dict[str, ListOrTuple[JSONType]] | 'IntoDataFrame'], None] | None = None, _internal_column_charts_row_limit: int | None = None, _internal_summary_row_limit: int | None = None, _internal_total_rows: int | Literal['too_many'] | None = None)

A table component with selectable rows. Get the selected rows with table.value.

The table data can be supplied a:

  1. a list of dicts, with one dict for each row, keyed by column names;

  2. a list of values, representing a table with a single column;

  3. a Pandas dataframe; or

  4. a Polars dataframe; or

  5. an Ibis dataframe; or

  6. a PyArrow table.

Examples.

Create a table from a list of dicts, one for each row.

table = mo.ui.table(
    data=[
        {"first_name": "Michael", "last_name": "Scott"},
        {"first_name": "Dwight", "last_name": "Schrute"},
    ],
    label="Users",
)

Create a table from a single column of data:

table = mo.ui.table( data=[ {‘first_name’: ‘Michael’, ‘last_name’: ‘Scott’}, {‘first_name’: ‘Dwight’, ‘last_name’: ‘Schrute’} ], label=‘Users’ )

Create a table from a dataframe:

# df is a Pandas or Polars dataframe
table = mo.ui.table(
    data=df,
    # use pagination when your table has many rows
    pagination=True,
    label="Dataframe",
)

Create a table with format mapping:

# format_mapping is a dict keyed by column names,
# with values as formatting functions or strings
def format_name(name):
    return name.upper()


table = mo.ui.table(
    data=[
        {"first_name": "Michael", "last_name": "Scott", "age": 45},
        {"first_name": "Dwight", "last_name": "Schrute", "age": 40},
    ],
    format_mapping={
        "first_name": format_name,  # Use callable to format first names
        "age": "{:.1f}".format,  # Use string format for age
    },
    label="Format Mapping",
)

In each case, access the table data with table.value.

Attributes.

  • value: the selected rows, in the same format as the original data, or None if no selection

  • data: the original table data

Initialization Args.

  • data: Values can be primitives (str, int, float, bool, or None) or marimo elements: e.g. mo.ui.button(...), mo.md(...), mo.as_html(...), etc. Data can be passed in many ways:

    • as dataframes: a pandas dataframe, a polars dataframe

    • as rows: a list of dicts, where each dict represents a row in the table

    • as columns: a dict keyed by column names, where the value of each entry is a list representing a column

    • as a single column: a list of values

  • pagination: whether to paginate; if False, all rows will be shown defaults to True when above 10 rows, False otherwise

  • selection: ‘single’ or ‘multi’ to enable row selection, or None to disable

  • page_size: the number of rows to show per page. defaults to 10

  • show_column_summaries: whether to show column summaries

  • format_mapping: a mapping from column names to formatting strings or functions

  • freeze_columns_left: list of column names to freeze on the left

  • freeze_columns_right: list of column names to freeze on the right

  • label: markdown label for the element

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

Public methods

download_as(args)

get_column_summaries(args)

search(args)

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:

data

Inherited from UIElement

value

The element’s current value.

Inherited from Html

text

A string of HTML representing this element.