DataTableRows
Container that iterates data items and renders DataTableRow, group header rows, skeleton/loading rows, and an empty-state row.
Structure
Anatomy
Visual breakdown of the component's internal structure with BEM class call-outs.
<origam-data-table-rows> — 4 output variants: data row ①, group header row ②, empty state ③, and skeleton/loading ④.- 1OrigamDataTableRow
- Standard
OrigamDataTableRowrendered for each flat data item. Receives computeditemSlotProps.propsincluding key, onClick, mobileBreakpoint and aria-rowindex. - 2OrigamDataTableGroupHeaderRow
OrigamDataTableGroupHeaderRowrendered for group items (type === "group"). Receives toggleGroup, isGroupOpen and selection/expand context.- 3.origam-data-table-rows--no-data
- Single full-width row rendered when items is empty and hideNoData=false. Text aligned center via --origam-data-table-empty---text-align.
- 4.origam-data-table-rows--skeleton / --loading
- Loading state rows. Skeleton mode: 5
<tr aria-busy="true">rows with oneOrigamSkeletonper cell. Text mode: single row with localised loading text.
API
Props
All props accepted by this component, with their type, default value and description.
- hideNoDatabooleanfalse
- Suppresses the empty-state row when there are no items.
- itemsArray<IDataTableItem | IDataTableGroup> | readonly (IDataTableItem | IDataTableGroup)[]
- Array of internal item or group descriptors to render. Provided by the DataTable parent via useGroupBy / usePagination.
- noDataTextstring'origam.noDataText'
- i18n key for the text shown in the empty-state row. Resolved via useLocale.
- rowPropsTDataTableRow<any>
- Static or callback props merged onto every DataTableRow. A function receives { item, index, internalItem }.
- cellPropsTDataTableCell<any>
- Static or callback props forwarded to every DataTableColumnCell in every row.
- idstring
- colorTColor
- loadingTLoadingValuefalse
- When truthy, renders loading rows instead of data. Accepts true (default text row), "skeleton" (OrigamSkeleton per cell), "line" or "circular".
- mobilebooleanfalse
- Forces mobile stacked layout on all rows.
- loadingTextstring'origam.dataIterator.loadingText'
- i18n key for the loading state text. Resolved via useLocale.
- mobileBreakpointnumber | TBreakpoint
- Viewport width threshold below which mobile layout is automatically activated on all rows.
API
Slots
Content slots exposed by this component.
- #loading
- Overrides the default loading text inside the loading row (when kind is not "skeleton").
- #no-data
- Overrides the default empty-state text in the no-data row.
- #group-header
- Overrides the default DataTableGroupHeaderRow for group items.
- #item
- Overrides the default DataTableRow rendering for a data item. The props field contains all computed row props (key, onClick, cellProps, mobileBreakpoint, aria-rowindex, etc.).
- #expanded-row
- Content rendered in the expanded row below a data item when isExpanded(item) is true.
- #data-table-group
- #data-table-select
API
Emits
Events emitted by this component.
- @expand{ item: IDataTableItem, value: boolean }
- @select{ item: IDataTableItem, value: boolean }
API
Exposed members
Properties and methods accessible via template ref (defineExpose). Use them for programmatic control.
- <T extends object>(props: T, exclude?: string[]) => Partial<T>
- Utility to forward a filtered subset of props to child row components.
Customisation
CSS variables
CSS custom properties exposed by this component. Override them to customise the component without losing theme compatibility.
- Text colour of the empty-state row.
- Text colour of the text loading row.
- Text alignment of the empty-state content.
Inclusion
Accessibility
ARIA roles, keyboard navigation and focus management. Sourced from the real component template.
ARIA roles
Keyboard interactions
| Key | Action |
|---|---|
| Tab | Moves focus through interactive elements inside rows (checkboxes, expand buttons, clickable cells). |
Notes
- Skeleton placeholder rows expose <code>aria-busy="true"</code> on each <code><tr></code> to signal screen readers that content is loading.
- <code>aria-rowindex</code> is set on each data row (startIndex + index + 2) to give screen readers accurate row position information in paginated tables.
- The empty-state row uses a <code><td colspan></code> spanning all columns, with centred text. Override the no-data slot to provide a more descriptive message for screen reader users.
Foundation
Design tokens
Excerpt from this component's token declarations — the --origam-<component>---<property> variables, declared in its hand-maintained token sheet with no build step.
- colorvar(--origam-color__surface---default)
- Default row background.
Interactive
Playground
Edit props live and see the component update in real time. The generated code snippet updates as you change values.
This is an internal sub-part: it is injected by its parent component and cannot render on its own. See the parent component page for a live example.
Rendering the live preview…
Usage
Examples
Ready-to-paste code snippets for your templates.
Skeleton loading state
Custom empty state
Ecosystem
Family
Components from the same folder that share conventions and often compose together.
DataTable
Full-featured data table with sorting, pagination, selection and grouping.
DataTableRow
Single data row rendering each column cell.
DataTableHeaders
Header row container that renders all column header cells and an optional loader.
DataTableHeaderCell
Individual th cell in a DataTable header row with sort support.