RowItems
The mock's .rows of .rowi (soft, radius 16, 12 16): a list of people or products with a figure at the end. A row with onSelect is one real button with a trailing › (mirrored in RTL). An empty list shows empty. Lead and value are isolated in their own script's direction (B15).
import { RowItems } from '@ergasti/bricks';Examples
Row items
A labelled list of rows with a lead and an end value; a row with onSelect is a button with a chevron. The status words come from the TRNDR preset, so this example is pinned to it.
Code
import { CreatorCell, Money, RowItems, StatusPill } from '@ergasti/bricks';
import { blocksData } from './sample-data';
function Picked() {
const statuses = ['pending', 'shipped', 'delivered'];
return (
<div style={{ maxWidth: 460 }}>
<RowItems
label="Picked by"
heading="Picked by"
items={blocksData.MINE.slice(0, 3).map((c, i) => ({
id: c.id,
lead: <CreatorCell id={c.id} name={c.name} identity={{ handle: null, invitedByYou: false, links: null, avatarUrl: c.avatarUrl }} sub="13 Nov 2026" />,
value: i === 0 ? <Money value="600.00" /> : <StatusPill status={statuses[i]} />,
onSelect: () => {},
}))}
/>
<RowItems label="Nobody yet" items={[]} empty="Nobody has picked this gift yet." />
</div>
);
}Chevrons and a money heading
chevron draws the chevron on every row (also rows without onSelect); figure says the values are that money figure and puts its "?" on the heading once.
Code
import { Money, MoneyNotesProvider, RowItems, useLanguage } from '@ergasti/bricks';
import { blocksData, moneyNotes } from './sample-data';
function Money_() {
const language = useLanguage();
return (
<MoneyNotesProvider notes={moneyNotes(language)}>
<div style={{ maxWidth: 460 }}>
<RowItems label="Paid this month" heading="Paid this month" figure="paid" chevron items={blocksData.MINE.slice(0, 2).map((c, i) => ({ id: c.id, lead: c.name, value: <Money value={['1200.00', '860.50'][i]} /> }))} />
</div>
</MoneyNotesProvider>
);
}A muted end hint
valueTone: 'muted' draws a row's value as plain grey 12px text, for a hint such as "Open →" rather than a figure.
Code
import { RowItems } from '@ergasti/bricks';
import { blocksData } from './sample-data';
function MutedValue() {
return (
<div style={{ maxWidth: 460 }}>
<RowItems label="Creator" items={blocksData.MINE.slice(0, 1).map((c) => ({ id: c.id, lead: c.name, value: 'Open →', valueTone: 'muted' as const, onSelect: () => {} }))} />
</div>
);
}Props
Prop
Type
Design guidance
How the BRICKS design system uses RowItems. Written in docs/content/components/RowItems.md; the props above are read from the code, which wins where the two disagree.
A list of soft rows, each a person or product cell with a figure or pill at the end, optionally under a small heading; use it in drawers and cards for short "who / what" lists such as "Picked by" or "Top creators for it".
It is the brand mock's .rows of .rowi tiles (soft, radius 16, padding 12 16), used in the gift, order and product drawers; the PR Portal uses the same pattern for "Needs attention" rows. A row with onSelect is one real button (with an optional trailing ›), so a whole row opens what it stands for.
Anatomy
- Heading (
.kit-blk-h3, optional): display face 14px, 700, 22px above; gets the money figure's "?" (MoneyNote) whenfigureis set. - List (
<ul class="kit-blk-rows">, gap 8, named bylabel). - Row (
.kit-blk-rowi): a<div>, or a<button>whenonSelectis set;--softfill. - Lead (
.kit-blk-rowi-lead): the cell (CreatorCell,ProductCell,BrandCell), isolated. - Value (
.kit-blk-rowi-v): bold, no-wrap figure or pill;mutedmakes it 12px grey text ("Open →"). - Chevron (
.kit-blk-chev, optional): "›", mirrored in RTL, decorative.
Variants
| Prop | Value | Look | Use when |
|---|---|---|---|
RowItem.valueTone | 'default' | Bold ink value | A figure or a status pill. |
RowItem.valueTone | 'muted' | Grey 12px | A hint ("Open →"). |
chevron | true | › at the end of clickable rows | Rows open a drawer. |
heading | node | Small heading above | Inside drawers ("Picked by"). |
figure | MoneyFigureKey | "?" note after the heading | The values are one money figure. |
States
| State | How |
|---|---|
| Static rows | no onSelect. |
| Clickable | onSelect: cursor pointer, hover --color-surface-hover, focus ring on the button. |
| Empty | items=[]: the heading still shows, then empty (or nothing). |
| Long lead | The lead truncates via its cell; the value never wraps. |
Types
RowItem (items): { id, lead, value?, valueTone?, onSelect? }.
Usage
// Motivation › gift drawer: who picked this gift
<RowItems
heading="Picked by"
label="Picked by"
chevron
empty={<p className="kit-muted">Nobody picked this gift yet.</p>}
items={orders.map((o) => ({
id: o.id,
lead: <CreatorCell id={o.creatorId} name={o.name} identity={o.identity} sub="13 Nov 2026" />,
value: <StatusPill status={o.status} />, // 'pending' | 'shipped' | 'delivered'
onSelect: () => openGiftOrder(o.id),
}))}
/>// Analytics › product drawer, after DrawerHead and KeyValue
<Drawer open onClose={close} title="Eyeshadow palette" hideTitle>
<div className="kit-blk-panel">
<DrawerHead tone="sky" title="Eyeshadow palette" sub="EP-012" lead={<ProductThumb name="Eyeshadow palette" size={64} />} />
<KeyValue items={figures} />
<RowItems heading="Top creators for it" label="Top creators for it"
items={top.map((c) => ({ id: c.id, lead: <CreatorCell id={c.id} name={c.name} identity={c.identity} sub={`@${c.handle}`} />, value: `${c.sold} sold`, onSelect: () => openCreator(c.id) }))} />
</div>
</Drawer>// Commissions › order drawer: one creator row with a muted hint
<RowItems heading="Creator" label="Creator" items={[{ id: 7, lead: creatorCell, value: 'Open →', valueTone: 'muted', onSelect: openCreator }]} />Where it appears
- Brand › Motivation › gift drawer "Picked by". Screen: Motivation · Gifts.
- Brand › Analytics › product drawer "Top creators for it". Screen: Commissions and product details.
- Brand › Payments › Commissions › order drawer "Creator". Screen: Commissions and product details.
- PR Portal › gift analytics and "Needs attention" rows (with
BrandCell). Screen: PR · Gift analytics.
Guidelines
Do
- Keep lists short (3–6 rows); link to the full table for more.
- Put one value per row: a figure, a pill or a hint.
- Give the list a
labelthat matches the heading.
Don't
- Don't put buttons inside a clickable row's lead or value.
- Don't use it for sortable or paged data; use
DataTable.
RTL and Arabic
- Lead on the right, value on the left; the › chevron mirrors.
- Numbers in values keep their own direction through isolation.
Tokens
--soft, --ink, --ink-3 (muted value), --color-surface-hover, --focus-ring, --font-family-display, --tracking-display (heading).
Accessibility
<ul aria-label>; clickable rows are<button type="button">with the lead and value as the name.- Lead and value are
Isolated, so mixed-script names read in order. - The chevron is
aria-hidden; focus-visible ring on rows.
Found in the source
- ARIA attributes set:
aria-label,aria-hidden.
Read from the component's source and tests. See Accessibility for the patterns the library follows.
Related
CheckList: ticked sentences on the same soft tiles.KeyValue: label/value tiles without a lead cell.DataTable: full lists with sorting and paging.DrawerHead: the drawer head above it.
See also: MoneyNote · useLanguage · CreatorCell · Money · StatusPill · MoneyNotesProvider · CalloutCard · CopyLinkField
Source
src/blocks/shared/RowItems.tsx (line 41) on GitHub.