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| Class | Component | Status | States | Accessibility | Source |
|---|---|---|---|---|---|
| .btn | Button | stable | default, 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 |
| .iconbtn | Icon button | stable | default, hover, active, focus-visible | · aria-label is mandatory (the glyph is aria-hidden). · Minimum 44px on coarse pointers. | base.css |
| .px-sw | Switch | stable | checked, 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-item | Menu item | stable | default, 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-item | Nav item | stable | default, hover, active(selected), focus-visible | · aria-current="page" on the active item. · Active rail is border-inline-start (mirrors in RTL). | base.css |
| .chip | Chip | stable | default, hover, active(selected), focus-visible | · Counts live in .n; the whole chip is the target (not just the label). | base.css |
| .index-row | Index row | stable | default, hover, active, focus-visible | · 54px minimum height; one row = one destination. | patterns.css |
| .tbl | Table | stable | default, 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 |
| .bulkbar | Bulk bar | stable | hidden, shown with selection | · role=region with aria-label; count is text, not colour. | base.css |
| .savebar | Save bar | stable | sticky, 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 |
| .msg | Flash message | stable | ok, warn, err | · role=status (or role=alert for errors) on the rendered banner. · Colour is always paired with text. | base.css |
| .toast2 | Toast | stable | ok, warn, err, auto-dismiss | · #toasts is aria-live=polite; one toast at a time. | base.css |
| .badge | Badge | stable | neutral, ok, warn, err, acc, solid | · Uppercase micro-label; never the only signal — pair with text that says the same thing. | base.css |
| .empty | Empty state | stable | default | · h4 + one-line reason + at most one action; never a bare blank area. | base.css |
| .dlg | Dialog (native) | stable | open (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 |
| .tip | Tooltip | stable | hover, focus-visible | · Decorative tips only; essential text must be in the DOM. Pair with aria-describedby for screen readers. | base.css |
| .spinner | Spinner | stable | spinning, reduced-motion (slowed) | · Indeterminate progress: keep the action label honest ('Queued…'), and slow to 1s under prefers-reduced-motion. | base.css |
| .field-err | Field error | stable | message, 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 |
| .tabs | Tabs | stable | selected, 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 |
| .crumbs | Breadcrumbs | stable | default, 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 |
| .radio | Radio | stable | checked, unchecked, focus-visible, disabled | · Native input inside the label; group with fieldset/radiogroup and a shared name. | base.css |
| .slider | Slider | stable | default, focus-visible, disabled | · aria-label on the range; the readout mirrors the value; keyboard steps come from the native input. | base.css |
| .cb | Combobox | stable | closed, 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 |
| .dp | Date picker | stable | open, 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 |
| .acc | Accordion | stable | closed, 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-sq | Avatar | stable | initials, image, ink, group | · Decorative avatars are aria-hidden; meaningful ones need alt/label. Groups carry an aria-label with the count. | base.css |
| .img | Image | stable | 16:9, 4:3, 1:1, contain, caption | · alt is mandatory (TDS014); the frame reserves space so loading never shifts layout. | base.css |
| .drop | Upload / dropzone | stable | idle, dragover, focus-visible, file-list | · role=button + Enter/Space; announces files with name and size; removal is a labelled button. | base.css |
| .notif | Notifications | stable | unread, read, empty, mark-all | · The summary's accessible name carries the unread count; unread uses background + a dot, never colour alone. | base.css |
| .cmd | Command palette | stable | closed, 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-state | Full-page state | stable | 404, 500, 403, offline, maintenance | · One h2 per page state; the code is secondary; actions are the only focusable elements. | base.css |
| .pager-num | Numbered pagination | stable | first, middle, current, gap, disabled | · aria-current marks the active page; range labels on prev/next; page-size select is labelled. | base.css |
| .tl | Timeline | stable | default, status-dots | · Ordered list; dots are decorative (the text carries the meaning). | base.css |
| .diff | Diff | stable | context, added, removed, empty | · role=table with labelled columns; +/- expressed as background tints plus repeated line numbers. | base.css |
| .sheet-end | Sheet dialog | stable | side, 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/.