ApprovalActions
Reject / Approve as text buttons (the approvals table's last column and the drawer footer). fullWidth splits the width evenly between them, as the PR mock's creator drawer footer does.
import { ApprovalActions } 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
Labels
Every word this component draws, in both languages. Override one per component and language with BricksProvider labels under the key prApprovals, or with the component's own prop where it has one. A {name} is a value the component fills in.
| Key | English | Arabic |
|---|---|---|
today | Today | النهارده |
fresh | New | جديد |
first | 1st reminder sent | اتبعت أول تذكير |
second | 2nd reminder sent | اتبعت تاني تذكير |
wants | wants to join | عايز يشترك في |
approve | Approve | وافق |
reject | Reject | ارفض |
view | View | شوف |
approveOne | Approve {c} into {b} | وافق على {c} في {b} |
rejectOne | Reject {c} for {b} | ارفض {c} في {b} |
overdue | Waiting a week or more | مستني أسبوع أو أكتر |
seeAll | See all | شوف الكل |
Design guidance
How the BRICKS design system uses ApprovalActions. Written in docs/content/components/ApprovalActions.md; the props above are read from the code, which wins where the two disagree.
Reject and Approve as a pair of text buttons (outline and ink); use it in the last column of an approvals table and in the creator drawer's footer.
It is the PR mock's approve/reject pair: small in the New creators table, and fullWidth with size="md" in the creator drawer footer, where the two buttons share the width. Give each button an accessible name that says which row it acts on; the visible words stay "Reject" / "Approve".
Anatomy
- Group (
.kit-pr-acts): inline-flex, gap 8, end-aligned;kit-pr-acts--fillwithfullWidth(gap 10, each half). - Reject: default (outline) kit
Button. - Approve:
variant="ink"kitButton.
Variants
| Prop | Value | Look | Use when |
|---|---|---|---|
size | 'sm' (default) | Small buttons | Table rows. |
size | 'md' | Regular buttons | Drawer footers. |
fullWidth | true | Two equal halves | The creator drawer footer. |
States
| State | How |
|---|---|
| Default | — |
| Busy | busy: both disabled while the decision saves. |
| Hover / focus | Kit button states. |
Usage
// Approvals › New creators table: the last column
const columns: DataColumn<NewCreator>[] = [
{ key: 'creator', label: 'Creator', primary: true, render: (c) => <CreatorCell id={c.id} name={c.name} identity={c.identity} /> },
{ key: 'followers', label: 'Followers', render: (c) => <FollowersCell followers={c.followers} /> },
{ key: 'actions', label: '', align: 'end', render: (c) => (
<ApprovalActions approveLabel={`Approve ${c.name}`} rejectLabel={`Reject ${c.name}`} busy={saving === c.id}
onApprove={() => approve(c.id)} onReject={() => openReason(c.id)} />
) },
];import { ApprovalActions, Drawer } from '@ergasti/bricks';
// Creator drawer footer: the pair shares the width
export function CreatorDrawer({ onClose, approve, reject }: { onClose: () => void; approve: () => void; reject: () => void }) {
return (
<Drawer open onClose={onClose} title="Sara Ali" footerDivider
footer={<ApprovalActions size="md" fullWidth onApprove={approve} onReject={reject} />}>
<p>Rising · 48.2K followers</p>
</Drawer>
);
}Where it appears
- PR Portal › Approvals › New creators table, last column. Screen: PR · Approvals · New creators.
- PR Portal › creator drawer footer (Reject / Approve sharing the width). Screen: PR · Creator drawer.
Guidelines
Do
- Always pass
approveLabel/rejectLabelin tables, naming the row. - Keep Reject first, Approve last (the primary action at the end).
Don't
- Don't use it on PR Home's queue; that is
ApprovalRow's round icon buttons. - Don't add a third action to the pair.
RTL and Arabic
- The pair aligns to the end (left in Arabic): "ارفض" then "وافق".
Tokens
Kit Button tokens (--card, --line, --ink); .kit-pr-acts gap 8 / 10.
Accessibility
- Two real buttons; names from
approveLabel/rejectLabeloverride the visible words for screen readers, so every row is distinguishable. busyuses nativedisabled.
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
ApprovalRow: Home's queue row with round icon buttons.BulkAction/PrBulkBar: approve many at once.ReasonDialog: the reason for a rejection.
See also: Avatar · Button · BrandAvatar · PrIcon · useLanguage · Money · QueueTile · Card · QueueHeader · TaskRow · BrandLead · PrCountPill · IconSquare
Source
src/pr/Approvals.tsx (line 61) on GitHub.