Component
Announce dynamic status, validation, and background updates to assistive technologies without adding visual UI.
preview
Sync status
Ready to sync
- Polite and assertive announcement modes
- Visually hidden by default without removing content from the accessibility tree
- Configurable live region role and ARIA announcement metadata
- Stable data-slot and optional Theme class namespace hooks
Root component for announcing dynamic updates to assistive technologies.
| Prop | Type | Default |
|---|---|---|
politeness | 'polite' | 'assertive' | 'off' | 'polite' |
role | 'status' | 'alert' | 'log' | 'status' |
atomic | boolean | true |
relevant | 'additions' | 'removals' | 'text' | 'all' | 'additions text' | 'additions text' |
busy | boolean | -- |
visuallyHidden | boolean | true |
customRootClass | string | '' |
| Shortcut | Description |
|---|---|
Tab | The visually hidden region is not tabbable. Tab moves focus to the next tabbable element, and updating the region does not move focus to it. |
| Reference | What Rad UI follows |
|---|---|
Uses aria-live, aria-atomic, aria-relevant, and aria-busy to describe how assistive technologies should announce dynamic updates. The default role is status for polite updates and alert for assertive updates. |