Skip to content

Commit

Permalink
add new deprecated features section (#391)
Browse files Browse the repository at this point in the history 
* adds new section for deprecated ARIA / DPub ARIA features which SHOULD NOT be used in HTML
* updates to HTML element table per the new section (`ul`, `ol`, `menu` and `li` elements updated).
* updates to what "any role" means to indicate that deprecated roles SHOULD NOT be used.
* update changelog
  • Loading branch information
@scottaohara
scottaohara authored Jan 18, 2022
1 parent 1e48b78 commit b29956b
Showing 1 changed file with 68 additions and 20 deletions.
88 changes: 68 additions & 20 deletions index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -248,7 +248,10 @@ <h2 id="docconformance">
a cell in the third column includes the term
<dfn><strong>Any</strong> `role`</dfn> it indicates that any `role`
value apart from the <a>implicit ARIA semantics</a> `role` value,
MAY be used. If a cell in the third column includes the term
MAY be used, <span class="proposed addition">unless it is a role
<a href="#docconformance-deprecated">deprecated by ARIA</a>.
Deprecated roles SHOULD NOT be used by authors</span>.
If a cell in the third column includes the term
<dfn><strong>No `role`</strong></dfn> it indicates that authors
MUST NOT overwrite the implicit ARIA semantics, or native semantics
of the HTML element.
Expand Down Expand Up @@ -1892,15 +1895,10 @@ <h2 id="docconformance">
and any `aria-*` attributes applicable to the allowed roles.
</p>
<div class="addition proposal">
<p>Authors SHOULD NOT use the following DPub Roles:
<a data-cite="dpub-aria-1.0#doc-biblioentry">`doc-biblioentry`</a>,
<a data-cite="dpub-aria-1.0#doc-endnote">`doc-endnote`</a>.
<p>Authors SHOULD NOT use the following <a href="#docconformance-deprecated">deprecated</a> DPub Roles:
<a data-cite="dpub-aria-1.1#doc-biblioentry">`doc-biblioentry`</a>,
<a data-cite="dpub-aria-1.1#doc-endnote">`doc-endnote`</a>.
</p>
<div class="note">
<p>The `doc-biblioentry` and `doc-endnote` roles are not valid children of an element with an implict or explicit role of `list`.
These roles are marked for deprecation in [[[dpub-aria-1.1]]].
Authors can use standard `li` elements without the need for these roles.</p>
</div>
</div>
</td>
</tr>
Expand Down Expand Up @@ -1991,7 +1989,6 @@ <h2 id="docconformance">
<td>
<p>
Roles:
<a href="#index-aria-directory">`directory`</a>,
<a href="#index-aria-group">`group`</a>,
<a href="#index-aria-listbox">`listbox`</a>,
<a href="#index-aria-menu">`menu`</a>,
Expand All @@ -2007,6 +2004,10 @@ <h2 id="docconformance">
<a data-cite="wai-aria-1.1#global_states">Global `aria-*` attributes</a>
and any `aria-*` attributes applicable to the allowed roles.
</p>
<div class="addition proposal">
<p>Authors SHOULD NOT use <a href="#docconformance-deprecated">deprecated</a> <a href="#index-aria-directory">`directory`</a> role.
</p>
</div>
</td>
</tr>
<tr>
Expand Down Expand Up @@ -2112,7 +2113,6 @@ <h2 id="docconformance">
<td>
<p>
Roles:
<a href="#index-aria-directory">`directory`</a>,
<a href="#index-aria-group">`group`</a>,
<a href="#index-aria-listbox">`listbox`</a>,
<a href="#index-aria-menu">`menu`</a>,
Expand All @@ -2128,6 +2128,10 @@ <h2 id="docconformance">
<a data-cite="wai-aria-1.1#global_states">Global `aria-*` attributes</a>
and any `aria-*` attributes applicable to the allowed roles.
</p>
<div class="addition proposal">
<p>Authors SHOULD NOT use <a href="#docconformance-deprecated">deprecated</a> <a href="#index-aria-directory">`directory`</a> role.
</p>
</div>
</td>
</tr>
<tr>
Expand Down Expand Up @@ -2918,7 +2922,6 @@ <h2 id="docconformance">
<td>
<p>
Roles:
<a href="#index-aria-directory">`directory`</a>,
<a href="#index-aria-group">`group`</a>,
<a href="#index-aria-listbox">`listbox`</a>,
<a href="#index-aria-menu">`menu`</a>,
Expand All @@ -2934,6 +2937,10 @@ <h2 id="docconformance">
<a data-cite="wai-aria-1.1#global_states">Global `aria-*` attributes</a>
and any `aria-*` attributes applicable to the allowed roles.
</p>
<div class="addition proposal">
<p>Authors SHOULD NOT use <a href="#docconformance-deprecated">deprecated</a> <a href="#index-aria-directory">`directory`</a> role.
</p>
</div>
</td>
</tr>
<tr>
Expand Down Expand Up @@ -3352,15 +3359,52 @@ <h3 id="docconformance-attr">
</tbody>
</table>
</section>
<section class="proposed addition">
<h2 id="docconformance-deprecated">
Requirements for deprecated ARIA role, state and property and attributes
</h2>
<p>
The ARIA Specification's <a data-cite="wai-aria-1.2#deprecated">Deprecated Requirements</a> section indicates that if an ARIA feature is marked as deprecated then authors are recommended to not use said feature for new content.
</p>
<p>
The following roles and attributes are deprecated features of ARIA and DPub ARIA. Conformance checkers MUST warn authors about the deprecated status of these features. Whenever possible, authors are advised to use alternatives to deprecated features.
</p>

<h3>Deprecated ARIA roles</h3>
<ul>
<li><a data-cite="wai-aria-1.2#directory">`directory`</a></li>
</ul>
<div class="note">
<p>The `directory` role is marked for deprecation in [[wai-aria-1.2|WAI-ARIA 1.2]]. In reality, the `directory` role had no functional difference to an element with an implicit or explicit `list` role. Authors are advised to use one of HTML's native list elements, or an ARIA `list` instead.</p>
</div>

<h3>Deprecated DPub ARIA roles</h3>
<ul>
<li><a data-cite="dpub-aria-1.1#doc-biblioentry">`doc-biblioentry`</a></li>
<li><a data-cite="dpub-aria-1.1#doc-endnote">`doc-endnote`</a></li>
</ul>
<div class="note">
<p>The `doc-biblioentry` and `doc-endnote` roles are marked for deprecation in [[[dpub-aria-1.1]]], as they are not valid children for an element with an implicit or explicit role of `list`. Authors can use standard list and child `li` elements without the need for these roles.</p>
</div>

<h3>Deprecated ARIA attributes</h3>
<ul>
<li><a data-cite="wai-aria-1.1#aria-dropeffect">`aria-dropeffect`</a></li>
<li><a data-cite="wai-aria-1.1#aria-grabbed">`aria-grabbed`</a></li>
</ul>
<div class="note">
<p>The `aria-dropeffect` and `aria-grabbed` attributes were deprecated in [[wai-aria-1.1|WAI-ARIA 1.1]]. There is presently no feature in ARIA to replace their proposed functionality.</p>
</div>
</section>
<section>
<h2 id="case-sensitivity">
Case requirements for ARIA role, state and property attributes
</h2>
<p>
Authors SHOULD use [=ASCII lowercase=] for all `role` token values
and any state or property attributes (`aria-*`) whose values are
<a data-cite="wai-aria-1.1#propcharacteristic_value">defined as tokens</a>.
</p>
<h2 id="case-sensitivity">
Case requirements for ARIA role, state and property attributes
</h2>
<p>
Authors SHOULD use [=ASCII lowercase=] for all `role` token values
and any state or property attributes (`aria-*`) whose values are
<a data-cite="wai-aria-1.1#propcharacteristic_value">defined as tokens</a>.
</p>

<div class="note">
<p>
Expand Down Expand Up @@ -4376,6 +4420,10 @@ <h2>
<h2>Change log</h2>
<h3>Substantive changes since the last published Recommendation</h3>
<ul>
<li>
18-Jan-2022:
Added <a href="#docconformance-deprecated">Requirements for deprecated ARIA role, state and property and attributes</a>.
</li>
<li>
06-Jan-2022:
Change allowances for `doc-biblioentry` and `doc-endnote` roles on the <a href="#el-li">`li` element</a>.
Expand Down

0 comments on commit b29956b

Please sign in to comment.