pattern-library 4 linked patterns 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.
Read with a purpose
What this source can teach
Use this source to compare a documented solution with the task and states in your own product.
- Start with the original. Open the source and find the guidance or example relevant to your task.
- Trace the connection. Use the claim notes below to see how this site applies the source to specific patterns.
- Check the setting. Compare the source's platform, people, and constraints with your own decision.
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. Its value comes from the specific claims and setting described above.
Publisher: Carbon Design System. Last checked: .