aria-live attribute | ariaLive property (Internet Explorer)

[This documentation is preliminary and is subject to change.]

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

Syntax

<element aria-live="p" ... >

object.setAttribute("aria-live",value);var value = object.getAttribute("aria-live");

Property values

Type: String

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

Remarks

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.

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

ariaBusy

ariaRelevant

Build date: 2/13/2012