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.

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

[html-aam PR 481] add/revise popover related attribute mappings #2219

Merged
merged 30 commits into from
Jun 26, 2024
Merged
Changes from all commits
Commits
Show all changes
30 commits
Select commit Hold shift + click to select a range
26f9dbd
revise popover related attribute mappings
scottaohara May 9, 2023
fc888e0
Merge branch 'gh-pages' into popover-attr-mappings
scottaohara May 9, 2023
6100d85
Merge branch 'gh-pages' into popover-attr-mappings
scottaohara Jul 12, 2023
35c1eee
Merge branch 'gh-pages' into popover-attr-mappings
scottaohara Oct 4, 2023
e232c68
Update index.html
scottaohara Oct 4, 2023
1d53a26
Merge branch 'gh-pages' into popover-attr-mappings
scottaohara Oct 12, 2023
acb06cb
Merge branch 'gh-pages' into popover-attr-mappings
scottaohara Nov 7, 2023
d09a767
update ia2/atk mappings
scottaohara Nov 22, 2023
c9cd46f
Update index.html
scottaohara Nov 22, 2023
8db7da8
Update index.html
scottaohara Nov 22, 2023
efdc61a
Update index.html
scottaohara Nov 22, 2023
453ce81
Update index.html
scottaohara Dec 13, 2023
3510269
Update index.html
scottaohara Dec 13, 2023
761376a
move details-roles:popover to correct attr table
scottaohara Dec 13, 2023
4498283
Update index.html
scottaohara Jan 9, 2024
72c7a2a
Merge branch 'gh-pages' into popover-attr-mappings
scottaohara Feb 28, 2024
2899f70
Update index.html
scottaohara Feb 28, 2024
d86fceb
Update index.html
scottaohara May 8, 2024
023b13f
Update index.html
scottaohara May 8, 2024
2b479ec
Update index.html
scottaohara May 8, 2024
f5e7f6c
Update index.html
scottaohara May 8, 2024
3797b92
Update index.html
scottaohara May 8, 2024
856408c
Merge branch 'gh-pages' into popover-attr-mappings
scottaohara May 8, 2024
f5f8211
Update index.html
scottaohara May 8, 2024
8329f82
Update index.html
scottaohara May 8, 2024
39e78dc
Update index.html
scottaohara May 10, 2024
314c99c
editorial: move html-aam PR481
pkra May 24, 2024
4408b5c
Update html-aam/index.html
scottaohara Jun 26, 2024
23ab0d9
Update html-aam/index.html
scottaohara Jun 26, 2024
8c1524a
add to changelog
scottaohara Jun 26, 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
200 changes: 200 additions & 0 deletions html-aam/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -13283,6 +13283,205 @@ <h4 id="att-playsinline">`playsinline`</h4>
</tr>
</tbody>
</table>
<h4 id="att-popover">`popover`</h4>
<table aria-labelledby="att-popover">
<tbody>
<tr>
<th>HTML Specification</th>
<td>`popover`</td>
</tr>
<tr>
<th>Element(s)</th>
<td>
<a data-cite="html/popover.html#attr-popover">HTML elements</a>
</td>
</tr>
<tr>
<th>[[WAI-ARIA-1.2]]</th>
<td>
<div class="general">Not mapped</div>
</td>
</tr>
<tr>
<th>
<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>
<span class="type">Relations:</span> `IA2_RELATION_DETAILS_FOR` points to invoking element. <a href="#att-popover-comments">See Comments</a>.
<div class="objattrs">
<span class="type">Object attributes:</span>
<code>ispopup: &lt;value></code> where <code>&lt;value></code> reflects the <a data-cite="html/popover.html#the-popover-attribute">popover</a> type.
</div>
</td>
</tr>
<tr>
<th><a href="https://msdn.microsoft.com/en-us/library/ms726297%28v=VS.85%29.aspx">UIA</a></th>
<td>
A details relation is made with the invoking element, if an invoking element exists which meets the conditions for necessitating a details relationship.
<a href="#att-popover-comments">See Comments</a>.
</td>
</tr>
<tr>
<th><a href="https://gnome.pages.gitlab.gnome.org/atk/">ATK</a></th>
<td>
<p><span class="type">Relations:</span> `RELATION_DETAILS_FOR` points to invoking element. <a href="#att-popover-comments">See Comments</a>.</p>
<div class="objattrs">
<span class="type">Object attributes:</span>
<code>ispopup: &lt;value></code> where <code>&lt;value></code> reflects the <a data-cite="html/popover.html#the-popover-attribute">popover</a> type.
</div>
</td>
</tr>
<tr>
<th><a href="https://developer.apple.com/reference/appkit/nsaccessibility">AX</a></th>
<td>
Not mapped
<!-- https://bugs.webkit.org/show_bug.cgi?id=271485 -->
</td>
</tr>
<tr>
<th>Comments</th>
<td>
<p>User agents MUST NOT expose a details relation between a `popover` and its invoking element under the following conditions:</p>
<ul>
<li>when the `popover` is the next immediate accessibility sibling to the invoking element,</li>
<li>when the element has a `popovertarget=hide` attribute value,</li>
<li>or when the element is a descendant of the `popover` and its `popovertarget` is the "`auto`" state.</li>
</ul>
<p>If specified on an element with an implicit role of `generic`, then the element's role instead maps to <a class="core-mapping" href="#role-map-group">`group`</a>.</p>
</td>
</tr>
</tbody>
</table>
<h4 id="att-popovertarget">`popovertarget`</h4>
<table aria-labelledby="att-popovertarget">
<tbody>
<tr>
<th>HTML Specification</th>
<td>`popovertarget`</td>
</tr>
<tr>
<th>Element(s)</th>
<td>
<a data-cite="html/popover.html#attr-popovertarget">`button`</a>;
<a data-cite="html/popover.html#attr-popovertarget">`input type=button, image, reset, submit`</a>
</td>
</tr>
<tr>
<th>[[WAI-ARIA-1.2]]</th>
<td>
<div class="general">
<p>
If the associated element is displayed as a popover:
<a class="core-mapping" href="#ariaExpandedTrue">`aria-expanded=true`</a>
</p>
<p>
If the associated element is hidden, or not present in the DOM:
<a class="core-mapping" href="#ariaExpandedFalse">`aria-expanded=false`</a>
</p>
<p>
If the associated element is an accessibility ancestor of the element with the `popovertarget` attribute:
<a class="core-mapping" href="#ariaExpandedUndefined">`aria-expanded=undefined`</a>
</p>
</div>
</td>
</tr>
<tr>
<th>
<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="general">Use WAI-ARIA mapping</div>
<div class="general"><span class="type">Object attributes:</span> `details-roles:popover`</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="general">Use WAI-ARIA mapping</div>
</td>
</tr>
<tr>
<th><a href="https://gnome.pages.gitlab.gnome.org/atk/">ATK</a></th>
<td>
<div class="general">Use WAI-ARIA mapping</div>
<div class="general"><span class="type">Object attributes:</span> `details-roles:popover`</div>
</td>
</tr>
<tr>
<th><a href="https://developer.apple.com/reference/appkit/nsaccessibility">AX</a></th>
<td>
<div class="general">Use WAI-ARIA mapping</div>
</td>
</tr>
<tr>
<th>Comments</th>
<td>
<p>
User Agents MUST expose an <a class="core-mapping" href="#ariaDetails">`aria-details`</a> relation with the associated popover element <strong>except</strong> under the following
conditions:
</p>
<ul>
<li>The element's `popovertargetaction` attribute value is "`hide`"</li>
<li>The associated popover element is the next immediate accessibility sibling to the invoking element,</li>
<li>The element's `popovertargetaction` attribute is the "`auto`" state and the element is a descendant of the `popover` it is associated with.</li>
<!-- accessibility sibling will be defined in the ARIA specification -->
</ul>
</td>
</tr>
</tbody>
</table>
<h4 id="att-popovertargetaction">`popovertargetaction`</h4>
<table aria-labelledby="att-popovertargetaction">
<tbody>
<tr>
<th>HTML Specification</th>
<td>`popovertargetaction`</td>
</tr>
<tr>
<th>Element(s)</th>
<td>
<a data-cite="html/popover.html#attr-popovertargetaction">`button`</a>;
<a data-cite="html/popover.html#attr-popovertargetaction">`input type=button, image, reset, submit`</a>
</td>
</tr>
<tr>
<th>[[WAI-ARIA-1.2]]</th>
<td>
<div class="general">Not mapped</div>
</td>
</tr>
<tr>
<th>
<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="general">Not mapped</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="general">Not mapped</div>
</td>
</tr>
<tr>
<th><a href="https://gnome.pages.gitlab.gnome.org/atk/">ATK</a></th>
<td>
<div class="general">Not mapped</div>
</td>
</tr>
<tr>
<th><a href="https://developer.apple.com/reference/appkit/nsaccessibility">AX</a></th>
<td>
<div class="general">Not mapped</div>
</td>
</tr>
<tr>
<th>Comments</th>
<td>The value of this attribute can impact the mappings of its related <a href="#att-popovertarget">`popovertarget`</a> attribute.</td>
</tr>
</tbody>
</table>
<h4 id="att-poster">`poster`</h4>
<table aria-labelledby="att-poster">
<tbody>
Expand Down Expand Up @@ -16284,6 +16483,7 @@ <h3>Change Log</h3>
<section>
<h4>Substantive changes since moving to the <a href="https://www.w3.org/WAI/ARIA/">Accessible Rich Internet Applications Working Group</a> (03-Nov-2019)</h4>
<ul>
<li>06-June-2024: Add `popover`, `popovertarget` and `popovertargetaction` mappings. See <a href="https://github.com/w3c/html-aam/pull/481">GitHub PR 481</a>.</li>
<li>09-Oct-2023: Acknowledge use of `hr` element within `select` element. See <a href="https://github.com/w3c/html-aam/pull/504">GitHub PR 504</a>.</li>
<li>03-Oct-2023: Update image mappings to reference the primary synonym roles (`image` and `none`). See <a href="https://github.com/w3c/html-aam/pull/498">GitHub PR 498</a>.</li>
<li>03-Oct-2023: Clarify when to expose required field as invalid. See <a href="https://github.com/w3c/html-aam/pull/429">GitHub PR 429</a>.</li>
Expand Down
Loading