aria-live attribute | ariaLive property
Sets or retrieves how assistive technology should announce updates to live regions.
![]() |
Syntax
| HTML |
|---|
<element aria-live="p" ... > |
| JavaScript |
|---|
object.setAttribute("aria-live",value);var value = object.getAttribute("aria-live");
|
Property values
Type: String
-
Default. Updates should not be announced.
-
Updates should only be announced if the user is idle.
-
Updates should be announced to the user as soon as possible.
-
Updates should be announced immediately, interrupting the user if necessary.
Standards information
- Accessible Rich Internet Applications (WAI-ARIA) 1.0, Section 6.6
Remarks
| Used in Roles |
|
|---|
The ariaLive attribute indicates the priority of updates to a live region. Announcing changes immediately can be disorienting for users. Most updates should be announced only when the user is idle.
To supress notifications until after a region has finished updating, set ariaBusy.
object.setAttribute("aria-valuenow", newValue). See also
