ComponentsAlert

displaytexulinot agent-emittableapp

Alert

alert

Inline feedback for a page section (status or error).

Live examples

Warning alert

Warning alert

Loading demo…

Props

Public props for Alert
NameKindRequiredDefaultDescription
toneenum (info, success, warning, error, brand, neutral)no"info"—
titlestringno—Optional heading
textstringno—Body copy
hideIconbooleannofalse—
iconslotno—Custom icon snippet
actionLabelstringno——
actionHrefstringno—Optional action link (URL policy)
onActioneventno——
dismissiblebooleannofalse—
dismissLabelstringno"Dismiss"—
onDismisseventno——
classstringno——

Keyboard

Keyboard behavior for Alert
KeyAction
—See accessibility notes for keyboard behavior.

Accessibility

  • error tone uses role=alert; other tones use role=status; dismiss is named.

Evidence for alert

Latest committed gates for alert (as of 2026-10-23). Static snapshot — not live CI.

Behavior

n/ano behavior scenario

No dedicated behavior scenario for this catalog id (a styled or display surface, covered by its unit and axe tests).

Size (gzip)

texuli/alert · budget 12.0 KiB

Budget from texuli.budgets.json; re-measure with `pnpm size --filter <entry>`.

Axe

documented

  • tests/e2e/site-component-pages.spec.ts
  • docs/quality (a11y-*)

Site component pages axe gate; package-level a11y docs under docs/quality when present.

Browsers

  • chromium
  • webkit
  • mobile

Playwright projects: Desktop Chrome, Desktop Safari, Pixel 7. Firefox is a known gap on this host.

When to use

Use when

  • Report a result or problem next to the related content

Don’t use when

Prefer another component

  • A full-page failure (use error-state)
  • A quiet tip in docs (use callout)