From 4f18cc6ab1376afd803f72e14375c93095a32a43 Mon Sep 17 00:00:00 2001 From: Jean-Yves Moyen Date: Thu, 8 Oct 2020 15:31:04 +0200 Subject: [PATCH 1/3] Make inapplicable example not fail the requirement --- _rules/aria-required-context-role-ff89c9.md | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/_rules/aria-required-context-role-ff89c9.md b/_rules/aria-required-context-role-ff89c9.md index 211251a9f9f..ca0ae3bd3b5 100755 --- a/_rules/aria-required-context-role-ff89c9.md +++ b/_rules/aria-required-context-role-ff89c9.md @@ -211,11 +211,9 @@ This `section` element with an [explicit role][] of `doc-biblioentry` has a role ```html

Cited Works

-
-

- John Steinbeck, The Grapes of Wrath (New York: The Viking Press, 1939) -

-
+

+ John Steinbeck, The Grapes of Wrath (New York: The Viking Press, 1939) +

``` From 12ca0d620edcab08001b95672a40d4862289aae2 Mon Sep 17 00:00:00 2001 From: Jean-Yves Moyen Date: Thu, 15 Oct 2020 13:40:57 +0200 Subject: [PATCH 2/3] Update explanation on ignoring DPUB ARIA --- _rules/aria-required-context-role-ff89c9.md | 4 +++- _rules/aria-required-owned-element-bc4a75.md | 7 ++++--- 2 files changed, 7 insertions(+), 4 deletions(-) diff --git a/_rules/aria-required-context-role-ff89c9.md b/_rules/aria-required-context-role-ff89c9.md index ca0ae3bd3b5..db50fe002da 100755 --- a/_rules/aria-required-context-role-ff89c9.md +++ b/_rules/aria-required-context-role-ff89c9.md @@ -43,7 +43,7 @@ This rule assumes that the `role` attribute is used to give a [semantic role][] ## Background -The applicability of this rule is limited to the [WAI-ARIA 1.1 Recommendation][aria 1.1] roles, since there are unresolved issues with how [Digital Publishing WAI-ARIA Module (DPUB ARIA) 1.0][dpub 1.0] uses role inheritance to define the [required context roles][], which makes it deviate from the model defined in [WAI-ARIA 1.1][aria 1.1]. The [WAI-ARIA Graphics Module](https://www.w3.org/TR/graphics-aria-1.0/) does not include any [required context roles][]. +The applicability of this rule is limited to the [WAI-ARIA 1.1 Recommendation][aria 1.1] roles. The [WAI-ARIA Graphics Module][] does not include any [required context roles][]. The [Digital Publishing WAI-ARIA Module (DPUB ARIA) 1.0][dpub 1.0] only has two roles with [required context roles][] (`doc-biblioentry` and `doc-endnote`); both of them have issues with their use of role inheritance, and both of them are deprecated in the [Digital Publishing WAI-ARIA Module (DPUB ARIA) 1.1][dpub 1.1] editor's draft. An example of an element that has an [implicit semantic role][] that is identical to its [explicit semantic role][] is a `
  • ` element. These elements are not applicable because they have extra requirements and should thus be checked separately. @@ -239,6 +239,7 @@ There is no element with an [explicit role][] different from its [implicit role] [aria 1.1]: https://www.w3.org/TR/wai-aria-1.1/ 'WAI ARIA 1.1 specifications' [content model]: https://html.spec.whatwg.org/multipage/dom.html#concept-element-content-model 'HTML definition of the Content Model' [dpub 1.0]: https://www.w3.org/TR/dpub-aria-1.0/ 'Digital Publishing WAI-ARIA Module (DPUB ARIA) 1.0' +[dpub 1.1]: https://w3c.github.io/dpub-aria/ "Digital Publishing WAI-ARIA Module (DPUB ARIA) 1.1 (Editor's Draft)" [explicit role]: #explicit-role 'Definition of Explicit Role' [explicit semantic role]: #explicit-role 'Definition of Explicit Role' [implicit role]: #implicit-role 'Definition of Implicit Role' @@ -251,3 +252,4 @@ There is no element with an [explicit role][] different from its [implicit role] [semantic role]: #semantic-role 'Definition of Semantic Role' [subclass role]: https://www.w3.org/TR/wai-aria-1.1/#subclassroles 'ARIA Specification of Subclass Role' [ul]: https://html.spec.whatwg.org/multipage/grouping-content.html#the-ul-element 'HTML specification of the ul element' +[wai-aria graphics module]: https://www.w3.org/TR/graphics-aria-1.0/ 'WAI-ARIA Graphics Module 1.0' diff --git a/_rules/aria-required-owned-element-bc4a75.md b/_rules/aria-required-owned-element-bc4a75.md index 3c62cc6eb06..e6f29ce0b9a 100755 --- a/_rules/aria-required-owned-element-bc4a75.md +++ b/_rules/aria-required-owned-element-bc4a75.md @@ -53,7 +53,7 @@ HTML elements with an [implicit semantic role][] corresponding to [explicit sema Some [required owned elements][] are only valid if they themselves [own][owns] (or "contain") elements with a given [semantic role][]. This is denoted by an arrow (meaning "containing") in the role description. For example, the role `menu` has `group → menuitemradio` as one of its [required owned elements][], meaning that elements with a role of `menu` may only [own][owns] elements with a role of `group` who themselves only [own][owns] elements with a role of `menuitemradio`. -The unresolved issues with how [Digital Publishing WAI-ARIA Module][] (DPUB ARIA 1.1) uses role inheritance to define the [required owned element][] limit the scope of this rule to [WAI-ARIA 1.1][] roles only. The [WAI-ARIA Graphics Module][] does not include any [required owned element][]. +The applicability of this rule is limited to the [WAI-ARIA 1.1 Recommendation][wai-aria 1.1] roles. The [WAI-ARIA Graphics Module][] does not include any [required owned elements][]. The [Digital Publishing WAI-ARIA Module (DPUB ARIA) 1.0][dpub 1.0] only has three roles with [required owned elements][] (`doc-bibliography`, `doc-endnotes` and `doc-glossary`); they have issues with their use of role inheritance, and all of them have no [required owned elements][] in the [Digital Publishing WAI-ARIA Module (DPUB ARIA) 1.1][dpub 1.1] editor's draft. The combobox role is excluded from this rule, because the design pattern for it as described in ARIA 1.1 has proven problematic. The combobox will be significantly different for ARIA 1.2, where it does not have [required owned elements][]. @@ -265,6 +265,7 @@ This element with the `combobox` role conforms to [WAI-ARIA 1.1][] without owned ``` [attribute value]: #attribute-value 'Definition of Attribute Value' +[dpub 1.1]: https://w3c.github.io/dpub-aria/ "Digital Publishing WAI-ARIA Module (DPUB ARIA) 1.1 (Editor's Draft)" [required owned element]: https://www.w3.org/TR/wai-aria-1.1/#mustContain 'Define Required owned element' [required owned elements]: https://www.w3.org/TR/wai-aria-1.1/#mustContain 'Define Required owned element' [owns]: #owned-by @@ -274,6 +275,6 @@ This element with the `combobox` role conforms to [WAI-ARIA 1.1][] without owned [semantic role]: #semantic-role [included in the accessibility tree]: #included-in-the-accessibility-tree [wai-aria 1.1]: https://www.w3.org/TR/wai-aria-1.1/ -[digital publishing wai-aria module]: https://www.w3.org/TR/dpub-aria-1.0/ -[wai-aria graphics module]: https://www.w3.org/TR/graphics-aria-1.0/ +[dpub 1.0]: https://www.w3.org/TR/dpub-aria-1.0/ +[wai-aria graphics module]: https://www.w3.org/TR/graphics-aria-1.0/ 'WAI-ARIA Graphics Module 1.0' [ancestor]: https://dom.spec.whatwg.org/#concept-tree-ancestor 'Definition Ancestors, as on 2020-01-10' From 3b1fb7c4f82ec251d8b6e4f22f659d87abfd1691 Mon Sep 17 00:00:00 2001 From: Jean-Yves Moyen Date: Thu, 15 Oct 2020 13:47:38 +0200 Subject: [PATCH 3/3] Make example compliant with DPUB 1.1 --- _rules/aria-required-context-role-ff89c9.md | 9 +++------ 1 file changed, 3 insertions(+), 6 deletions(-) diff --git a/_rules/aria-required-context-role-ff89c9.md b/_rules/aria-required-context-role-ff89c9.md index db50fe002da..f2842d57eb2 100755 --- a/_rules/aria-required-context-role-ff89c9.md +++ b/_rules/aria-required-context-role-ff89c9.md @@ -206,14 +206,11 @@ There is no element with an [explicit role][]. #### Inapplicable Example 3 -This `section` element with an [explicit role][] of `doc-biblioentry` has a role from the [Digital Publishing WAI-ARIA Module (DPUB ARIA) 1.0][dpub 1.0], not the [WAI-ARIA 1.1 Recommendation][aria 1.1]. +This `section` element with an [explicit role][] of `doc-abstract` has a role from the [Digital Publishing WAI-ARIA Module (DPUB ARIA) 1.0][dpub 1.0], not the [WAI-ARIA 1.1 Recommendation][aria 1.1]. ```html -
    -

    Cited Works

    -

    - John Steinbeck, The Grapes of Wrath (New York: The Viking Press, 1939) -

    +
    +

    Accessibility of web content requires semantic information about widgets, structures, and behaviors …

    ```