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

Update "undefined" definition in section 6.2.4 Value (within 6.2 Characteristics of States and Properties) #2172

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

Update "undefined" definition in section 6.2.4 Value (within 6.2 Characteristics of States and Properties) #2172

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
48bf370
Update glossary definition of 'undefined' value
Apr 28, 2024
5bce014
Update undefined definition, add assignment examples
Jul 15, 2024
66c640c
Merge branch 'main' into rahim/update-undefined-definition
Jul 15, 2024
4e2775b
Fix string value 'undefined' references, use HTML double quote charac…
Jul 15, 2024
839c476
Remove extraneous 's'
Jul 15, 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
6 changes: 3 additions & 3 deletions index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10010,7 +10010,7 @@ <h3>Value</h3>
<dt id="valuetype_tristate">tristate</dt>
<dd>Value representing <code>true</code>, <code>false</code>, <code>mixed</code>, or <code>undefined</code> values. The default value for this value type is <code>undefined</code> unless otherwise specified.</dd>
<dt id="valuetype_true-false-undefined">true/false/undefined</dt>
<dd>Value representing <code>true</code>, <code>false</code>, or <code>undefined</code> (not applicable). The default value for this value type is <code>undefined</code> unless otherwise specified. For example, an element with <sref>aria-expanded</sref> set to <code>false</code> is not currently expanded; an element with <sref>aria-expanded</sref> set to <code>undefined</code> is not expandable.</dd>
<dd>Value representing <code>true</code>, <code>false</code>, or <code>undefined</code>. Unless otherwise specified, the default value for this value type is <code>undefined</code>. The value <code>undefined</code> (not the string &quot;undefined&quot;) usually represents the absence of a state or property in HTML (e.g., <sref>aria-expanded</sref> is not present on an element), or explicit assignment of an IDL attribute via JavaScript (e.g., <code>el.ariaExpanded=undefined</code>). Note that the value <code>undefined</code> conveys a state- or property-dependent behavior; for example, an element with <sref>aria-expanded</sref> set to <code>undefined</code> is not expandable. Where <code>undefined</code> is a supported value, consult the values table of the relevant state or property to understand its meaning.
<dt id="valuetype_idref">ID reference</dt>
<dd>Reference to the ID of another <a>element</a> in the same document</dd>
<dt id="valuetype_idref_list">ID reference list</dt>
Expand Down Expand Up @@ -11604,7 +11604,7 @@ <h2>Definitions of States and Properties (all aria-* attributes)</h2>
<p>User agents determine an element's [=element/hidden=] status based on whether it is rendered, and the rendering is usually controlled by CSS. For example, an element whose <code>display</code> property is set to <code>none</code> is not rendered. An element is considered [=element/hidden=] if it, or any of its ancestors are not rendered or have their <code>aria-hidden</code> attribute value set to <code>true</code>.</p>
<p>Authors MAY, with caution, use aria-hidden to hide visibly rendered content from assistive technologies <em>only</em> if the act of hiding this content is intended to improve the experience for users of assistive technologies by removing redundant or extraneous content. Authors using aria-hidden to hide visible content MUST ensure that identical or equivalent meaning and functionality is exposed to assistive technologies.</p>
<p class="note">Authors are advised to use extreme caution and consider a wide range of disabilities when hiding visibly rendered content from assistive technologies. For example, a sighted, dexterity-impaired individual might use voice-controlled assistive technologies to access a visual interface. If an author hides visible link text "Go to checkout" and exposes similar, yet non-identical link text "Check out now" to the accessibility API, the user might be unable to access the interface they perceive using voice control. Similar problems can also arise for screen reader users. For example, a sighted telephone support technician might attempt to have the blind screen reader user click the "Go to checkout" link, which they might be unable to find using a type-ahead item search ("Go to…").</p>
<p class="note">As of ARIA 1.3, <code><sref>aria-hidden</sref>="false"</code> is now synonymous with <code>aria-hidden="undefined"</code>.</p>
<p class="note">As of ARIA 1.3, <code><sref>aria-hidden</sref>="false"</code> is now synonymous with <code>aria-hidden=undefined</code>.</p>
<p class="note">The original intent for <code>aria-hidden="false"</code> was to allow user agents to expose content that was otherwise hidden from the accessibility tree. However, due to ambiguity in the specification and inconsistent browser support for the <code>false</code> value, the original intent is no longer supported.</p>
</div>
<table class="state-features">
Expand Down Expand Up @@ -13419,7 +13419,7 @@ <h3>States and Properties</h3>
<li>When exposing as a platform accessibility API attribute, expose the unknown value &#8212; do not vet it against possible values. </li>
<li>When exposing as a platform <abbr title="application programming interface">API</abbr> Boolean state:
<ul>
<li>For values of &quot;&quot; (empty string), &quot;undefined&quot; or no [=attribute=] present:
<li>For values of &quot;&quot; (empty string), <code>undefined</code> or no [=attribute=] present:
<ul>
<li>Follow the guidance in the <a href="#authorErrorDefaultValuesTable">Fallback values for missing required attributes</a> table below, if applicable. </li>
<li>Otherwise, treat as false. </li>
Expand Down
Loading