Skip to Content
BBRICKSv0.7.4
PR PortalForms and dialogs

ReasonDialog

The PR mock's reason modals (reasonModal, pauseProgram, changeTier): a reason that is required before the confirm button does anything, and an optional note the other side sees. On the kit Modal (focus trap, Escape, scrim). Confirm stays enabled; pressing it without a reason marks the field invalid and says why.

import { ReasonDialog } from '@ergasti/bricks';

Examples

Ask why

A modal with a reason to pick (or free text) and an optional note; confirmLabel names the action. Use mode="text" for a free-text reason.

Code
import { useState } from 'react';
import { Button, ReasonDialog } from '@ergasti/bricks';

function Reject() {
  const [open, setOpen] = useState(false);
  const [last, setLast] = useState('');
  return (
    <>
      <Button onClick={() => setOpen(true)}>Reject Sara Ali</Button> <small>{last}</small>
      <ReasonDialog
        open={open} onClose={() => setOpen(false)} onConfirm={(result) => { setLast(`Rejected: ${result.reason}`); setOpen(false); }}
        title="Reject Sara Ali?" sub="They won’t join Glow Lab. They can request again after 2 weeks (29 Nov 2026)."
        reasons={['Not a fit for this brand', 'Audience doesn’t match', 'Already promoting a competitor', 'Other'].map((r) => ({ value: r, label: r }))} confirmLabel="Reject"
      />
    </>
  );
}

Free text, saving, failed

mode="text" asks for a required written reason (pausing a program); tone="ink" is the neutral look. While the app saves, busy locks the dialog; a failed save comes back as error, shown above the buttons. Confirm to see both.

Code
import { useState } from 'react';
import { Button, ReasonDialog } from '@ergasti/bricks';

function TextBusyError() {
  const [open, setOpen] = useState(false);
  const [busy, setBusy] = useState(false);
  const [error, setError] = useState<string | null>(null);
  return (
    <>
      <Button onClick={() => { setError(null); setOpen(true); }}>Pause Glow Lab</Button>
      <ReasonDialog
        open={open} onClose={() => setOpen(false)}
        onConfirm={() => { setBusy(true); setError(null); window.setTimeout(() => { setBusy(false); setError('Could not pause: the program has a payout in progress.'); }, 1200); }}
        title="Pause Glow Lab?" sub="Coupons stop working until you resume the program."
        mode="text" tone="ink" confirmLabel="Pause program" busy={busy} error={error}
      />
    </>
  );
}

Props

Prop

Type

Labels

Every word this component draws, in both languages. Override one per component and language with BricksProvider labels under the key prReasonDialog, or with the component's own prop where it has one. A {name} is a value the component fills in.

prReasonDialog
KeyEnglishArabic
reasonReasonالسبب
chooseChoose a reasonاختار سبب
noteNoteملاحظة
noteHint(optional, they’ll see it)(اختياري، هيشوفها)
cancelCancelإلغاء
requiredRequiredلازم
reasonErrChoose a reason.اختار سبب.
textErrWrite a reason.اكتب السبب.
otherOtherسبب تاني

Design guidance

How the BRICKS design system uses ReasonDialog. Written in docs/content/components/ReasonDialog.md; the props above are read from the code, which wins where the two disagree.

A modal that asks for a required reason before a PR decision runs (reject, pause, decline, move); use it whenever the other side must be told why.

ReasonDialog is the PR mock's reasonModal / pauseProgram / changeTier. In select mode PR picks one reason from a list and may add a note the creator or brand will see; in text mode PR types a required free-text reason. Confirm stays enabled: pressing it without a reason marks the field invalid and says why, so the rule is learned, not hidden. It sits on the kit Modal (focus trap, Escape, scrim) and resets each time it opens.

Anatomy

  1. Modal: the kit Modal (role="dialog", aria-modal), title, close ×, scrim; 20px title under the pr theme.
  2. Hint (sub): what happens next, under the title ("They can request again after 2 weeks (29 Nov 2026).").
  3. Reason field: select mode: a 42px <select> "Choose a reason" with the reasons; text mode: an <input> with placeholder "Required".
  4. Note field (select only): "Note (optional, they'll see it)", a 3-row textarea, min 84px, resizable.
  5. Footer: an error alert (with error) pushed to the start, "Cancel", and the confirm button in tone.

Variants

PropValueLookWhen to use
modeselect (default)Reason list + optional noteRejections with a fixed set of reasons (join requests, brand requests)
textOne required text inputPause a program, move a tier, any decision without a fixed list
tonerasp (default)Raspberry confirm buttonRejections, pauses, declines
inkInk confirm buttonA neutral save that still needs a reason

States

StateTrigger
Closedopen={false}
Open, freshopen becomes true: reason, note and the "tried" flag reset
InvalidConfirm pressed with an empty (or blank) reason: field shows "Choose a reason." / "Write a reason.", onConfirm not called
Busybusy: confirm disabled while the request runs
Errorerror: role="alert" line in the footer ("We couldn't reject this request. Try again.")
Focusselect, input and textarea get a raspberry border and --focus-ring

Types

Words: provider labels.prReasonDialog (reason, choose, note, noteHint, cancel, required, reasonErr, textErr, other).

ReasonResult (onConfirm): { reason, note }, both trimmed.

Usage

import { ReasonDialog } from '@ergasti/bricks';

<ReasonDialog
  open={rejecting != null}
  onClose={() => setRejecting(null)}
  onConfirm={({ reason, note }) => reject(rejecting!.id, reason, note)}
  title="Reject Sara Ali?"
  sub="They won't join Glow Lab. They can request again after 2 weeks (29 Nov 2026)."
  reasons={[
    { value: 'fit', label: 'Not a fit for this brand' },
    { value: 'audience', label: "Audience doesn't match" },
    { value: 'competitor', label: 'Already promoting a competitor' },
    { value: 'other', label: 'Other' },
  ]}
  confirmLabel="Reject"
  busy={saving}
  error={saveError}
/>
// Campaign page › Status: pausing needs a typed reason
<Button variant="rasp" onClick={() => setPausing(true)}>Pause program</Button>
<ReasonDialog
  open={pausing}
  onClose={() => setPausing(false)}
  onConfirm={({ reason }) => pauseProgram('glow-lab', reason)}
  title="Pause Glow Lab's program?"
  sub="Every creator code stops earning straight away."
  mode="text"
  confirmLabel="Pause program"
/>
// Approvals: the bulk bar's Reject opens it for all selected rows
<PrBulkBar count={sel.size} onClear={clear}>
  <BulkAction kind="danger" onClick={() => setRejecting([...sel])}>Reject</BulkAction>
  <BulkAction kind="approve" onClick={approveAll}>{`Approve ${sel.size}`}</BulkAction>
</PrBulkBar>

Free text, saving, failed. mode="text" asks for a required written reason (pausing a program); tone="ink" is the neutral look. While the app saves, busy locks the dialog; a failed save comes back as error, shown above the buttons. Confirm to see both. (docs example TextBusyError)

import { useState } from 'react';
import { Button, ReasonDialog } from '@ergasti/bricks';

export function TextBusyError() {
  const [open, setOpen] = useState(false);
  const [busy, setBusy] = useState(false);
  const [error, setError] = useState<string | null>(null);
  return (
    <>
      <Button onClick={() => { setError(null); setOpen(true); }}>Pause Glow Lab</Button>
      <ReasonDialog
        open={open} onClose={() => setOpen(false)}
        onConfirm={() => { setBusy(true); setError(null); window.setTimeout(() => { setBusy(false); setError('Could not pause: the program has a payout in progress.'); }, 1200); }}
        title="Pause Glow Lab?" sub="Coupons stop working until you resume the program."
        mode="text" tone="ink" confirmLabel="Pause program" busy={busy} error={error}
      />
    </>
  );
}

Where it appears

  • PR Portal › Approvals › reject a join request (row ✕ or bulk Reject), select.
  • PR Portal › Affiliate programs › Campaigns › a campaign's page › Pause program, text; Change requests › Decline.
  • PR Portal › Affiliate programs › Challenges › a brand request › Reject with reason.
  • Library-only (no v3 mock screen): Fraud review › decision bar (inside FraudDecisionBar).
  • Dashboard screens: PrApprovals, PrPrograms.

Guidelines

Do

  • Put the consequence in sub (when they can try again, what stops).
  • Keep reasons short and in the other side's terms; include "Other".
  • Keep the dialog open on failure and pass error; close it only on success.

Don't

  • Don't disable confirm until a reason is chosen: the component explains the rule on press.
  • Don't use it for tier changes: TierChangeDialog adds "Follow the score".
  • Don't use ink for destructive decisions.

RTL and Arabic

The modal and footer mirror; the select's chevron moves to the left ([dir='rtl'] rule). Arabic words: "السبب", "اختار سبب", "ملاحظة (اختياري، هيشوفها)", "إلغاء", errors "اختار سبب." / "اكتب السبب.". Pass Arabic reasons labels yourself.

Tokens

--line, --card, --ink, --rasp, --radius-md, --focus-ring, --kit-chevron, --dlg-title-fs (Modal).

Accessibility

  • Kit Modal: role="dialog", aria-modal="true", labelled by the title; focus is trapped, Escape and the scrim close it, focus returns to the opener; the page behind becomes inert.
  • Fields are FormFields: real labels, required, the error is tied to the field.
  • The footer error is role="alert", announced when a save fails.
  • Under the pr theme focused fields get a raspberry border plus the focus ring.

Found in the source

  • Roles in the markup: alert.
  • Its tests cover: “text mode: a required free-text reason (pause a program); Escape closes”.

Read from the component's source and tests. See Accessibility for the patterns the library follows.

See also: Button · FormField · useLanguage · BulkAction · ChangePreview · ChoiceGroup · DecisionsCard

Source

src/pr/ReasonDialog.tsx (line 54) on GitHub.

On this page