ui · 6 variants · 1 categories
Data Grid
Sortable, filterable, groupable table with toolbar, selection, and inline bar visualizations.
npx "@rueda.dev/gems-diamond" add data-grid Display
6 variantsAll 48
| Order | Customer | Total |
|---|---|---|
| #1042 | A. Chen | $184 |
| #1041 | M. Tan | $96 |
| #1040 | L. Reyes | $312 |
1–3 of 48‹ 1 2 3 ›
toolbarActiveArchived
| Order | Customer | Total |
|---|---|---|
| #1042 | A. Chen | $184 |
| #1041 | M. Tan | $96 |
| #1040 | L. Reyes | $312 |
filter$ grep --filter status=ok
| Order | Customer | Total |
|---|---|---|
| #1042 | A. Chen | $184 |
| #1041 | M. Tan | $96 |
| #1040 | L. Reyes | $312 |
terminal3 selectedArchive
| Order | Customer | Total |
|---|---|---|
| #1042 | A. Chen | $184 |
| #1041 | M. Tan | $96 |
| #1040 | L. Reyes | $312 |
bulkGroup by: Category
| Order | Customer | Total |
|---|---|---|
| #1042 | A. Chen | $184 |
| #1041 | M. Tan | $96 |
| #1040 | L. Reyes | $312 |
grouped| Name | Score |
|---|---|
| Alpha | 94 |
| Beta | 78 |
barchartUsage Guide
How to wire up this component in your app — props, callbacks, customization, and the conventions Diamond shares across the library.
Composition
columns+rowsfor flat lists.columnsentries can supplyrender(row, i)for custom cells andbar(row)(returns 0-100) for inline bar charts.groupsfor thegroupedvariant — each group haslabel+rows+collapsed?.toolbarandpaginationare slot ReactNodes — provide your own controls and the grid renders them in the chrome.
Selection
Pass selectedIds (a Set) + onSelectionChange for the bulk variant. rowId(row) tells the grid how to key each row.
Universal patterns
Every Diamond component shares the same prop conventions, so once you learn one you can predict the others.
variant— discriminated union of every visual option. Categories shown above are docs-only metadata; the prop is a flat string union.accent— any CSS color string. Overrides--diamond-accentjust for that instance via inlinestyle. Cascades into hover, ring, and selection states.asChild(when present) — renders the underlying primitive via@radix-ui/react-slot, letting you compose with<Link>,motion.button, etc.className— merged with internal Tailwind classes viacn(). Use it to override layout, spacing, or colors.- Native HTML attributes (
onClick,aria-*,data-*,ref, etc.) flow through to the root element without any whitelist. - Diamond is the skin: zero domain state, zero fetch, zero providers. You wire data and reactions in your app code; the components just render and emit events.