This topic has not yet been rated - Rate this topic

ariaLive property

Sets or retrieves how assistive technology should announce updates to live regions.

Syntax

object.setAttribute("ariaLive",value);var value = object.getAttribute("ariaLive");

Property values

Type: BSTR

(off): Default. Updates should not be announced.
(polite): Updates should only be announced if the user is idle.
(assertive): Updates should be announced to the user as soon as possible.
(rude): 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	No role required.

The IHTMLElement5::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 IHTMLElement5::ariaBusy.

Note For cross-browser compatibility, always use the WAI-ARIA attribute syntax to access and modify ARIA properties; for example, object.setAttribute("aria-valuenow", newValue).

Community Additions