Select

pywry.toolbar.Select

Bases: ToolbarItem

A single-select dropdown with optional search.

Emits {value: ..., componentId: ...} on selection change.

ATTRIBUTE	DESCRIPTION
options	List of Option items for the dropdown. TYPE: list of Option
selected	Currently selected value. TYPE: str
searchable	Enable search input to filter options (default: False). TYPE: bool

Examples:

>>> Select(
...     label="Theme:",
...     event="theme:change",
...     options=[
...         Option(label="Dark", value="dark"),
...         Option(label="Light", value="light"),
...     ],
...     selected="dark",
...     searchable=True,
... )

Functions

normalize_options classmethod

normalize_options(v: Any) -> list[Option]

Accept list of dicts or Option objects.

build_html

build_html() -> str

Build custom dropdown HTML (not native select, for consistent styling).

auto_generate_component_id

auto_generate_component_id() -> ToolbarItem

Auto-generate component_id based on type if not provided.

validate_event_name classmethod

validate_event_name(v: str) -> str

Validate event follows namespace:event-name pattern.