From b29956b6cf8dab6a0ff7a7038327156b265daf79 Mon Sep 17 00:00:00 2001 From: Scott O'Hara Date: Tue, 18 Jan 2022 08:29:29 -0500 Subject: [PATCH] add new deprecated features section (#391) * 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 --- index.html | 88 +++++++++++++++++++++++++++++++++++++++++------------- 1 file changed, 68 insertions(+), 20 deletions(-) diff --git a/index.html b/index.html index 39a7c3c0..57a81376 100644 --- a/index.html +++ b/index.html @@ -248,7 +248,10 @@

a cell in the third column includes the term Any `role` it indicates that any `role` value apart from the implicit ARIA semantics `role` value, - MAY be used. If a cell in the third column includes the term + MAY be used, unless it is a role + deprecated by ARIA. + Deprecated roles SHOULD NOT be used by authors. + If a cell in the third column includes the term No `role` it indicates that authors MUST NOT overwrite the implicit ARIA semantics, or native semantics of the HTML element. @@ -1892,15 +1895,10 @@

and any `aria-*` attributes applicable to the allowed roles.

-

Authors SHOULD NOT use the following DPub Roles: - `doc-biblioentry`, - `doc-endnote`. +

Authors SHOULD NOT use the following deprecated DPub Roles: + `doc-biblioentry`, + `doc-endnote`.

-
-

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.

-
@@ -1991,7 +1989,6 @@

Roles: - `directory`, `group`, `listbox`, `menu`, @@ -2007,6 +2004,10 @@

Global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

+
+

Authors SHOULD NOT use deprecated `directory` role. +

+
@@ -2112,7 +2113,6 @@

Roles: - `directory`, `group`, `listbox`, `menu`, @@ -2128,6 +2128,10 @@

Global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

+
+

Authors SHOULD NOT use deprecated `directory` role. +

+
@@ -2918,7 +2922,6 @@

Roles: - `directory`, `group`, `listbox`, `menu`, @@ -2934,6 +2937,10 @@

Global `aria-*` attributes and any `aria-*` attributes applicable to the allowed roles.

+
+

Authors SHOULD NOT use deprecated `directory` role. +

+
@@ -3352,15 +3359,52 @@

+
+

+ Requirements for deprecated ARIA role, state and property and attributes +

+

+ The ARIA Specification's Deprecated Requirements section indicates that if an ARIA feature is marked as deprecated then authors are recommended to not use said feature for new content. +

+

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

+ +

Deprecated ARIA roles

+ +
+

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.

+
+ +

Deprecated DPub ARIA roles

+ +
+

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.

+
+ +

Deprecated ARIA attributes

+ +
+

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.

+
+
-

- Case requirements for ARIA role, state and property attributes -

-

- Authors SHOULD use [=ASCII lowercase=] for all `role` token values - and any state or property attributes (`aria-*`) whose values are - defined as tokens. -

+

+ Case requirements for ARIA role, state and property attributes +

+

+ Authors SHOULD use [=ASCII lowercase=] for all `role` token values + and any state or property attributes (`aria-*`) whose values are + defined as tokens. +

@@ -4376,6 +4420,10 @@

Change log

Substantive changes since the last published Recommendation