Skip to content

Commit

Permalink
Clarify that user agents should not expose aria-haspopup=false (#2030)
Browse files Browse the repository at this point in the history
SHA: 9b2a146
Reason: push, by jnurthen

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
  • Loading branch information
sivakusayan and github-actions[bot] committed Oct 3, 2023
1 parent 239628a commit 45dfe88
Showing 1 changed file with 5 additions and 5 deletions.
10 changes: 5 additions & 5 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -309,15 +309,15 @@
}
},
"lint": false,
"publishISODate": "2023-09-27T00:00:00.000Z",
"generatedSubtitle": "W3C Editor's Draft 27 September 2023"
"publishISODate": "2023-10-03T00:00:00.000Z",
"generatedSubtitle": "W3C Editor's Draft 03 October 2023"
}</script>
<link rel="stylesheet" href="https://www.w3.org/StyleSheets/TR/2021/W3C-ED"></head>
<body class="h-entry" data-cite="dom accname-1.2 core-aam-1.2 infra HTML"><div class="head">
<p class="logos"><a class="logo" href="https://www.w3.org/"><img crossorigin="" alt="W3C" height="48" src="https://www.w3.org/StyleSheets/TR/2021/logos/W3C" width="72">
</a></p>
<h1 id="title" class="title">Accessible Rich Internet Applications (WAI-ARIA) 1.3</h1>
<p id="w3c-state"><a href="https://www.w3.org/standards/types#ED">W3C Editor's Draft</a> <time class="dt-published" datetime="2023-09-27">27 September 2023</time></p>
<p id="w3c-state"><a href="https://www.w3.org/standards/types#ED">W3C Editor's Draft</a> <time class="dt-published" datetime="2023-10-03">03 October 2023</time></p>
<details open="">
<summary>More details about this document</summary>
<dl>
Expand Down Expand Up @@ -12220,7 +12220,7 @@ <h4><span class="property-name" title="aria-haspopup" aria-describedby="desc-ari
<p>A popup element usually appears as a block of content that is on top of other content. Authors <em class="rfc2119">MUST</em> ensure that the role of the element that serves as the container for the popup content is <a href="#menu" class="role-reference"><code>menu</code></a>, <a href="#listbox" class="role-reference"><code>listbox</code></a>, <a href="#tree" class="role-reference"><code>tree</code></a>, <a href="#grid" class="role-reference"><code>grid</code></a>, or <a href="#dialog" class="role-reference"><code>dialog</code></a>, and that the value of <code>aria-haspopup</code> matches the role of the popup container.</p>
<p>For the popup element to be keyboard accessible, authors <em class="rfc2119">SHOULD</em> ensure that the element that can trigger the popup is focusable, that there is a keyboard mechanism for opening the popup, and that the popup element manages focus of all its descendants as described in <a href="#managingfocus">Managing Focus</a>.</p>
<p>The <code>aria-haspopup</code> property is a token type. <a data-link-type="dfn|abstract-op" data-type="dfn" href="https://infra.spec.whatwg.org/#user-agent">User agents</a> <em class="rfc2119">MUST</em> treat any value of <code>aria-haspopup</code> that is not included in the list of allowed values, including an empty string, as if the value <code>false</code> had been provided. To provide backward compatibility with ARIA 1.0 content, user agents <em class="rfc2119">MUST</em> treat an <code>aria-haspopup</code> value of <code>true</code> as equivalent to a value of <code>menu</code>.</p>
<p><a href="#dfn-assistive-technologies" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-assistive-technologies-68">Assistive technologies</a> <em class="rfc2119">SHOULD NOT</em> expose the <code>aria-haspopup</code> property if it has a value of <code>false</code>.</p>
<p><a href="#dfn-assistive-technologies" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-assistive-technologies-68">Assistive technologies</a> and user agents <em class="rfc2119">SHOULD NOT</em> expose the <code>aria-haspopup</code> property if it has a value of <code>false</code>.</p>
<div class="note" role="note" id="issue-container-generatedID-49"><div role="heading" class="note-title marker" id="h-note-49" aria-level="4"><span>Note</span></div><p class="">A <a href="#tooltip" class="role-reference"><code>tooltip</code></a> is not considered to be a popup in this context.</p></div>
<div class="note" role="note" id="issue-container-generatedID-50"><div role="heading" class="note-title marker" id="h-note-50" aria-level="4"><span>Note</span></div><p class=""><code>aria-haspopup</code> is most relevant to use when there is a visual indicator in the element that triggers the popup.
For example, many controls styled with a downward pointing triangle, chevron, or ellipsis (three consecutive dots) have become standard visual indicators that a popup will display when the control is activated.
Expand Down Expand Up @@ -14972,7 +14972,7 @@ <h4><span class="property-name" title="aria-valuetext" aria-describedby="desc-ar
</dd><dt id="bib-fingerprinting-guidance">[fingerprinting-guidance]</dt><dd>
<a href="https://www.w3.org/TR/fingerprinting-guidance/"><cite>Mitigating Browser Fingerprinting in Web Specifications</cite></a>. Nick Doty. W3C. 28 March 2019. W3C Working Group Note. URL: <a href="https://www.w3.org/TR/fingerprinting-guidance/">https://www.w3.org/TR/fingerprinting-guidance/</a>
</dd><dt id="bib-html-aria">[HTML-ARIA]</dt><dd>
<a href="https://www.w3.org/TR/html-aria/"><cite>ARIA in HTML</cite></a>. Scott O'Hara; Patrick Lauke. W3C. 27 August 2023. W3C Recommendation. URL: <a href="https://www.w3.org/TR/html-aria/">https://www.w3.org/TR/html-aria/</a>
<a href="https://www.w3.org/TR/html-aria/"><cite>ARIA in HTML</cite></a>. Scott O'Hara; Patrick Lauke. W3C. 3 October 2023. W3C Recommendation. URL: <a href="https://www.w3.org/TR/html-aria/">https://www.w3.org/TR/html-aria/</a>
</dd><dt id="bib-iaccessible2">[IAccessible2]</dt><dd>
<a href="https://wiki.linuxfoundation.org/accessibility/iaccessible2/"><cite>IAccessible2</cite></a>. Linux Foundation. URL: <a href="https://wiki.linuxfoundation.org/accessibility/iaccessible2/">https://wiki.linuxfoundation.org/accessibility/iaccessible2/</a>
</dd><dt id="bib-msaa">[MSAA]</dt><dd>
Expand Down

0 comments on commit 45dfe88

Please sign in to comment.