Skip to content
Razor catalogue

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…UseNot
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 messageWUI.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
Show code
<app-button tone="Danger">Delete</app-button>
<app-select mode="AppSelectMode.Search"></app-select>
<app-select mode="AppSelectMode.Multiple"></app-select>

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.
Actionsapp-button, app-action-icon, app-dropdown
Text & number inputapp-input, app-textarea
Choice & selectionapp-select (modes single, search, multiple, tag, country), app-checkbox, app-radio, app-radio-group, app-switch, app-choice-chip, app-choice-card
Tokensapp-chip (display, removable) and app-choice-chip (form control)
Specialized inputsapp-date-picker, app-phone-number-input, app-search, app-file-picker, app-file-attachment, app-image-picker
Feedback & statusapp-alert, app-error-summary, app-badge, app-status-badge, WUI.toast, app-skeleton, app-empty-state, app-info-tip
Overlaysapp-modal, app-confirm-dialog, app-command-palette, app-drawer
Layout & navigationapp-tabs, app-card, app-page-header, app-avatar, app-icon
Dataapp-data-table, app-table-pagination, app-table-toolbar, app-column-menu
Show code
<app-button tone="Danger">Delete</app-button>
<app-select mode="AppSelectMode.Multiple"></app-select>
WUI.toast("Saved", { variant: "success" });