Skip to content

Add interestfor attribute related mappings #2617

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

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Add interestfor attribute related mappings #2617

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
90 changes: 86 additions & 4 deletions html-aam/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11622,6 +11622,87 @@ <h4 id="att-indeterminate">`indeterminate [IDL]`</h4>
</tr>
</tbody>
</table>
<h4 id="att-interestfor-attribute">`interestfor`</h4>
<table class="data" aria-labelledby="att-interestfor-attribute">
<tbody>
<tr>
<th>HTML Specification</th>
<td>
<span class="el-context"> `interestfor` </span>
</td>
</tr>
<tr>
<th>Element(s)</th>
<td>
<a data-cite="html/form-elements.html#the-button-element">`button`</a>;
<a data-cite="html/text-level-semantics.html#the-a-element">`a`</a>;
<a data-cite="html/image-maps.html#the-area-element">`area`</a>
</td>
</tr>
<tr>
<th>[[WAI-ARIA-1.2]]</th>
<td>
<p>A popover is <dfn>"plain"</dfn> if it contains only elements with a computed role of generic, text and images.</p>
<p>A popover is <dfn>"rich"</dfn> if it is not "plain".</p>
<p>If the `interestfor`-associated element is invalid, or is not a not a popover: no `aria-expanded` mapping</p>
<p>
If the `interestfor`-associated element is an accessibility ancestor of the interest invoker:
<a class="core-mapping" href="#ariaExpandedUndefined">`aria-expanded=undefined`</a>
</p>
<p>If the `interestfor`-associated element is a <a>"plain"</a> popover:
<ul>
<li><p>Set <a class="core-mapping" href="#ariaHiddenTrue">`aria-hidden="true"`</a> on the target popover.</p></li>
<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
the <a data-cite="accname-1.2/#dfn-accessible-name">accessible name</a>.</p></li>
<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
<a data-cite="accname-1.2/#dfn-accessible-description">accessible description</a>, setting the
<a data-cite="wai-aria-1.2/#aria-describedby">`aria-describedby`</a> relation to point from the interest invoker to the popover</p></li>
</ul>
</p>
<p>If the `interestfor`-associated element is a <a>"rich"</a> popover:
<ul>
<li><p>If the popover is displayed: <a class="core-mapping" href="#ariaExpandedTrue">`aria-expanded=true`</a></p></li>
<li><p>If the popover is hidden: <a class="core-mapping" href="#ariaExpandedFalse">`aria-expanded=false`</a></p></li>
<li><p>Set a <a href="termref">minimum role</a> of <a class="core-mapping" href="#role-map-tooltip">`tooltip`</a> on the target popover</p></li>
<li><p>Set `aria-details` pointing to the target popover</p></li>
</ul>
</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="objattrs"><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="objattrs"><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>
</td>
</tr>
</tbody>
</table>
<h4 id="att-ismap">`ismap`</h4>
<table class="data" aria-labelledby="att-ismap">
<tbody>
Expand Down Expand Up @@ -17028,10 +17109,11 @@ <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>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>
<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>
<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>
<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>2-Sep-2025: Add `interestfor` attribute mappings. See <a href="https://github.com/w3c/aria/pull/2617/">GitHub ARIA PR 2617</a>.</li>
<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>
<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>
<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>
<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>
<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