Skip to content

Update aria-busy to reflect relaxed accessibility child constraints when true #2754

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

Open
giacomo-petri wants to merge 4 commits into
base: main
Choose a base branch
from
Open

Update aria-busy to reflect relaxed accessibility child constraints when true #2754

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
1eed292
aria-busy update to clarify allowed content when true
giacomo-petri Mar 20, 2026
96fb1d3
Apply suggestions from code review
giacomo-petri Apr 9, 2026
b9dc5d5
Merge branch 'main' into giacomo-petri-aria-busy-update
daniel-montalvo May 18, 2026
ae51022
Merge branch 'main' into giacomo-petri-aria-busy-update
jnurthen Aug 7, 2026
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
12 changes: 8 additions & 4 deletions index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12661,10 +12661,14 @@ <h2>Definitions of States and Properties (all aria-* attributes)</h2>
user-initiated changes that occur inside the <rref>article</rref> that the user is reading during the busy period.
</p>
<p>
If changes to a rendered <rref>widget</rref> would create a state where the <rref>widget</rref> is modifying <a href="#mustContain">Allowed Accessibility Child Roles</a> during script
execution, authors MAY set <code>aria-busy</code> to <code>true</code> on the <rref>widget</rref> during the update process. For example, if a rendered tree grid required a set of
simultaneous updates to multiple discontiguous branches, an alternative to replacing the complete tree element with a single update would be to mark the tree busy while each of the
branches are modified.
If a script needs to change multiple <a>accessibility children</a> of a rendered <rref>widget</rref>,
authors MAY temporarily set <code>aria-busy</code> to <code>true</code> on the <rref>widget</rref> before the first change
and then set it to <code>false</code> when script execution completes.
While <code>aria-busy</code> is set to <code>true</code>,
the <rref>widget</rref> MAY temporarily contain invalid <a>accessibility children</a>.
Authors MUST ensure that <code>aria-busy</code> is set to <code>false</code> either when updates are complete or when error conditions prevent their completion.
For example, if a rendered tree grid required a set of simultaneous updates to multiple discontiguous branches, an alternative to replacing the complete tree element with a single update
would be to mark the tree busy while each of the branches are modified, and set <code>aria-busy</code> to <code>false</code> once all updates are complete.
</p>
</div>
<table class="def">
Expand Down