QueueTile
Home's filter tiles (the mock's .tile): a soft tone, a white icon square, the count (Jakarta 26/800) over its label. A toggle button: active outlines it in ink and sets aria-pressed; pressing it again clears the filter.
import { QueueTile } from '@ergasti/bricks';Examples
The "needs you" queue
Join requests as rows (creator, brand, where the request came from, how long it has waited) with Approve and Reject, under a queue header with a count and "See all". Tiles above summarise each queue and filter it.
Code
import { useState } from 'react';
import { ApprovalRow, BrandLead, Card, IconSquare, PrCountPill, PrStatusPill, QueueHeader, QueueTile, TaskRow } from '@ergasti/bricks';
import { brands, joinRequests } from './pr';
function Queue() {
const [tile, setTile] = useState(0);
return (
<div style={{ display: 'grid', gap: 16 }}>
<div style={{ display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(200px, 1fr))', gap: 12 }}>
{([['rasp', 'approvals', 'Approvals waiting', 9], ['butter', 'wallet', 'Money alerts', 2], ['sky', 'star', 'Challenges to act on', 2]] as const).map(([tone, icon, label, count], i) => (
<QueueTile key={label} tone={tone} icon={icon} label={label} count={count} active={tile === i} onClick={() => setTile(tile === i ? -1 : i)} />
))}
</div>
<Card>
<QueueHeader title="Join requests" count={5} onSeeAll={() => {}} />
<ul className="kit-pr-queue">
{joinRequests.slice(0, 3).map((j) => <ApprovalRow key={j.id} creator={j.creator} brand={j.brand} source={j.source === 'public_challenge' ? 'Public challenge' : 'Creator request'} days={j.days} onApprove={() => {}} onReject={() => {}} onOpen={() => {}} />)}
</ul>
<QueueHeader title="To review" count={2} />
<ul className="kit-pr-queue">
<TaskRow lead={<BrandLead brand={brands.kemet} />} title="Kemet Home is below zero" meta="− EGP 8,400 · day 4 of 7" tag={<PrCountPill status="pauses_in" count={3} />} onOpen={() => {}} />
<TaskRow lead={<IconSquare name="star" tone="sky" />} title="Nile Threads requested a challenge" meta="Sell 30 in December · EGP 15,000" tag={<PrStatusPill status="new_request" />} onOpen={() => {}} />
<TaskRow lead={<IconSquare name="user" tone="lime" />} title="5 new creators to vet" meta="Pending until you approve them" tag={<PrCountPill status="waiting_count" count={5} />} onOpen={() => {}} />
</ul>
</Card>
</div>
);
}Actions and waiting time
ApprovalActions is the Approve / Reject pair on its own (busy disables it while a request runs); WaitingCell shows how long something has waited and turns urgent after the reminder thresholds.
Code
import { ApprovalActions, WaitingCell } from '@ergasti/bricks';
function Parts() {
return (
<div style={{ display: 'grid', gap: 14 }}>
<ApprovalActions onApprove={() => {}} onReject={() => {}} />
<ApprovalActions onApprove={() => {}} onReject={() => {}} busy size="sm" />
<div style={{ display: 'flex', gap: 24 }}>
<WaitingCell days={1} variant="cell" />
<WaitingCell days={3} variant="cell" />
<WaitingCell days={9} variant="cell" />
</div>
</div>
);
}Task rows: no lead, or an action
lead is optional (the title starts the row). action puts a control of the row's own where the chevron was (the Tiers screen's "Recent automatic moves" with "Change"); the row is then not one button, and with onOpen too the title becomes the open button, so no button sits inside another.
Code
import { Avatar, Button, Card, PrStatusPill, TaskRow } from '@ergasti/bricks';
function TaskRows() {
return (
<Card>
<ul className="kit-pr-queue">
<TaskRow title="Double commission week" meta="Every delivered sale · ×2 commission" tag={<PrStatusPill status="trndr_wide" />} onOpen={() => {}} />
<TaskRow lead={<Avatar name="Sara Ali" seed={1} />} title="Sara Ali" meta="Rising → Established · 2 days ago" action={<Button size="sm">Change</Button>} />
<TaskRow lead={<Avatar name="Hana Rami" seed={2} />} title="Hana Rami" meta="Established → Influential · 3 days ago" onOpen={() => {}} action={<Button size="sm">Change</Button>} />
</ul>
</Card>
);
}Task rows in Arabic
The chevron mirrors and the pills read in Arabic.
Code
import { BrandLead, Card, IconSquare, PrCountPill, TaskRow } from '@ergasti/bricks';
import { brands } from './pr';
function TaskRowsArabic() {
return (
<Card>
<ul className="kit-pr-queue" dir="rtl">
<TaskRow lead={<BrandLead brand={brands.kemet} />} title="Kemet Home تحت الصفر" meta="يوم 4 من 7" tag={<PrCountPill status="pauses_in" count={3} language="ar" />} onOpen={() => {}} />
<TaskRow lead={<IconSquare name="user" tone="lime" />} title="5 صنّاع محتوى جداد محتاجين مراجعة" meta="مستنيين موافقتك" tag={<PrCountPill status="waiting_count" count={5} language="ar" />} onOpen={() => {}} />
</ul>
</Card>
);
}Busy rows and named actions
While a request for a row runs, pass busy: the row dims, says it is busy to screen readers and its Approve / Reject are disabled. ApprovalActions shows short "Approve" / "Reject" text; approveLabel / rejectLabel give each button an accessible name that says which row it acts on (a table of many rows).
Code
import { ApprovalActions, ApprovalRow, Card } from '@ergasti/bricks';
import { joinRequests } from './pr';
function BusyAndNamed() {
const [j] = joinRequests;
return (
<div style={{ display: 'grid', gap: 14 }}>
<Card>
<ul className="kit-pr-queue">
<ApprovalRow creator={j.creator} brand={j.brand} source="Creator request" days={j.days} onApprove={() => {}} onReject={() => {}} onOpen={() => {}} busy />
</ul>
</Card>
<ApprovalActions onApprove={() => {}} onReject={() => {}} approveLabel={`Approve ${j.creator.name} into ${j.brand.name}`} rejectLabel={`Reject ${j.creator.name} from ${j.brand.name}`} size="md" />
</div>
);
}Full-width actions
In a drawer footer the pair should fill the width: fullWidth gives Reject and Approve equal halves, 10px apart (the PR mock's creator drawer). The default sizes the buttons to their words and keeps them at the end, for a table cell or a row. Default on top, fullWidth below, both in a 380px drawer-wide box.
Code
import { ApprovalActions } from '@ergasti/bricks';
import { joinRequests } from './pr';
function FullWidth() {
const [j] = joinRequests;
return (
<div style={{ display: 'grid', gap: 14, maxWidth: 380 }}>
<ApprovalActions onApprove={() => {}} onReject={() => {}} size="md" />
<ApprovalActions onApprove={() => {}} onReject={() => {}} size="md" fullWidth approveLabel={`Approve ${j.creator.name} into ${j.brand.name}`} rejectLabel={`Reject ${j.creator.name} from ${j.brand.name}`} />
</div>
);
}Full-width actions in Arabic
"ارفض" and "وافق" share the drawer footer; the order mirrors.
Code
import { ApprovalActions } from '@ergasti/bricks';
function FullWidthArabic() {
return (
<div style={{ maxWidth: 380 }}>
<ApprovalActions onApprove={() => {}} onReject={() => {}} size="md" fullWidth approveLabel="وافق على سارة علي في Glow Lab" rejectLabel="ارفض سارة علي في Glow Lab" />
</div>
);
}Section headers
QueueHeader puts a count after the title when you pass count; leave it out for a section that has no count. seeAllLabel renames "See all" for a link that goes somewhere specific (the brand page's "Stock requests →").
Code
import { Card, QueueHeader } from '@ergasti/bricks';
function Headers() {
return (
<Card>
<QueueHeader title="Join requests" count={5} onSeeAll={() => {}} />
<QueueHeader title="Gift stock" onSeeAll={() => {}} seeAllLabel="Stock requests →" />
<QueueHeader title="Recent activity" />
</Card>
);
}A tag on the age
ageTag puts a node after the waiting age's reminder line, in the row and in the table's WaitingCell: the PR mock's open-decision tag ("S1": when a reminder goes out) sits there.
Code
import { ApprovalRow, Card, DecisionTag, WaitingCell } from '@ergasti/bricks';
import { joinRequests } from './pr';
function AgeTag() {
const [j, k] = joinRequests;
return (
<Card>
<ul className="kit-pr-queue">
<ApprovalRow creator={j.creator} brand={j.brand} source="Creator request" days={j.days} onApprove={() => {}} onReject={() => {}} ageTag={<DecisionTag id="S1" variant="open" />} />
<ApprovalRow creator={k.creator} brand={k.brand} source="Creator request" days={k.days} onApprove={() => {}} onReject={() => {}} ageTag={<DecisionTag id="S1" variant="open" />} />
</ul>
<WaitingCell days={3} variant="cell" ageTag={<DecisionTag id="S1" variant="open" />} />
</Card>
);
}Props
Prop
Type
Design guidance
How the BRICKS design system uses QueueTile. Written in docs/content/components/QueueTile.md; the props above are read from the code, which wins where the two disagree.
A filter tile for a PR Home queue: a soft-toned card with a white icon square, a big count and its label; press it to filter the queue below, press again to clear.
It is the PR mock's .tile row on Home: "Approvals waiting 9" (rasp), "Money alerts 2" (butter), "Challenges to act on 2" (sky). It is a toggle button: active outlines it in ink and sets aria-pressed.
Anatomy
- Button (
.kit-pr-tile): flex, gap 14, 18px × 20px padding, radius--r-lg, 2px transparent border, tone fill; lifts 2px on hover. - Icon square (
.kit-pr-tile-ic): 44px, radius 14, a translucent white fill,PrIcon. - Count (display face 26px 800, LTR) over the label (13px 600).
Variants
tone | Fill / ink | Use when |
|---|---|---|
'rasp' | --rasp-50 / --rasp-ink | Approvals waiting. |
'butter' | --butter / --butter-ink | Money alerts. |
'sky' | --sky / --sky-ink | Challenges to act on. |
'lime' | --lime-50 / --olive | Positive queues. |
'lilac' | --lilac / --lilac-ink | Messages. |
'mute' | --soft / --ink-2 | Neutral. |
States
| State | How |
|---|---|
| Default | — |
| Active | active: 2px ink border, aria-pressed="true". |
| Zero | count={0}: still shown (story Zero). |
| Hover / focus | Lift / focus ring. |
Usage
const [tile, setTile] = useState<number>(-1);
<div className="scr-grid scr-grid--3">
{([['rasp', 'approvals', 'Approvals waiting', 9], ['butter', 'wallet', 'Money alerts', 2], ['sky', 'star', 'Challenges to act on', 2]] as const).map(([tone, icon, label, count], i) => (
<QueueTile key={label} tone={tone} icon={icon} label={label} count={count} active={tile === i} onClick={() => setTile(tile === i ? -1 : i)} />
))}
</div>Where it appears
- PR Portal › Home › the three tiles above "Needs you". Screen: PR · Home.
Guidelines
Do
- Keep three tiles in a row; one tone per queue.
- Filter the queue below on press and say it in the queue header.
Don't
- Don't use it to navigate to another page; use a KPI
Tileor a link.
RTL and Arabic
- Icon on the right; count stays LTR. Arabic labels: "موافقات مستنية", "تنبيهات فلوس", "تحديات محتاجة قرار".
Tokens
.kit-pr-tone--* (see Variants), --r-lg, --card, --ink (active border), --focus-ring, --font-family-display.
Accessibility
- A
<button>witharia-pressed; its name is the count and label ("9 Approvals waiting"). The icon isaria-hidden.
Found in the source
- ARIA attributes set:
aria-label,aria-busy,aria-hidden,aria-pressed. - Its tests cover: “a toggle button with the count and label; Enter toggles; Arabic”.
Read from the component's source and tests. See Accessibility for the patterns the library follows.
Related
KpiCard/Tile: figures that navigate or filter in the brand dashboard.QueueHeader,ApprovalRow,TaskRow: the queue it filters.
See also: Avatar · Button · BrandAvatar · PrIcon · useLanguage · Money · Card · BrandLead · PrCountPill · IconSquare · PrStatusPill
Source
src/pr/Approvals.tsx (line 215) on GitHub.