On this page
A need → the component
Pick by the need, not the look: find the row that matches the job, then use the component it names.
Needs and their components
Each row names the component to use and the raw markup to avoid.
| You need… | Use | Not |
|---|---|---|
| A primary / secondary / destructive action | <app-button> (tone, variant) | a raw .btn |
| An icon-only action (edit/delete/more) | <app-action-icon> · <app-dropdown> (menu) | a bare icon button |
| A one-line text value | <app-input> (type, left-icon, unit, password) | raw <input> |
| Multi-line text | <app-textarea> | raw <textarea> |
| Pick one of 2 to 5 exclusive options, visible | <app-radio-group> · <app-choice-card> (rich) | a dropdown |
| Pick one of 6+ options | <app-select> (search box past 10 options) | a long radio list |
| Pick one from a large / remote list, type to find | <app-select mode="search"> (async source, searching text) | a giant static select |
| Pick many options | <app-select mode="multiple"> (chosen shown as chips) | many checkboxes |
| Free-text tokens (emails, tags, keywords) | <app-select mode="tag"> | a raw input with chips |
| A country (name, flag, ISO code) | <app-select mode="country"> | <app-select> with a hand-kept country list |
| A compact single-purpose picker (page size) | <app-select density="compact" size="sm"> | <app-select> at full size |
| A boolean on/off | <app-switch> | a checkbox as a toggle |
| Independent booleans | <app-checkbox> | switches |
| A selectable pill (filter toggle) | <app-choice-chip> | a styled button |
| A display / removable token (tag, chosen value) | <app-chip> (removable, tone, leading-icon/avatar) | <app-choice-chip> |
| A date | <app-date-picker> | raw <input type=date> |
| A phone number with country code | <app-phone-number-input> | input + separate select |
| A search box | <app-search> | <app-input> with a magnifier |
| File upload | <app-file-picker> · <app-file-attachment> · <app-image-picker> | raw <input type=file> |
| A transient success / error message | WUI.toast(msg, { variant }) | a lingering inline alert |
| A persistent inline message | <app-alert tone> | a toast |
| A form's errors after a failed submit | <app-error-summary> | an alert that only counts the errors |
| A small count / label badge | <app-badge> | a styled span |
| A status pill (from a status enum) | <app-status-badge tone label> | <app-badge> |
| Loading placeholder | <app-skeleton> (loop it for table rows) | a full-page spinner |
| “Nothing here yet” | <app-empty-state> (variant="table" inside a table) | a bare message |
| A light/dark switch with a page-wide effect | <app-theme-toggle> (effect, include-auto) | a hand-wired button that switches the theme |
| A help tooltip beside a label | <app-info-tip> | title="" |
| A dialog (form / details) | <app-modal> | a bespoke overlay |
| A yes/no confirmation | <app-confirm-dialog> (tone="danger" for destructive) | <app-modal> hand-wired |
| App-wide search and jump (Ctrl+K) | <app-command-palette> (Ctrl+K via shortcut-key) | <app-modal> with a hand-wired list |
| A slide-in panel / drawer / mobile nav | <app-drawer> (side panel, bottom sheet on phones) | a hand-rolled drawer |
| Tabbed content | <app-tabs> · <app-accordion> | bespoke tabs |
| A content container | <app-card> | a .card div |
| A page masthead (title + subtitle + actions) | <app-page-header> | ad-hoc header markup |
| A user avatar (image / initials) | <app-avatar> | an <img> circle |
| A data grid with sorting / pagination | <app-data-table> + <app-table-pagination> | a hand-built <table> |
| Filters, search and bulk actions above a table | <app-table-toolbar> | a hand-built filter row |
| Letting people show or hide table columns | <app-column-menu> | a hand-built checkbox list |
By category
Use this list to see which components belong to each family, so you search by group before you build.
Components grouped by family
Each family lists the components it holds.
| Actions | app-button, app-action-icon, app-dropdown |
| Text & number input | app-input, app-textarea |
| Choice & selection | app-select (modes single, search, multiple, tag, country), app-checkbox, app-radio, app-radio-group, app-switch, app-choice-chip, app-choice-card |
| Tokens | app-chip (display, removable) and app-choice-chip (form control) |
| Specialized inputs | app-date-picker, app-phone-number-input, app-search, app-file-picker, app-file-attachment, app-image-picker |
| Feedback & status | app-alert, app-error-summary, app-badge, app-status-badge, WUI.toast, app-skeleton, app-empty-state, app-info-tip |
| Overlays | app-modal, app-confirm-dialog, app-command-palette, app-drawer |
| Layout & navigation | app-tabs, app-card, app-page-header, app-avatar, app-icon |
| Data | app-data-table, app-table-pagination, app-table-toolbar, app-column-menu |