From 37ca12487577e7852b71e6599940748e7b99a3da Mon Sep 17 00:00:00 2001 From: Carolyn MacLeod Date: Tue, 21 Apr 2020 23:15:23 -0400 Subject: [PATCH] Clarify wording in "Including Elements in the Accessibility Tree" section (#1100) Co-Authored-By: Matt King Co-authored-by: James Nurthen --- index.html | 23 +++++++++++++---------- 1 file changed, 13 insertions(+), 10 deletions(-) diff --git a/index.html b/index.html index 17e7c1a25..63a3795fc 100644 --- a/index.html +++ b/index.html @@ -13192,22 +13192,22 @@

Accessibility Tree

Excluding Elements from the Accessibility Tree

The following elements are not exposed via the accessibility API and user agents MUST NOT include them in the accessibility tree:

    -
  • Elements with none or presentation as the first role in the role attribute. However, their exclusion is conditional and depends on other factors. In addition, the element's descendants and text content are generally included. These exceptions and conditions are documented in the Presentational Roles Conflict Resolution section.
  • Elements, including their descendent elements, that have host language semantics specifying that the element is not displayed, such as CSS display:none, visibility:hidden, or the HTML hidden attribute.
    • -
+
  • Elements with none or presentation as the first role in the role attribute. However, their exclusion is conditional. In addition, the element's descendants and text content are generally included. These exceptions and conditions are documented in the presentation (role) section.
    • +

    If not already excluded from the accessibility tree per the above rules, user agents SHOULD NOT include the following elements in the accessibility tree:

    • Elements, including their descendants, that have aria-hidden set to true. In other words, aria-hidden="true" on a parent overrides aria-hidden="false" on descendants.

    • Any descendants of elements that have the characteristic "Children Presentational: True" unless the descendant is not allowed to be presentational because it meets one of the conditions for exception described in Presentational Roles Conflict Resolution. However, the text content of any excluded descendants is included.

      -

      Elements having one of the following roles have the characteristic "Children Presentational: True":

      +

      Elements with the following roles have the characteristic "Children Presentational: True":

      • button
      • checkbox
      • img
        • -
      • math
      • menuitemcheckbox
      • menuitemradio
        • +
      • meter
      • option
      • progressbar
      • radio
        • @@ -13222,14 +13222,17 @@

        Excluding Elements from the Accessibility Tree

        Including Elements in the Accessibility Tree

        -

        If not already excluded from the accessibility tree per the rules above in Excluding Elements in the Accessibility Tree, user agents MUST provide an accessible object in the accessibility tree for DOM elements that meet any of the following criteria:

        +

        If not excluded from the accessibility tree per the rules above in Excluding Elements in the Accessibility Tree, user agents MUST provide an accessible object in the accessibility tree for DOM elements that meet any of the following criteria:

          -
        • Text nodes
          • -
        • Elements that may fire an accessibility API event.
          • -
        • Elements that are focusable, or have an ID attribute and an ancestor with the aria-activedescendant attribute that matches the implicit or explicit semantics of the required context role. In either case, the element may receive focus and may fire an accessibility API focus event.
          • +
        • Elements that are not hidden and may fire an accessibility API event: +
            +
          • Elements that are focusable even if the element or one of its ancestor elements has its aria-hidden attribute set to true.
            • +
          • Elements that are a valid target of an aria-activedescendant attribute.
            • +
          +
        • Elements that have an explicit role or a global WAI-ARIA attribute and do not have aria-hidden set to true. (See Excluding Elements in the Accessibility Tree for additional guidance on aria-hidden.)
          • -
        • Elements that have an ID which is referenced by another element via a WAI-ARIA property and are not hidden. -

          Text equivalents for hidden referenced objects may still be used in the name and description computation even when not included in the accessibility tree.

          +
        • Elements that are not hidden and have an ID that is referenced by another element via a WAI-ARIA property. +

          Text equivalents for hidden referenced objects may still be used in the name and description computation even when not included in the accessibility tree.