From 742360cd80e6f95d415a2539720a66a9f5cdd790 Mon Sep 17 00:00:00 2001 From: Scott O'Hara Date: Wed, 12 Jul 2023 09:55:47 -0400 Subject: [PATCH] Editorial: revise redundant role declaration example (#482) * Editorial: revise redundant role declaration example closes #478 * remove errant `;` closes #479 --- html-aria/index.html | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/html-aria/index.html b/html-aria/index.html index fd258b47d..659a6e31b 100644 --- a/html-aria/index.html +++ b/html-aria/index.html @@ -318,12 +318,11 @@

<main role="Main">...</main>

- The following uses a `role=list` on an [^ul^] element. This is - generally unnecessary, because the `ul` element is implicitly exposed - as a `role=list`. However, some user agents suppress a list's - implicit ARIA semantics if list markers are removed. Authors can - use `role=list` to reinstate the role if necessary, though this - practice would generally not be recommended, otherwise. + The following uses a `role=list` on an [^ul^] element. As the `ul` element has an implicit role of `list`, + explicitly adding the role would generally be considered redundant. However, some user agents suppress a list's + implicit ARIA semantics if the list markers are removed from the visual presentation of the list items. + Generally the redundant declaration of an element's implicit role would not be recommended, but in specific situations + such as this, and where the role is necessary to expose, authors can explicitly add the role.

           <!-- Generally avoid doing this! -->
@@ -374,7 +373,7 @@ 

Adhere to the rules of ARIA

           <!-- Avoid doing this! -->
-          <article role="generic" ...>...</article>;
+          <article role="generic" ...>...</article>
         

Additionally, ARIA specifically mentions in Conflicts with Host Language Semantics