# A11y Live Announcer

Announce the number of results when filtering a table without reloading the page.

- id: `a11y-live-announcer`
- Page: https://agentic-ui-kit.com/components/a11y-live-announcer
- Live preview: https://agentic-ui-kit.com/live/component/a11y-live-announcer

## Install

```bash
agentic-ui add a11y-live-announcer
npx shadcn@4.17.0 add @agentic-ui/a11y-live-announcer
```

## Metadata

- **Level:** block
- **Category:** block
- **Installable in:** Radix UI (registry variant new-york), Base UI (registry variant base-vega)
- **Capabilities:** aria-live-regions, polite-announcements, assertive-announcements, announcement-queue, dedupe-by-key, repeat-announcement, auto-clear, announcement-history, visible-transcript, imperative-api, declarative-on-change
- **Intents:** monitor-live, communicate, track-status
- **Suits domains:** saas, operations, analytics, ecommerce, billing, settings
- **Interaction:** imperative-announce, announce-on-change, clear-regions
- **Screen role:** communication
- **Density:** compact
- **Dark mode:** yes
- **Use it for:** announce the number of results when filtering a table without reloading the page, report that an autosave finished or failed, communicate progress and completion of an upload or a background job, interrupt with an expired-session error that requires immediate action
- **Avoid when:** static content that does not change without navigation, messages that already have their own focus, such as a modal dialog opening, high-frequency ungrouped flows, where announcing each event overwhelms the user
- **Preserve when adapting:** live-region-mounting, politeness-semantics, queue-serialisation, focus-neutrality
- **Replace when adapting:** announcement-copy, transcript-presentation, clear-timings
- **Adaptation effort:** low
- **Coupling:** low
- **Quality score:** 9.05/10
- **Quality breakdown:** visual 8/10, responsive 9/10, accessibility 10/10, code 9/10
- **Uses primitives:** badge, button, card, input, label, separator
- **Motion:** profile none, library css, reduced-motion fallback yes
- **Registry dependencies:** lib-primitives