v141 · dom

ARIA Notify API

ariaNotify provides a JavaScript API that enables content authors to directly tell a screen reader what to read.

concepts

  1. ARIA Notify

    Type a message, hit the button, watch document.body.ariaNotify() fire. Priority and interrupt are wired through; bring a screen reader and you'll hear it spoken.

  2. Keyboard Confirmations

    The Edge explainer's keyboard-action scenarios: a glow shortcut on selected text and a presence-state cycle. Neither has a DOM change a live region could reliably observe — ariaNotify pushes the confirmation straight to the AT queue.

  3. Queue vs Interrupt

    Three buttons mapped to the explainer's secondary, delayed, and failed action scenarios — fired in any order, the per-call priority and interrupt options rearrange the announcement queue. A live mirror panel shows what the platform is doing.

  4. Notification Timing Lab

    Fire rapid announcements with ariaNotify vs aria-live — see how ariaNotify queues or interrupts while live regions only see the last value. Priority selector, announcement log with timestamps, and a code comparison of both patterns.

why it shipped

Currently the only mechanism available today that communicates content changes in a web app down to the accessibility layer is via ARIA live regions.

references