dlt._workspace.helpers.dashboard.utils.ui

Dashboard UI helpers: tables, callouts, section boilerplate, and shared utilities.

BoundedDict Objects

class BoundedDict(Dict[Any, Any])

View source on GitHub

Dict that evicts the oldest entry when maxsize is exceeded.

dlt_table

def dlt_table(data: Union[List[Dict[str, Any]], pyarrow.Table],
              *,
              selection: Optional[str] = None,
              style: bool = True,
              freeze_column: Optional[str] = "name",
              initial_selection: Optional[List[int]] = None,
              pagination: Optional[bool] = None,
              show_download: Optional[bool] = None,
              **kwargs: Any) -> mo.ui.table

View source on GitHub

Create a styled mo.ui.table with common dashboard defaults.

Applies alternating-row styling, freezes the given column, aligns dict keys, and sets initial_selection to None when data is empty.

Arguments:

• data - Table data as a list of dicts or a pyarrow Table.
• selection - Selection mode ("single", "multi") or None to disable.
• style - Whether to apply alternating-row cell styling.
• freeze_column - Column name to freeze on the left. Pass None to disable.
• initial_selection - Row indices to pre-select. Forced to None when data is empty.
• pagination - Passed through to mo.ui.table.
• show_download - Passed through to mo.ui.table.

small

def small(text: str) -> str

View source on GitHub

Wrap text in <small> HTML tags for consistent dashboard styling.

error_callout

def error_callout(message: str,
                  code: str = None,
                  traceback_string: str = None) -> mo.Html

View source on GitHub

Build a callout with a message and a exposable stacktrace.

Arguments:

• message str - The message to display in the callout.
• code str - The code to display in the callout.
• traceback_string str - The traceback to display in the callout.

Returns:

• mo.ui.Callout - The callout with the message and the stacktrace.

title_and_subtitle

def title_and_subtitle(title: str,
                       subtitle: str = None,
                       title_level: int = 2) -> mo.Html

View source on GitHub

Build a title and a subtitle block

page_header

def page_header(dlt_pipeline: dlt.Pipeline,
                section_strings: TSectionStrings,
                button: mo.ui.switch = None) -> List[mo.Html]

View source on GitHub

Build a page header with a title, a subtitle, button and conditional longer subtitle

section_marker

def section_marker(section_name: str, has_content: bool = False) -> mo.Html

View source on GitHub

Create an invisible marker element to identify sections for CSS styling.

Arguments:

• section_name - Name identifier for the section (e.g., "home_section", "schema_section")
• has_content - If True, adds 'has-content' class to enable CSS styling (borders, backgrounds). Should be True only when the section has actual content and is displayed.

Returns:

Hidden HTML div element with section marker classes for CSS targeting.

section

def section(section_strings: TSectionStrings, dlt_pipeline: dlt.Pipeline,
            switch: mo.ui.switch) -> Tuple[List[mo.Html], bool]

View source on GitHub

Build standard section boilerplate: marker + page header.

Returns:

Tuple of (result list, should_render_content). The list already contains the section marker and header. Append content only when should_render_content is True, then call mo.vstack(result).