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

Update: option element mapping table #2365

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

Update: option element mapping table #2365

Changes from 2 commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
6f21979
Update: option element mapping table
scottaohara Oct 30, 2024
a22f286
add naming steps for option
scottaohara Nov 7, 2024
2d790ae
Update html-aam/index.html
scottaohara Nov 7, 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
56 changes: 48 additions & 8 deletions html-aam/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3851,10 +3851,10 @@ <h4 id="el-input-radio">`input` <span class="el-context">(`type` attribute in th
<th>[[wai-aria-1.2]]</th>
<td>
<a class="core-mapping" href="#role-map-radio">`radio`</a> role, with the <a class="core-mapping" href="#ariaCheckedTrue">`aria-checked`</a> state set to "true" if the element's
<a data-cite="html/form-control-infrastructure.html#concept-fe-checked">checkedness</a> is true, or "false" otherwise. With
<a href="https://www.w3.org/TR/core-aam-1.1/#ariaSetsize">`aria-setsize`</a> value reflecting number of `type=radio input` elements within the
<a data-cite="html/form-control-infrastructure.html#concept-fe-checked">checkedness</a> is true, or "false" otherwise.
Expose an <a href="https://www.w3.org/TR/core-aam-1.1/#ariaSetsize">`aria-setsize`</a> value reflecting number of `type=radio input` elements within the
<a data-cite="html/input.html#radio-button-group">radio button group</a>
and <a href="https://www.w3.org/TR/core-aam-1.1/#ariaPosinset">`aria-posinset`</a> value reflecting the elements position within the
and an <a href="https://www.w3.org/TR/core-aam-1.1/#ariaPosinset">`aria-posinset`</a> value reflecting the `type=radio input` element's position within the
<a data-cite="html/input.html#radio-button-group">radio button group</a>.
</td>
</tr>
Expand Down Expand Up @@ -5413,16 +5413,20 @@ <h4 id="el-option">`option` <span class="el-context">(in a list of options or re
<th>HTML Specification</th>
<td>
<a data-cite="html">`option`</a>
<span class="el-context"
>(in a <a data-cite="html/form-elements.html#concept-select-option-list">list of options</a> or represents a suggestion in a <a data-cite="html">`datalist`</a>)</span
>
<span class="el-context">
(in a <a data-cite="html/form-elements.html#concept-select-option-list">list of options</a> or represents a suggestion in a <a data-cite="html">`datalist`</a>)
</span>
</td>
</tr>
<tr>
<th>[[wai-aria-1.2]]</th>
<td>
<a class="core-mapping" href="#role-map-option">`option`</a> role, with the <a class="core-mapping" href="#ariaSelectedTrue">`aria-selected`</a> state set to "true" if the element's
<a data-cite="html/form-elements.html#concept-option-selectedness">selectedness</a> is true, or "false" otherwise.
Expose an <a href="https://www.w3.org/TR/core-aam-1.1/#ariaSetsize">`aria-setsize`</a> value reflecting the number of `option` elements within the
<a data-cite="html/form-elements.html#concept-select-option-list">list of options</a>
and an <a href="https://www.w3.org/TR/core-aam-1.1/#ariaPosinset">`aria-posinset`</a> value reflecting the `option` element's position within the
<a data-cite="html/form-elements.html#concept-select-option-list">list of options</a>.
</td>
</tr>
<tr>
Expand Down Expand Up @@ -5458,7 +5462,10 @@ <h4 id="el-option">`option` <span class="el-context">(in a list of options or re
<!-- <th><a href="#accessible-name-and-description-computation">Naming Algorithm</a></th> -->
<tr>
<th>Comments</th>
<td></td>
<td>
To repair instance of invalid nesting of interactive or keyboard focusable content within an `option` element, user agents MAY
expose the accessibile name, role, states and properties of such an element when if it receives focus.
scottaohara marked this conversation as resolved.
Show resolved Hide resolved
</td>
</tr>
</tbody>
</table>
Expand Down Expand Up @@ -11698,6 +11705,10 @@ <h4 id="att-label">`label`</h4>
<td>
The target element of the `label` attribute has a `LabeledBy` property pointing to the element with the `label` attribute. Participates in
<a href="#accname-computation">name computation.</a>
<!--
This UIA definition doesn't seem right. May replace with:
<div class="name">Associates the <a data-cite="accname-1.2/#dfn-accessible-name">accessible name</a></div>
-->
</td>
</tr>
<tr>
Expand All @@ -11712,7 +11723,12 @@ <h4 id="att-label">`label`</h4>
</tr>
<tr>
<th>Comments</th>
<td>See Also: <a href="" class="accname">Accessible Name and Description: Computation and API Mappings 1.1</a></td>
<td>
<!--
FOR FUTURE PR https://github.com/w3c/html-aam/issues/568 :
The `label` attribute can also participate in the <a data-cite="accname-1.2/#dfn-accessible-description">accessible descriptions</a> of
an `option`, if the `option` is a child of a `datalist`. See <a href="#accdesc-computation">accessible description computation</a> for more information. -->
</td>
</tr>
</tbody>
</table>
Expand Down Expand Up @@ -16147,6 +16163,26 @@ <h4>`fieldset` Element Accessible Name Computation</h4>
<li>Otherwise, there is no <a data-cite="accname-1.2/#dfn-accessible-name">accessible name</a>.</li>
</ol>
</section>
<section>
<h4>`option` Element Accessible Name Computation</h4>
<ol>
<li>
If the `option` element has an <a data-cite="wai-aria-1.2/#aria-label">`aria-label`</a> or an <a data-cite="wai-aria-1.2/#aria-labelledby">`aria-labelledby`</a> attribute the
<a data-cite="accname-1.2/#dfn-accessible-name">accessible name</a> is to be calculated using the algorithm defined in
<a href="" class="accname">Accessible Name and Description: Computation and API Mappings</a>.
</li>
<li>
If the <a data-cite="accname-1.2/#dfn-accessible-name">accessible name</a> is still empty, then: use the value of the `option` element's `label` attribute.
</li>
<li>Otherwise if no `label` attribute is specified use the `option` element subtree.</li>
<li>Otherwise use `title` attribute.</li>
<li>If none of the above yield a usable text string there is no <a data-cite="accname-1.2/#dfn-accessible-name">accessible name</a>.</li>
</ol>
<p class="note">
An `option` element's `label` attribute will override the rendering of an `option` element's author defined descendents. Instead, the
value of the element's `label` attribute is used as the visible text label for the `option`.
</p>
</section>
<section>
<h4>`output` Element Accessible Name Computation</h4>
<ol>
Expand Down Expand Up @@ -16357,6 +16393,10 @@ <h3>Accessible Description Computation</h3>
an `input` element whose `type` attribute is the `button`, `submit` or `reset` state, and it has a `value` attribute, then use the flat string of the attribute if it was not used as
the <a data-cite="accname-1.2/#dfn-accessible-name">accessible name</a>.
</li>
<!--
FOR FUTURE PR https://github.com/w3c/html-aam/issues/568 :
add what to do for an option with a label attribute and inner text content, when used within the context of a datalist
-->
</ul>
</li>
<li>Otherwise, use the flat string of the `title` attribute if it was not used as the <a data-cite="accname-1.2/#dfn-accessible-name">accessible name</a> for the element.</li>
Expand Down
Loading