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.

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

Jump to bottom

Editorial: Clarify aria-expanded guidance #1980

Open
wants to merge 8 commits into
base: main
Choose a base branch
from
Open

Editorial: Clarify aria-expanded guidance #1980

Changes from 6 commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
63fe922
Clarify aria-expanded guidance
adampage Jul 11, 2023
932fdd1
Revise clarification
adampage Jul 18, 2023
c8b956f
Update index.html
adampage Aug 23, 2023
7cdaefc
Update index.html
adampage Aug 23, 2023
aa593ed
Update index.html
adampage Aug 23, 2023
220d8b6
add example markup
adampage Aug 23, 2023
31f69cd
Update index.html
adampage Sep 7, 2023
6ddc2b9
Merge remote-tracking branch 'upstream/main' into aria-expanded-clari…
adampage Feb 25, 2024
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
21 changes: 18 additions & 3 deletions index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11610,9 +11610,24 @@ <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 element is expanded (shown) or collapsed (hidden).</p>
<p>The <sref>aria-expanded</sref> attribute is applied to a focusable, interactive element that toggles visibility of content of a different 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 content it expands and collapses. Otherwise, the element with <sref>aria-expanded</sref> SHOULD NOT be the <a>accessibility parent</a> of the content that is expanding or collapsing. Rather, identify that relationship between the interactive element and the element being controlled using <pref>aria-controls</pref>.</p>
<p>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.</p>
<pre class="example highlight">&lt;ul role="tree"&gt;
&lt;li role="treeitem" aria-expanded="false" aria-selected="false"&gt;
&lt;span&gt;Fruits&lt;/span&gt;
&lt;ul role="group" hidden&gt;
&lt;li role="treeitem" aria-selected="false"&gt;Apricot&lt;/li&gt;
&lt;li role="treeitem" aria-selected="false"&gt;Mangosteen&lt;/li&gt;
&lt;li role="treeitem" aria-selected="false"&gt;Yuzu&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;</pre>
<p>Similarly, it can be applied to a <rref>button</rref> to control the visibility of an element and its content, on the current page.</p>
adampage marked this conversation as resolved.
Show resolved Hide resolved
<pre class="example highlight">&lt;button type="button" aria-controls="mangosteen" aria-expanded="false"&gt;Mangosteen&lt;/button&gt;
&lt;div id="mangosteen" hidden&gt;
An edible fruit native to tropical lands surrounding the Indian Ocean.
&lt;/div&gt;</pre>
</div>
<table class="state-features">
<caption>Characteristics:</caption>
Expand Down
Loading