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

[html-aam PR 359] Change figure & figcaption accName computation #2224

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

[html-aam PR 359] Change figure & figcaption accName computation #2224

Changes from 24 commits
Commits
Show all changes
27 commits
Select commit Hold shift + click to select a range
57dea71
Change figure & figcaption accName computation
scottaohara Jan 20, 2022
c247994
Merge branch 'gh-pages' into figure-figcaption-revision
scottaohara Jan 20, 2022
2cece28
Merge branch 'gh-pages' into figure-figcaption-revision
scottaohara Feb 7, 2022
23f6eaa
resolve review comments
scottaohara Feb 7, 2022
ada36a3
Merge branch 'gh-pages' into figure-figcaption-revision
scottaohara Apr 4, 2022
ec8d7de
indicate figcaption maps to caption
scottaohara Apr 29, 2022
1a6f853
add in AX details for figure's relationship to figcaption
scottaohara Apr 29, 2022
379bca2
Merge branch 'gh-pages' into figure-figcaption-revision
scottaohara Apr 29, 2022
08499c6
Merge branch 'gh-pages' into figure-figcaption-revision
scottaohara Jun 6, 2022
a2abcc5
Merge branch 'gh-pages' into figure-figcaption-revision
scottaohara Jul 9, 2022
1cb01c6
Merge branch 'gh-pages' into figure-figcaption-revision
scottaohara Oct 14, 2022
be53256
finish up mapping detials
scottaohara May 3, 2023
9c8ad35
Merge branch 'gh-pages' into figure-figcaption-revision
scottaohara May 3, 2023
0b40395
attempt to fix build error
scottaohara May 3, 2023
991db53
Merge branch 'gh-pages' into figure-figcaption-revision
scottaohara May 3, 2023
d25c1ee
fix the broken accname/desc references
scottaohara May 3, 2023
0fe3c0b
Merge branch 'gh-pages' into figure-figcaption-revision
scottaohara May 3, 2023
ddc6a42
Merge branch 'gh-pages' into figure-figcaption-revision
scottaohara Jun 4, 2023
69aca1e
add comment regarding aria-details
scottaohara Jun 4, 2023
c8c6aa8
Merge branch 'gh-pages' into figure-figcaption-revision
scottaohara Oct 25, 2023
a50948b
update based on review suggestions
scottaohara Nov 22, 2023
2d1da27
Merge branch 'gh-pages' into figure-figcaption-revision
scottaohara Nov 22, 2023
da867eb
Merge branch 'gh-pages' into figure-figcaption-revision
scottaohara Dec 13, 2023
643fdec
editorial: move html-aam PR359
pkra May 24, 2024
f7af218
remove details relations for figure/figcaption
scottaohara Sep 27, 2024
37d9ea8
chore: prettier
scottaohara Sep 27, 2024
5bf314d
further removals
scottaohara Sep 27, 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
74 changes: 53 additions & 21 deletions html-aam/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2240,7 +2240,7 @@ <h4 id="el-figcaption">`figcaption`</h4>
</tr>
<tr>
<th>[[wai-aria-1.2]]</th>
<td><a class="core-mapping" href="#role-map-group">`caption`</a> role</td>
<td><a class="core-mapping" href="#role-map-caption">`caption`</a> role</td>
</tr>
<tr>
<th><a data-cite="core-aam-1.2/#roleMappingComputedRole">Computed Role</a></th>
Expand All @@ -2251,38 +2251,45 @@ <h4 id="el-figcaption">`figcaption`</h4>
<a href="https://msdn.microsoft.com/en-us/library/dd373608%28v=VS.85%29.aspx">MSAA</a> + <a href="http://accessibility.linuxfoundation.org/a11yspecs/ia2/docs/html/">IAccessible2</a>
</th>
<td>
<div class="role"><span class="type">Roles:</span> `ROLE_SYSTEM_TEXT`; `IA2_ROLE_CAPTION`</div>
<div class="relations"><span class="type">Relations:</span> `IA2_RELATION_LABEL_FOR` with parent <a href="#el-figure">`figure`</a> element</div>
<div class="role"><span class="type">Role:</span> Use WAI-ARIA mapping</div>
<div class="relations">
<span class="type">Relations:</span>
If the first instance of a child `figcaption` to its parent <a href="#el-figure">`figure`</a>, then `IA2_RELATION_DETAILS_FOR` with parent `figure`.
</div>
</td>
</tr>
<tr>
<th><a href="https://msdn.microsoft.com/en-us/library/ms726297%28v=VS.85%29.aspx">UIA</a></th>
<td>
<div class="ctrltype"><span class="type">Control Type:</span> `Text`</div>
<div class="ctrltype"><span class="type">Role:</span> Use WAI-ARIA mapping</div>
</td>
</tr>
<tr>
<th><a href="https://gnome.pages.gitlab.gnome.org/atk/">ATK</a></th>
<td>
<div class="role"><span class="type">Role:</span> `ATK_ROLE_CAPTION`</div>
<div class="role"><span class="type">Role:</span> Use WAI-ARIA mapping</div>
<div class="relations">
<span class="type">Relations:</span>
`ATK_RELATION_LABEL_FOR` with parent <a href="#el-figure">`figure`</a> element
If this is the first instance of a child `figcaption` to its parent <a href="#el-figure">`figure`</a> element, then expose `RELATION_DETAILS_FOR` referencing the parent `figure`
scottaohara marked this conversation as resolved.
Show resolved Hide resolved
element.
</div>
</td>
</tr>
<tr>
<th><a href="https://developer.apple.com/reference/appkit/nsaccessibility">AX</a></th>
<td>
<div class="role"><span class="type">AXRole:</span> `AXGroup`</div>
<div class="subrole"><span class="type">AXSubrole:</span> `(nil)`</div>
<div class="roledesc"><span class="type">AXRoleDescription:</span> `"group"`</div>
<div class="role"><span class="type">Role:</span> Use WAI-ARIA mapping</div>
</td>
</tr>
<!-- <th><a href="#accessible-name-and-description-computation">Naming Algorithm</a></th> -->
<tr>
<th>Comments</th>
<td></td>
<td>
<p>
Only the first child instance of a <a href="#el-figcaption">`figcaption`</a> element that is present in the accessibility tree (e.g., not 'hidden') provides details for its parent
scottaohara marked this conversation as resolved.
Show resolved Hide resolved
`figure` element.
</p>
</td>
</tr>
</tbody>
</table>
Expand All @@ -2309,15 +2316,19 @@ <h4 id="el-figure">`figure`</h4>
</th>
<td>
<div class="role"><span class="type">Role:</span> Use WAI-ARIA mapping</div>
<div class="relations"><span class="type">Relations:</span> `IA2_RELATION_LABELLED_BY` with child <a href="#el-figcaption">`figcaption`</a> element</div>
<div class="relations">
<span class="type">Relations:</span>
`IA2_RELATION_DETAILS` points to the first instance of a child `figcaption` if the element is present in the accessibility tree of the parent `figure` element.
</div>
</td>
</tr>
<tr>
<th><a href="https://msdn.microsoft.com/en-us/library/ms726297%28v=VS.85%29.aspx">UIA</a></th>
<td>
<div class="role"><span class="type">Role:</span> Use WAI-ARIA mapping</div>
<div class="general">
Accessible name derived from `figcaption` according to the <a href="#figure-element-accessible-name-computation">`figure` Element Accessible Name Computation</a>
<div class="property">
<span class="type">Property:</span>
`DescribedBy` references the first instance of a child `figcaption` element if the element is present in the accessibility tree of the parent `figure` element.
</div>
</td>
</tr>
Expand All @@ -2326,19 +2337,35 @@ <h4 id="el-figure">`figure`</h4>
<td>
<div class="role"><span class="type">Role:</span> Use WAI-ARIA mapping</div>
<div class="name"><span class="type">Name:</span> related <a href="#el-figcaption">`figcaption`</a> content</div>
<div class="relations"><span class="type">Relations:</span> `ATK_RELATION_LABELLED_BY` with child <a href="#el-figcaption">`figcaption`</a> element</div>
<div class="relations">
<span class="type">Relations:</span>
`RELATION_DETAILS` references the first instance of a child `figcaption` element if the element is present in the accessibility tree of the parent `figure` element.
scottaohara marked this conversation as resolved.
Show resolved Hide resolved
</div>
</td>
</tr>
<tr>
<th><a href="https://developer.apple.com/reference/appkit/nsaccessibility">AX</a></th>
<td>
<div class="role"><span class="type">AXRole:</span> Use WAI-ARIA mapping</div>
<div class="relations">
<span class="type">Property:</span>
`AXDetailsElements` references the first instance of a child `figcaption` element if the element is present in the accessibility tree of the parent `figure` element.
</div>
</td>
</tr>
<!-- <th><a href="#accessible-name-and-description-computation">Naming Algorithm</a></th> -->
<tr>
<th>Comments</th>
<td></td>
<td>
<p>
If an author specifies a `figure` element to acquire its accessible name or description from the first instance of a child `figcaption` element via an `aria-labelledby` or
`aria-describedby` association, then user agents SHOULD NOT expose a details relationship between the parent `figure` and child `figcaption` elements.
</p>
<p>
An explicit declaration of the `aria-details` attribute on the `figure` element will override the implicit `aria-details` association with the element's child `figcaption` element,
if one exists. If the `aria-details` attribute has an empty value, then the `figure` element has no details relation to expose.
</p>
</td>
</tr>
</tbody>
</table>
Expand Down Expand Up @@ -15975,18 +16002,23 @@ <h4>`summary` Element Accessible Name Computation</h4>
</section>
<section>
<h4>`figure` Element Accessible Name Computation</h4>
<p>
A <a href="#el-figcaption">`figcaption`</a> provides additional details related to its parent <a href="#el-figure">`figure`</a> element. A `figcaption` does not take part in the
<a data-cite="accname-1.2/#dfn-accessible-name">accessible name</a> or <a data-cite="accname-1.2/#dfn-accessible-description">accessible description</a>
computation, unless explicitly referenced by an author.
</p>
<p>
When an author uses `aria-labelledby` or `aria-describedby` to reference the first child `figcaption` element from the parent `figure` element, user agents SHOULD NOT expose the details
relationship between the `figure` and `figcaption` elements, and instead expose the `figcaption` as the element's accessible name or description, according to the following steps.
</p>
<ol>
<li>
If the `figure` 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: if the `figure` element has a
<a href="https://dom.spec.whatwg.org/#concept-tree-child">child</a> that is a `figcaption` element, then use the subtree of the first such element.
</li>
<li>If the <a data-cite="accname-1.2/#dfn-accessible-name">accessible name</a> is still empty, then: if the `figure` element has a `title` attribute, then use that attribute.</li>
<li>Otherwise, there is no <a data-cite="accname-1.2/#dfn-accessible-name">accessible name</a>.</li>
<li>Otherwise, use the `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>
</section>
<section>
Expand Down
Loading