Skip to content

add new deprecated features section #391

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 10 commits into from
Jan 18, 2022
Merged

add new deprecated features section #391

Changes from all commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
2a55ea9
add new deprecated features section
scottaohara Jan 9, 2022
e01c3fa
Update index.html
scottaohara Jan 9, 2022
dc85f78
Update index.html
scottaohara Jan 10, 2022
db52215
Update index.html
scottaohara Jan 10, 2022
b7f4f97
Merge branch 'gh-pages' into deprecated-features
scottaohara Jan 10, 2022
f6986a7
Merge branch 'gh-pages' into deprecated-features
scottaohara Jan 10, 2022
ba81235
Merge branch 'gh-pages' into deprecated-features
scottaohara Jan 16, 2022
3238542
Merge branch 'gh-pages' into deprecated-features
scottaohara Jan 17, 2022
ecf2036
update changelog
scottaohara Jan 18, 2022
52d0f14
Update index.html
scottaohara Jan 18, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
88 changes: 68 additions & 20 deletions index.html
View file
Open in desktop
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