Share via

ariaLive property

  • Article

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

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).

 

See also

Accessible Rich Internet Applications (ARIA)

Reference

IHTMLElement5::ariaBusy

IHTMLElement5::ariaRelevant