Triage design system v0.13.1-experiment
Home / Components / Component catalog

Component catalog

Every component, its required states, and its accessibility notes — enforced by the verifier.
The component contract. Every component ships a lifecycle status, a defined set of states and an accessibility note. The matrix below is normative: tools/verify.py fails CI if a required state selector disappears from core CSS, so this page cannot drift from the code.

State matrix — v0.12.1

raw data: /spec/states.json · rules: /spec
ClassComponentStatusStatesAccessibilitySource
.btnButtonstabledefault, hover, active, focus-visible, disabled, busy (guardApply)· Use a real <button> or <a>; never a clickable div.
· Icon-only buttons need aria-label.
· guardApply freezes and relabels the submit button until navigation.
base.css
.iconbtnIcon buttonstabledefault, hover, active, focus-visible· aria-label is mandatory (the glyph is aria-hidden).
· Minimum 44px on coarse pointers.
base.css
.px-swSwitchstablechecked, unchecked, disabled, focus-visible· The visible label wraps a real checkbox; hidden twin carries the off value.
· aria-label carries the verb: Enable/Disable <object>.
· Coarse pointers get a 44px hit area.
· Disabled state dims the track and blocks interaction.
base.css
.menu-itemMenu itemstabledefault, hover, danger, armed, focus-visible· Destructive items use .arm-del with data-arm-label naming the object.
· Escape and outside click disarm; details close disarms.
base.css
.nav-itemNav itemstabledefault, hover, active(selected), focus-visible· aria-current="page" on the active item.
· Active rail is border-inline-start (mirrors in RTL).
base.css
.chipChipstabledefault, hover, active(selected), focus-visible· Counts live in .n; the whole chip is the target (not just the label).base.css
.index-rowIndex rowstabledefault, hover, active, focus-visible· 54px minimum height; one row = one destination.patterns.css
.tblTablestabledefault, row hover, selected, reflowed (mcards)· th scope where the header is meaningful; row checkbox needs aria-label.
· Hover-revealed row actions must also be reachable by keyboard focus.
base.css
.bulkbarBulk barstablehidden, shown with selection· role=region with aria-label; count is text, not colour.base.css
.savebarSave barstablesticky, keyboard-lifted (JS transform)· Lifts above the mobile keyboard via keyboard-fit.js (transform), not a class toggle.
· One primary action per card.
base.css
.msgFlash messagestableok, warn, err· role=status (or role=alert for errors) on the rendered banner.
· Colour is always paired with text.
base.css
.toast2Toaststableok, warn, err, auto-dismiss· #toasts is aria-live=polite; one toast at a time.base.css
.badgeBadgestableneutral, ok, warn, err, acc, solid· Uppercase micro-label; never the only signal — pair with text that says the same thing.base.css
.emptyEmpty statestabledefault· h4 + one-line reason + at most one action; never a bare blank area.base.css
.dlgDialog (native)stableopen (showModal), backdrop, wide variant· Native <dialog> + showModal(): top layer, inert background, Escape, focus restore — do not hand-roll a focus trap.
· aria-labelledby points at the heading; autofocus the first meaningful control, not the close button.
· Backdrop click closes unless the dialog is destructive.
· Backdrop close is suppressed for [data-dlg-static] / [data-danger] dialogs.
base.css
.tipTooltipstablehover, focus-visible· Decorative tips only; essential text must be in the DOM. Pair with aria-describedby for screen readers.base.css
.spinnerSpinnerstablespinning, reduced-motion (slowed)· Indeterminate progress: keep the action label honest ('Queued…'), and slow to 1s under prefers-reduced-motion.base.css
.field-errField errorstablemessage, aria-invalid input· Focusable summary at the top + inline message per field, linked with aria-describedby; aria-invalid=true on the control (W3C ARIA21).base.css
.tabsTabsstableselected, hover, focus-visible, overflow-scroll· tablist/tab/tabpanel roles wired by components.js with roving tabindex and Arrow/Home/End.
· Panels are hidden, not unmounted; one tab is always selected.
base.css
.crumbsBreadcrumbsstabledefault, current· nav[aria-label=Breadcrumb] wraps an ordered list; plain text + separators.
· aria-current on the leaf; the last item is not a link.
base.css
.radioRadiostablechecked, unchecked, focus-visible, disabled· Native input inside the label; group with fieldset/radiogroup and a shared name.base.css
.sliderSliderstabledefault, focus-visible, disabled· aria-label on the range; the readout mirrors the value; keyboard steps come from the native input.base.css
.cbComboboxstableclosed, open, filtered, selected, multi-chips· aria-activedescendant listbox: focus stays in the input; options are filtered in place.
· Multi-select mirrors values into a hidden input and announces chips via aria-live.
base.css
.dpDate pickerstableopen, today, selected, out-of-month, disabled-day, roving-focus (one tabbable cell)· ISO value on the input; month/weekday names and full-date day labels via Intl (locale-aware).
· Roving tabindex: exactly one day cell is tabbable — the selected day in view, else today, else the first enabled day.
· Arrow keys move ±1/±7 days, Home/End to week start/end, PageUp/PageDown change month; disabled days are skipped.
· Escape from anywhere inside the popup closes it and returns focus to the input; selecting a day does the same.
· min/max disable days; today carries aria-current=date.
· Clicking the input reopens the picker after a selection (the input is already focused, so no focus event fires).
base.css
.accAccordionstableclosed, open, focus-visible· Native details/summary — keyboard and find-in-page work for free; group with the details name attribute for exclusivity.base.css
.avatar-sqAvatarstableinitials, image, ink, group· Decorative avatars are aria-hidden; meaningful ones need alt/label. Groups carry an aria-label with the count.base.css
.imgImagestable16:9, 4:3, 1:1, contain, caption· alt is mandatory (TDS014); the frame reserves space so loading never shifts layout.base.css
.dropUpload / dropzonestableidle, dragover, focus-visible, file-list· role=button + Enter/Space; announces files with name and size; removal is a labelled button.base.css
.notifNotificationsstableunread, read, empty, mark-all· The summary's accessible name carries the unread count; unread uses background + a dot, never colour alone.base.css
.cmdCommand palettestableclosed, open, filtered, active-item, empty· Native dialog; Arrow/Enter/Escape inside, cmd/ctrl+K opens; items are buttons with listbox roles.
· A click executes the clicked item (both data-href and data-cmd-action paths); Enter executes the highlighted item.
base.css
.page-stateFull-page statestable404, 500, 403, offline, maintenance· One h2 per page state; the code is secondary; actions are the only focusable elements.base.css
.pager-numNumbered paginationstablefirst, middle, current, gap, disabled· aria-current marks the active page; range labels on prev/next; page-size select is labelled.base.css
.tlTimelinestabledefault, status-dots· Ordered list; dots are decorative (the text carries the meaning).base.css
.diffDiffstablecontext, added, removed, empty· role=table with labelled columns; +/- expressed as background tints plus repeated line numbers.base.css
.sheet-endSheet dialogstableside, bottom· Same native-dialog contract as .dlg (top layer, Escape, focus restore); data-dlg-static still blocks backdrop close.base.css
Adding a component? Add it here, add its state selectors to core, add the class to core.css, and verify.py will hold the line.
Triage Design System v0.13.1-experiment — the central, app-agnostic UI design authority. Source of truth: /tokens/tokens.json. Showcase chrome only: site/.