Skip to content
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.

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

Editorial: Clarify aria-expanded guidance #1980

Open
wants to merge 8 commits into
base: main
Choose a base branch
from
Open
Changes from 2 commits
Commits
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
6 changes: 3 additions & 3 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -11610,9 +11610,9 @@ <h2>Definitions of States and Properties (all aria-* attributes)</h2>
<div class="state" id="aria-expanded">
<sdef>aria-expanded</sdef>
<div class="state-description">
<p><a>Indicates</a> whether a grouping element owned or controlled by this element is expanded or collapsed.</p>
<p>The <sref>aria-expanded</sref> attribute is applied to a focusable, interactive element that toggles visibility of content in another element. For example, it is applied to a parent <rref>treeitem</rref> to indicate whether its child branch of the tree is shown. Similarly, it can be applied to a <rref>button</rref> that controls visibility of a section of page content.</p>
<p>If a grouping container that can be expanded or collapsed is not [=ARIA/owned=] by the element that has the <sref>aria-expanded</sref> attribute, the author SHOULD identify the controlling relationship by referencing the container from the element that has <sref>aria-expanded</sref> with the <pref>aria-controls</pref> property.</p>
<p><a>Indicates</a> whether a related grouping element is expanded or collapsed.</p>
adampage marked this conversation as resolved.
Show resolved Hide resolved
<p>The <sref>aria-expanded</sref> attribute is applied to a focusable, interactive element that toggles visibility of content in a different grouping element. If the element with <sref>aria-expanded</sref> is also a <rref>treeitem</rref> in a <rref>tree</rref> or a <rref>row</rref> in a <rref>treegrid</rref>, then it SHOULD also be the <a>accessibility parent</a> of the grouping element it expands and collapses. Otherwise, the element with <sref>aria-expanded</sref> SHOULD NOT also be the <a>accessibility parent</a> of its grouping element and instead identify that relationship using <pref>aria-controls</pref>.</p>
adampage marked this conversation as resolved.
Show resolved Hide resolved
<p class="note">For example, <sref>aria-expanded</sref> is applied to a parent <rref>treeitem</rref> to indicate whether its child branch of the tree is shown. Similarly, it can be applied to a <rref>button</rref> that controls visibility of a section of page content.</p>
adampage marked this conversation as resolved.
Show resolved Hide resolved
</div>
<table class="state-features">
<caption>Characteristics:</caption>
Expand Down
Loading