Data List¶
A list of records rendered as cards or rows rather than columns.
Display widgets · widget type data-list · binds through a data source, $record in templates
Related: Data Table · Custom Table · Section
Options¶
| Option | Values | Default | Description |
|---|---|---|---|
| Data options | Data source · Key value | Data source | Whether records come from data or from a list you author |
| Data source | An expression, e.g. {$data.customers} |
— | The records to render |
| Items | A list of entries | — | Used in Key value mode; each entry has an id and a label |
| Item type | Text · Expression · HTML · Element | Text | How each record is rendered. Element uses a widget template you build once and repeat per record |
| Text template / Expression / HTML template | Template | — | The item content, for the matching Item type |
| Group by field | A record field | None | Groups items under headings |
| Empty text | Any text | No items to display |
Shown when the source returns nothing |
| Selection | Single · Multiple, with a state path | Off | Publishes the clicked record |
| Transformation | Steps | None | Filter, sort and shape the rows before rendering |
| List Style / Item Style / Cursor Style | CSS | Empty | Styling per part |
| Box Style | Sizing and spacing | — | The box around the list |
Notes¶
$recordis the current item in every template and expression- Element item type is the one to reach for when each row is a small card of several widgets