From 2a55ea9f4efeebac5836da911428b5d717ad587b Mon Sep 17 00:00:00 2001 From: Scott O'Hara Date: Sun, 9 Jan 2022 13:00:19 -0500 Subject: [PATCH 1/6] add new deprecated features section * adds new section for deprecated 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. --- index.html | 66 ++++++++++++++++++++++++++++++++++++++++++++---------- 1 file changed, 54 insertions(+), 12 deletions(-) diff --git a/index.html b/index.html index ac1e3a10..91f6f2b6 100644 --- a/index.html +++ b/index.html @@ -248,7 +248,8 @@

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 deprecated role, which 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 +1893,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 +1987,6 @@

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

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

+
+

Authors SHOULD NOT use deprecated `directory` role. +

+
@@ -2112,7 +2111,6 @@

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

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

+
+

Authors SHOULD NOT use deprecated `directory` role. +

+
@@ -2918,7 +2920,6 @@

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

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

+
+

Authors SHOULD NOT use deprecated `directory` role. +

+
@@ -3352,6 +3357,43 @@

+
+

+ Requirements for use of deprecated ARIA roles and attributes in HTML +

+

+ The ARIA Specification's `directory` + +

+

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 `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 From e01c3fa5e42774e00d67832291b663f4346d9d45 Mon Sep 17 00:00:00 2001 From: Scott O'Hara Date: Sun, 9 Jan 2022 13:35:10 -0500 Subject: [PATCH 2/6] Update index.html --- index.html | 28 ++++++++++++++-------------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/index.html b/index.html index 91f6f2b6..7778c183 100644 --- a/index.html +++ b/index.html @@ -3362,13 +3362,13 @@

Requirements for use of deprecated ARIA roles and attributes in HTML

- 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. Authors SHOULD NOT use these features. + 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.

-

Deprecated ARIA roles

+

Deprecated ARIA roles

@@ -3376,16 +3376,16 @@

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

+

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 `li` elements without the need for these 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

+

Deprecated ARIA attributes

-

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

From dc85f7864e7a56af06f095d971385f9b6cac4f53 Mon Sep 17 00:00:00 2001 From: Scott O'Hara Date: Sun, 9 Jan 2022 19:29:46 -0500 Subject: [PATCH 3/6] Update index.html --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 7778c183..b41ad03b 100644 --- a/index.html +++ b/index.html @@ -248,7 +248,7 @@

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, unless it is a deprecated role, which SHOULD NOT be used by authors. + MAY be used, unless it is a deprecated role, which 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 From db52215465fdbd733fecd40ab4f8f90a0690e5fc Mon Sep 17 00:00:00 2001 From: Scott O'Hara Date: Sun, 9 Jan 2022 19:34:05 -0500 Subject: [PATCH 4/6] Update index.html --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index b41ad03b..d902063a 100644 --- a/index.html +++ b/index.html @@ -3359,7 +3359,7 @@

- Requirements for use of deprecated ARIA roles and attributes in HTML + Requirements for use of 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. From ecf20360adff95f3717393f23e11d5ab6bedd850 Mon Sep 17 00:00:00 2001 From: Scott O'Hara Date: Tue, 18 Jan 2022 08:20:58 -0500 Subject: [PATCH 5/6] update changelog * update changelog for new deprecated section * minor rewording / author advisement to deprecation section --- index.html | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/index.html b/index.html index b1920ba1..31e98e87 100644 --- a/index.html +++ b/index.html @@ -3359,13 +3359,13 @@

- Requirements for use of deprecated ARIA role, state and property and attributes + 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 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. + 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

@@ -4418,6 +4418,10 @@

Change log

Substantive changes since the last published Recommendation

    +
  • + 18-Jan-2022: + Added Requirements for deprecated ARIA role, state and property and attributes. +
  • 06-Jan-2022: Change allowances for `doc-biblioentry` and `doc-endnote` roles on the `li` element. From 52d0f144b3a703c02da29dbb56e6beeae956936f Mon Sep 17 00:00:00 2001 From: Scott O'Hara Date: Tue, 18 Jan 2022 08:27:34 -0500 Subject: [PATCH 6/6] Update index.html --- index.html | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/index.html b/index.html index 31e98e87..57a81376 100644 --- a/index.html +++ b/index.html @@ -248,7 +248,9 @@

    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, unless it is a deprecated role, which SHOULD NOT be used by authors. + 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