widget · ui.widget
list
Scroll-bounded selectable rows with stable activation identities.
ui.list(action_id, rows, options?)
- Stable ID
ui.widget.list- Owner
- app.ScriptUiWidget
- Authority
- presentation
- Timing
- composition
- Availability
- Phase 19Q9B
- Side effects
- Records detached presentation intent.
- Determinism
- Emission order and stable row identity.
- Introduced
- 1.19.0
Usage
Compose a bounded selectable list inside a panel. Row activation preserves the selected stable identity instead of deriving behavior from visible text.
Parameters
- None
Returns
A stable widget contract consumed by the interface composition host.
Cost
The list and every contained row count against the bounded widget budget.
Fields
This symbol has no fields.
Errors
- None
Examples
ui.list("ui.action.alert.select", alert_rows, {visible_rows = 4})
API history
- 1.19.0: Added selectable list presentation for Phase 19Q9B.