pattern-library checked
Carbon Design System Data Table
Documents sortable data-table columns, sorted and unsorted header states, arrow indicators, sortable header placement, toolbar separation, search behavior, pagination placement, expandable rows for supplementary detail, and related table interactions.
Pattern Decisions This Source Supports
| Pattern | Supported decision | Required contract | Claim note |
|---|---|---|---|
| Expandable row | Choose expandable row when the main surface is a table or list and the extra content is owned by one row. | The expand control names the affected row, exposes expanded state, and controls only that row's detail region. | Carbon data table guidance supports expandable rows for supplementary row detail and escalation when expanded content becomes cramped. |
| Sort controls | Choose sort controls when the same result set can be usefully ordered by two or more meaningful attributes. | Changing a Sort by select applies the new order to the full current result set and keeps unrelated query and filter state intact. | Carbon documents sortable table header states, indicators, and interaction placement inside data tables. |
| Table | Choose table when each row represents one record and each column represents the same attribute for every row. | The table caption or nearby heading names the dataset and purpose, not just Table. | Carbon data table guidance supports sorting, toolbar separation, row selection, expansion, and pagination placement. |
| User-controlled density | Choose user-controlled density when users need to decide how much vertical or horizontal spacing a surface uses without changing which data is included. | Changing density updates row height, padding, and compatible controls without reordering data, changing filters, clearing selection, or discarding edits. | Carbon documents table row sizing and matching table header sizing. |
Evidence Role
This source is treated as pattern-library evidence. Use it to validate the decision rules above, not as a visual style reference.
Publisher: Carbon Design System. Last checked: .