Skip to content

Commit bac5f87

Browse files
committed
Add interestfor attribute related mappings
This adds the mapping for the `interestfor` attribute. See [the explainer](https://open-ui.org/components/interest-invokers.explainer/) for the overall API description and use cases.
1 parent db9cdbb commit bac5f87

File tree

1 file changed

+86
-4
lines changed

1 file changed

+86
-4
lines changed

html-aam/index.html

Lines changed: 86 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -11625,6 +11625,87 @@ <h4 id="att-indeterminate">`indeterminate [IDL]`</h4>
1162511625
</tr>
1162611626
</tbody>
1162711627
</table>
11628+
<h4 id="att-interestfor-attribute">`interestfor`</h4>
11629+
<table class="data" aria-labelledby="att-interestfor-attribute">
11630+
<tbody>
11631+
<tr>
11632+
<th>HTML Specification</th>
11633+
<td>
11634+
<span class="el-context"> `interestfor` </span>
11635+
</td>
11636+
</tr>
11637+
<tr>
11638+
<th>Element(s)</th>
11639+
<td>
11640+
<a data-cite="html/form-elements.html#the-button-element">`button`</a>;
11641+
<a data-cite="html/text-level-semantics.html#the-a-element">`a`</a>;
11642+
<a data-cite="html/image-maps.html#the-area-element">`area`</a>
11643+
</td>
11644+
</tr>
11645+
<tr>
11646+
<th>[[WAI-ARIA-1.2]]</th>
11647+
<td>
11648+
<p>A popover is <dfn>"plain"</dfn> if it contains only elements with a computed role of generic, text and images.</p>
11649+
<p>A popover is <dfn>"rich"</dfn> if it is not "plain".</p>
11650+
<p>If the `interestfor`-associated element is invalid, or is not a not a popover: no `aria-expanded` mapping</p>
11651+
<p>
11652+
If the `interestfor`-associated element is an accessibility ancestor of the interest invoker:
11653+
<a class="core-mapping" href="#ariaExpandedUndefined">`aria-expanded=undefined`</a>
11654+
</p>
11655+
<p>If the `interestfor`-associated element is a <a>"plain"</a> popover:
11656+
<ul>
11657+
<li><p>Set <a class="core-mapping" href="#ariaHiddenTrue">`aria-hidden="true"`</a> on the target popover.</p></li>
11658+
<li><p>If no other <a data-cite="accname-1.2/#dfn-accessible-name">accessible name</a> is available, use the popover's inner text for
11659+
the <a data-cite="accname-1.2/#dfn-accessible-name">accessible name</a>.</p></li>
11660+
<li><p>If the popover is not used as the <a data-cite="accname-1.2/#dfn-accessible-name">name</a>, then use it to compute the
11661+
<a data-cite="accname-1.2/#dfn-accessible-description">accessible description</a>, setting the
11662+
<a data-cite="wai-aria-1.2/#aria-describedby">`aria-describedby`</a> relation to point from the interest invoker to the popover</p></li>
11663+
</ul>
11664+
</p>
11665+
<p>If the `interestfor`-associated element is a <a>"rich"</a> popover:
11666+
<ul>
11667+
<li><p>If the popover is displayed: <a class="core-mapping" href="#ariaExpandedTrue">`aria-expanded=true`</a></p></li>
11668+
<li><p>If the popover is hidden: <a class="core-mapping" href="#ariaExpandedFalse">`aria-expanded=false`</a></p></li>
11669+
<li><p>Set a <a>minimum role</a> of <a class="core-mapping" href="#role-map-tooltip">`tooltip`</a> on the target popover</p></li>
11670+
<li><p>Set `aria-details` pointing to the target popover</p></li>
11671+
</ul>
11672+
</td>
11673+
</tr>
11674+
<tr>
11675+
<th>
11676+
<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>
11677+
</th>
11678+
<td>
11679+
<div class="general">Use WAI-ARIA mapping</div>
11680+
<div class="objattrs"><span class="type">Object attributes:</span> `details-roles:popover`</div>
11681+
</td>
11682+
</tr>
11683+
<tr>
11684+
<th><a href="https://msdn.microsoft.com/en-us/library/ms726297%28v=VS.85%29.aspx">UIA</a></th>
11685+
<td>
11686+
<div class="general">Use WAI-ARIA mapping</div>
11687+
</td>
11688+
</tr>
11689+
<tr>
11690+
<th><a href="https://gnome.pages.gitlab.gnome.org/atk/">ATK</a></th>
11691+
<td>
11692+
<div class="general">Use WAI-ARIA mapping</div>
11693+
<div class="objattrs"><span class="type">Object attributes:</span> `details-roles:popover`</div>
11694+
</td>
11695+
</tr>
11696+
<tr>
11697+
<th><a href="https://developer.apple.com/reference/appkit/nsaccessibility">AX</a></th>
11698+
<td>
11699+
<div class="general">Use WAI-ARIA mapping</div>
11700+
</td>
11701+
</tr>
11702+
<tr>
11703+
<th>Comments</th>
11704+
<td>
11705+
</td>
11706+
</tr>
11707+
</tbody>
11708+
</table>
1162811709
<h4 id="att-ismap">`ismap`</h4>
1162911710
<table class="data" aria-labelledby="att-ismap">
1163011711
<tbody>
@@ -16853,10 +16934,11 @@ <h3>Change Log</h3>
1685316934
<section>
1685416935
<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>
1685516936
<ul>
16856-
<li>2-April-2025: Add `command` and `commandfor` attribute mappings. See <a href="https://github.com/w3c/aria/pull/2354/">GitHub ARIA PR 2354</a>.</li>
16857-
<li>11-July-2024: User Agents ignore `aria-hidden=true` on `body` and `html` elements. See <a href="https://github.com/w3c/html-aam/pull/516">GitHub PR 516</a>.</li>
16858-
<li>06-June-2024: Add concept of Minimum Role. See <a href="https://github.com/w3c/html-aam/pull/454">GitHub PR 454</a>.</li>
16859-
<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>
16937+
<li>2-Sep-2025: Add `interestfor` attribute mappings. See <a href="https://github.com/w3c/aria/pull/Xyz/">GitHub ARIA PR Xyz</a>.</li>
16938+
<li>2-Apr-2025: Add `command` and `commandfor` attribute mappings. See <a href="https://github.com/w3c/aria/pull/2354/">GitHub ARIA PR 2354</a>.</li>
16939+
<li>11-Jul-2024: User Agents ignore `aria-hidden=true` on `body` and `html` elements. See <a href="https://github.com/w3c/html-aam/pull/516">GitHub PR 516</a>.</li>
16940+
<li>06-Jun-2024: Add concept of Minimum Role. See <a href="https://github.com/w3c/html-aam/pull/454">GitHub PR 454</a>.</li>
16941+
<li>06-Jun-2024: Add `popover`, `popovertarget` and `popovertargetaction` mappings. See <a href="https://github.com/w3c/html-aam/pull/481">GitHub PR 481</a>.</li>
1686016942
<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>
1686116943
<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>
1686216944
<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>

0 commit comments

Comments
 (0)