Skip to content

updating aria-live=off to match the aligned implementations. #2677

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
spectranaut merged 3 commits into from
Jan 20, 2026
Merged

updating aria-live=off to match the aligned implementations. #2677

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
766b581
updating aria-live=off to match current implementations.
cookiecrook Nov 20, 2025
ea2f962
Correcting an errant instance of RFC-2119 term usage after it was cau…
cookiecrook Dec 9, 2025
da754d9
Merge branch 'main' into update-aria-live-off
pkra Dec 10, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 6 additions & 24 deletions core-aam/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2925,10 +2925,7 @@ <h4 id="role-map-marquee"><code>marquee</code></h4>
<span class="property">Role: <code>ROLE_SYSTEM_ANIMATION</code></span
><br />
<span class="property">Object Attribute: <code>xml-roles:marquee</code></span
><br />
<span class="property">Object Attribute: <code>container-live:off</code></span
><br />
<span class="property">Object Attribute: <code>live:off</code></span>
>
</td>
</tr>
<tr>
Expand All @@ -2937,18 +2934,14 @@ <h4 id="role-map-marquee"><code>marquee</code></h4>
<span class="property">Control Type: <code>Group</code></span
><br />
<span class="property">Localized Control Type: <code>marquee</code></span
><br />
<span class="property">LiveSetting: <code>Off (0)</code></span>
>
</td>
</tr>
<tr>
<th><abbr title="Accessibility Toolkit">ATK</abbr>/<abbr title="Assistive Technology - Service Provider Interface">AT-SPI</abbr></th>
<td>
<span class="property">Role: <code>ROLE_MARQUEE</code></span
><br />
<span class="property">Object Attribute: <code>container-live:off</code></span
><br />
<span class="property">Object Attribute: <code>live:off</code></span>
>
</td>
</tr>
<tr>
Expand Down Expand Up @@ -5439,12 +5432,7 @@ <h4 id="role-map-timer"><code>timer</code></h4>
<th>MSAA + IAccessible2</th>
<td>
<span class="property">Object Attribute: <code>xml-roles:timer</code></span
><br />
<span class="property">Object Attribute: <code>container-live:off</code></span
><br />
<span class="property">Object Attribute: <code>live:off</code></span
><br />
<span class="property">Object Attribute: <code>container-live-role:timer</code></span>
>
</td>
</tr>
<tr>
Expand All @@ -5453,20 +5441,14 @@ <h4 id="role-map-timer"><code>timer</code></h4>
<span class="property">Control Type: <code>Group</code></span
><br />
<span class="property">Localized Control Type: <code>timer</code></span
><br />
<span class="property">LiveSetting: <code>Off (0)</code></span>
>
</td>
</tr>
<tr>
<th><abbr title="Accessibility Toolkit">ATK</abbr>/<abbr title="Assistive Technology - Service Provider Interface">AT-SPI</abbr></th>
<td>
<span class="property">Role: <code>ROLE_TIMER</code></span
><br />
<span class="property">Object Attribute: <code>container-live:off</code></span
><br />
<span class="property">Object Attribute: <code>live:off</code></span
><br />
<span class="property">Object Attribute: <code>container-live-role:timer</code></span>
>
</td>
</tr>
<tr>
Expand Down
23 changes: 7 additions & 16 deletions index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1461,9 +1461,7 @@ <h3>Live Region Roles</h3>
<ul>
<li><rref>alert</rref></li>
<li><rref>log</rref></li>
<li><rref>marquee</rref></li>
<li><rref>status</rref></li>
<li><rref>timer</rref></li>
</ul>
</section>
<section id="window_roles">
Expand Down Expand Up @@ -5659,7 +5657,7 @@ <h2>Definition of Roles</h2>
<div class="role" id="log">
<rdef>log</rdef>
<div class="role-description">
<p>A type of <a>live region</a> where new information is added in meaningful order and old information can disappear. See related <rref>marquee</rref>.</p>
<p>A type of <a>live region</a> where new information is added in meaningful order and old information can disappear.</p>
<p>
Examples include chat logs, messaging history, game log, or an error log. In contrast to other live regions, in this <a>role</a> there is a <a>relationship</a> between the arrival of new
items in the log and the reading order. The log contains a meaningful sequence and new information is added only to the end of the log, not at arbitrary points.
Expand Down Expand Up @@ -5936,12 +5934,10 @@ <h2>Definition of Roles</h2>
<div class="role" id="marquee">
<rdef>marquee</rdef>
<div class="role-description">
<p>A type of <a>live region</a> where non-essential information changes frequently. See related <rref>log</rref>.</p>
<p>A section of content where non-essential information changes frequently.</p>
<p>
Common usages of <code>marquee</code> include stock tickers and ad banners. The primary difference between a <code>marquee</code> and a <rref>log</rref> is that logs usually have a
meaningful order or sequence of important content changes.
Common usages of <code>marquee</code> include stock tickers and ad banners.
</p>
<p>Elements with the role <code>marquee</code> have an implicit <pref>aria-live</pref> value of <code>off</code>.</p>
</div>
<table class="def">
<caption>
Expand Down Expand Up @@ -11078,12 +11074,11 @@ <h5>Presentational Role Inheritance</h5>
<div class="role" id="timer">
<rdef>timer</rdef>
<div class="role-description">
<p>A type of <a>live region</a> containing a numerical counter which indicates an amount of elapsed time from a start point, or the time remaining until an end point.</p>
<p>A section of content containing a numerical counter which indicates an amount of elapsed time from a start point, or the time remaining until an end point.</p>
<p>
The text contents of the timer <a>object</a> indicate the current time measurement, and are updated as that amount changes. The timer value is not necessarily machine parsable, but
authors SHOULD update the text contents at fixed intervals, except when the timer is paused or reaches an end-point.
</p>
<p>Elements with the role <code>timer</code> have an implicit <pref>aria-live</pref> value of <code>off</code>.</p>
</div>
<table class="def">
<caption>
Expand Down Expand Up @@ -11156,10 +11151,6 @@ <h5>Presentational Role Inheritance</h5>
<th class="role-presentational-inherited-head" scope="row">Inherits Presentational:</th>
<td class="role-presentational-inherited"> </td>
</tr>
<tr>
<th class="implicit-values-head" scope="row">Implicit Value for Role:</th>
<td class="implicit-values">Default for <pref>aria-live</pref> is <code class="default">off</code>.</td>
</tr>
</tbody>
</table>
</div>
Expand Down Expand Up @@ -12100,7 +12091,7 @@ <h3>Live Region Attributes</h3>
<p>
This section contains [=attributes=] specific to <a>live regions</a> in rich internet applications. These attributes MAY be applied to any <a>element</a>. The purpose of these attributes
is to indicate that content changes might occur without the element having focus, and to provide <a>assistive technologies</a> with information on how to process those content updates.
Some <a>roles</a> specify a default value for the <pref>aria-live</pref> attribute specific to that role. An example of a live region is a ticker section that lists updating stock quotes.
Some <a>roles</a> specify a default value for the <pref>aria-live</pref> attribute specific to that role. An example of a live region is a chat log that lists incoming chat meessages.
User agents MAY ignore changes triggered by direct user action on an <a>element</a> inside a live region (e.g., editing the value of a text field).
</p>
<ul>
Expand Down Expand Up @@ -14465,7 +14456,7 @@ <h2>Definitions of States and Properties (all aria-* attributes)</h2>
notify the user of relevant modifications to the live region, and could potentially clear the speech queue of previous updates.
</p>
<p>
Priority levels (<code>none</code>, <code>polite</code>, <code>assertive</code>) act as an ordering mechanism for updates and serve as a recommendation to user agents or assistive
Priority levels (<code>off</code>, <code>polite</code>, <code>assertive</code>) act as an ordering mechanism for updates and serve as a recommendation to user agents or assistive
technologies. The value can be overridden by user agents, assistive technologies, or the user. For example, if assistive technologies can determine that a change occurred in response to
a key press or a mouse click, the assistive technologies might present that change immediately even if the value of the <pref>aria-live</pref> attribute states otherwise.
</p>
Expand Down Expand Up @@ -14543,7 +14534,7 @@ <h2>Definitions of States and Properties (all aria-* attributes)</h2>
</tr>
<tr>
<th class="value-name" scope="row"><strong class="default">off (default)</strong></th>
<td class="value-description">Indicates that updates to the region should not be presented to the user unless the user is currently focused on that region.</td>
<td class="value-description">Indicates that updates to the region will not be presented to the user.</td>
</tr>
<tr>
<th class="value-name" scope="row">polite</th>
Expand Down