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

<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>.

<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>

<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>

<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>

<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>

<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>

<li>

18-Jan-2022:

Added <a href="#docconformance-deprecated">Requirements for deprecated ARIA role, state and property and attributes</a>.

</li>