Data
Table
Composes native table markup inside a named scroll region; the application owns its records and calculations.
idle
Usage
Anatomy
The parts and how they nest, taken from the preview above.
Examples
Monthly operating budget
Recommendations
| Guidance | Practice |
|---|---|
| Do | Use row headers for identifying columns and align numeric values consistently. |
| Do | Keep wide records inside the named TableContainer scroll region. |
Usage boundaries
| Guidance | Boundary |
|---|---|
| Scope | Table provides semantic presentation, not sorting or row-selection state. |
| Scope | Use Data Table when the task needs filtering, sorting, selection, or virtualization. |
API reference
Public props from @mizen-labs/ui. Use exported prop types for the complete TypeScript contract.
| Prop | Type | Default | Description |
|---|---|---|---|
| | Required | Names the keyboard-scrollable region around the table. |
| | "horizontal" | Sets the scroll axes; two-axis scrolling is bounded to 28rem high. |
| | — | Compose native table sections. The header sticks by default. |
| | false | Spreadsheet presentation: column rules and compact rows. "interactive" adds the ARIA grid role; use it only with a keyboard model, as DataTable does. |
| | None / true | width fixes the layout to sized columns; focusable={false} drops the scroll region's tab stop when a grid inside moves focus itself. |
| | false | Shows caller-owned selected-row styling without adding selection behavior. |
| | "col" | Declares a column heading or row heading. Use row scope for the first cell in a data row. |
| | "start" | Aligns cell content. |
| | false | Aligns numeric values at the logical end with tabular numerals; explicit align takes precedence. |
| | false | Pins a first-column cell on wide screens; it unpins below 40rem. Apply it to the header, row headings, and footer cell. |
| | — | Provides a visible caption and accessible table context. |