ComponentsBanner

displaytexulinot agent-emittableapp

Banner

banner

Full-width notice across a page or app shell.

Live examples

Brand banner

Brand banner

Loading demo…

Props

Public props for Banner
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 Banner
KeyAction
—See accessibility notes for keyboard behavior.

Accessibility

  • Same tone roles as Alert; dismiss control is optional and named.

Evidence for banner

Latest committed gates for banner (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/banner · 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

  • Announce a global condition (maintenance, trial)

Don’t use when

Prefer another component

  • Inline field errors (use alert near the field)