Skip to content

Commit

Permalink
proposed rewording for the complementary landmark (#1698)
Browse files Browse the repository at this point in the history
  • Loading branch information
scottaohara committed Aug 30, 2022
1 parent d925596 commit 8ef7dde
Showing 1 changed file with 2 additions and 2 deletions.
4 changes: 2 additions & 2 deletions index.html
Expand Up @@ -2603,8 +2603,8 @@ <h2>Definition of Roles</h2>
<div class="role" id="complementary">
<rdef>complementary</rdef>
<div class="role-description">
<p>A <rref>landmark</rref> 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 DOM hierarchy to the main content. For instance, as a sibling in the DOM hierarchy, or as a direct child of the main content.</p>
<p>There are various types of content that would appropriately have this <a>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 <rref>landmark</rref> 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>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>Assistive technologies</a> SHOULD enable users to quickly navigate to elements with role <code>complementary</code>.
[=user agents=] SHOULD treat elements with role <code>complementary</code> as navigational <a>landmarks</a>.
[=user agents=] MAY enable users to quickly navigate to elements with role <code>complementary</code>.</p>
Expand Down

0 comments on commit 8ef7dde

Please sign in to comment.