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

add aria-labelsynonyms #1794

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

add aria-labelsynonyms #1794

Changes from 5 commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
1924a1e
add aria-labelsynonyms; closes #1038
cookiecrook Sep 8, 2022
bbdca65
IDL for ariaLabelSynonyms
cookiecrook Sep 8, 2022
62e33a8
Copy/paste error in attribute name
cookiecrook Oct 8, 2022
5809de6
Addressing review comments 1) set of comma separated tokens and 2) di…
cookiecrook Jan 26, 2023
202eb03
shifting author req from ~"element must have name" to ~"element must …
cookiecrook Jan 26, 2023
a9700ed
m. review comment re: duplication
cookiecrook Jan 27, 2023
a9f47ac
m. editorial
cookiecrook Jan 27, 2023
79932ca
Cross ref WCAG SC 2.5.3 in related concepts
cookiecrook Feb 6, 2023
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
40 changes: 40 additions & 0 deletions index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12003,6 +12003,45 @@ <h2>Definitions of States and Properties (all aria-* attributes)</h2>
</tbody>
</table>
</div>
<div class="property" id="aria-labelsynonyms">
<pdef>aria-labelsynonyms</pdef>
<div class="property-description">
<p><a>Defines</a> an optional <a data-cite="HTML/common-microsyntaxes.html#comma-separated-tokens">set of comma separated tokens</a> that provides alternate activation labels for the the current element. See related <pref>aria-label</pref> and <pref>aria-labelledby</pref>.</p>
<p>The purpose of <pref>aria-labelsynonyms</pref> is to allow a user of assistive technology such as voice activation software to activate controls using any one of several possible names. Other uses may include "type-ahead" function in a keyboard access utility or search function. For example, a button that closes a dialog may be labeled "close" for a screen reader, but sighted user of voice activation may say "tap x" or "tap dismiss."</p>
cookiecrook marked this conversation as resolved.
Show resolved Hide resolved
<pre class="example highlight">
&lt;button aria-label="close" <strong>aria-labelsynonyms="dismiss, clear, close, x"</strong>&gt;❎&lt;/button&gt;
cookiecrook marked this conversation as resolved.
Show resolved Hide resolved
</pre>
<p>Authors MUST NOT specify <code>aria-labelsynonyms</code> on an element with a role that does not support <a href="#namefromauthor">nameFrom: author</a>.</p>
<p>Authors MUST NOT specify <code>aria-labelsynonyms</code> on an element that is contained in a presentational subtree as defined by the <a href="#childrenArePresentational">Presentational Children</a> characteristic.</p>
</div>
<table class="property-features">
<caption>Characteristics:</caption>
<thead>
<tr>
<th scope="col">Characteristic</th>
<th scope="col">Value</th>
</tr>
</thead>
<tbody>
<tr>
<th class="property-related-head" scope="row">Related Concepts:</th>
<td class="property-related"><a href="https://developer.apple.com/documentation/objectivec/nsobject/3197989-accessibilityuserinputlabels">accessibilityUserInputLabels</a></td>
cookiecrook marked this conversation as resolved.
Show resolved Hide resolved
</tr>
<tr>
<th class="property-applicability-head" scope="row">Used in Roles:</th>
<td class="property-applicability">All elements of the base markup except for some roles or elements that prohibit its use</td>
</tr>
<tr>
<th class="property-descendants-head" scope="row">Inherits into Roles:</th>
<td class="property-descendants">Placeholder</td>
</tr>
<tr>
<th class="property-value-head" scope="row">Value:</th>
<td class="property-value"><a href="#valuetype_string">string</a></td>
</tr>
</tbody>
</table>
</div>
<div class="property" id="aria-level">
<pdef>aria-level</pdef>
<div class="property-description">
Expand Down Expand Up @@ -13640,6 +13679,7 @@ <h2>Interface Mixin <dfn>ARIAMixin</dfn></h2>
[CEReactions] attribute DOMString? ariaKeyShortcuts;
[CEReactions] attribute DOMString? ariaLabel;
[CEReactions] attribute FrozenArray&lt;Element&gt;? ariaLabelledByElements;
[CEReactions] attribute DOMString? ariaLabelSynonyms;
[CEReactions] attribute DOMString? ariaLevel;
[CEReactions] attribute DOMString? ariaLive;
[CEReactions] attribute DOMString? ariaModal;
Expand Down