Skip to content

Commit

Permalink
proposed rewording for the complementary landmark (#1698)
Browse files Browse the repository at this point in the history
SHA: 8ef7dde
Reason: push, by @jnurthen

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
  • Loading branch information
scottaohara and github-actions[bot] committed Aug 30, 2022
1 parent 801dc90 commit 6f2f87b
Showing 1 changed file with 3 additions and 3 deletions.
6 changes: 3 additions & 3 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -1143,7 +1143,7 @@ <h1 id="title" class="title">Accessible Rich Internet Applications (WAI-ARIA) 1.
<dt><a href="#comment" class="role-reference"><code>comment</code></a></dt>
<dd>A comment contains content expressing reaction to other content.</dd>
<dt><a href="#complementary" class="role-reference"><code>complementary</code></a></dt>
<dd>A <a href="#landmark" class="role-reference"><code>landmark</code></a> that is designed to be complementary to the main content, but would remain meaningful if it were to be separated from the main content. Complementary content is ideally placed at a similar level in the <abbr title="Document Object Model">DOM</abbr> hierarchy to the main content. For instance, as a sibling in the <abbr title="Document Object Model">DOM</abbr> hierarchy, or as a direct child of the main content.</dd>
<dd>A <a href="#landmark" class="role-reference"><code>landmark</code></a> that is designed to be complementary to the main content that it is a sibling to, or a direct descendant of. The contents of a complementary landmark would be expected to remain meaningful if it were to be separated from the main content it is relevant to.</dd>
<dt><a href="#composite" class="role-reference"><code>composite</code></a></dt>
<dd>A <a href="#dfn-widget" class="internalDFN" data-link-type="dfn">widget</a> that may contain navigable descendants or <a data-link-type="dfn" href="#dfn-owned-element" class="internalDFN">owned</a> children.</dd>
<dt><a href="#contentinfo" class="role-reference"><code>contentinfo</code></a></dt>
Expand Down Expand Up @@ -3055,8 +3055,8 @@ <h4 class="role-name" title="comment" aria-describedby="desc-comment"><code>comm
<section class="role notoc" id="complementary">
<h4 class="role-name" title="complementary" aria-describedby="desc-complementary"><code>complementary</code> <span class="type-indicator">role</span></h4>
<div class="role-description" id="desc-complementary" role="definition">
<p>A <a href="#landmark" class="role-reference"><code>landmark</code></a> that is designed to be complementary to the main content, but would remain meaningful if it were to be separated from the main content. Complementary content is ideally placed at a similar level in the <abbr title="Document Object Model">DOM</abbr> hierarchy to the main content. For instance, as a sibling in the <abbr title="Document Object Model">DOM</abbr> hierarchy, or as a direct child of the main content.</p>
<p>There are various types of content that would appropriately have this <a href="#dfn-role" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-role-45">role</a>. For example, in the case of a portal, this may include but not be limited to show times, current weather, related articles, or stocks to watch. The complementary role indicates that contained content is relevant to the main content. If the complementary content is completely separable from the main content, it may be appropriate to use a more general role.</p>
<p>A <a href="#landmark" class="role-reference"><code>landmark</code></a> that is designed to be complementary to the main content that it is a sibling to, or a direct descendant of. The contents of a complementary landmark would be expected to remain meaningful if it were to be separated from the main content it is relevant to.</p>
<p>There are various types of content that would appropriately have this <a href="#dfn-role" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-role-45">role</a>. For example, in the case of a portal, this may include but not be limited to show times, current weather, related articles, or stocks to watch. If the complementary content is completely separable from the main content, it may be appropriate to use a more general role.</p>
<p><a href="#dfn-assistive-technologies" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-assistive-technologies-23">Assistive technologies</a> <em class="rfc2119">SHOULD</em> enable users to quickly navigate to elements with role <code>complementary</code>.
<a data-link-type="dfn" data-type="dfn" href="https://infra.spec.whatwg.org/#user-agent">user agents</a> <em class="rfc2119">SHOULD</em> treat elements with role <code>complementary</code> as navigational <a href="#dfn-landmark" class="internalDFN" data-link-type="dfn" id="ref-for-dfn-landmark-5">landmarks</a>.
<a data-link-type="dfn" data-type="dfn" href="https://infra.spec.whatwg.org/#user-agent">user agents</a> <em class="rfc2119">MAY</em> enable users to quickly navigate to elements with role <code>complementary</code>.</p>
Expand Down

0 comments on commit 6f2f87b

Please sign in to comment.