Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

aria-live attribute | ariaLive property

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

Internet Explorer 8

 

Syntax

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

 

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

Standards information

Remarks

Used in Roles
No role required.

 

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
aria-busy
aria-relevant

 

 

Show:
© 2016 Microsoft