diff --git a/index.html b/index.html index 35f29aca8..b08fc133c 100644 --- a/index.html +++ b/index.html @@ -792,9 +792,9 @@

Non-interference with the Host Language

language.

- If a CSS selector includes a WAI-ARIA attribute (e.g., input[aria-invalid="true"]), user agents MUST update the visual display of any elements - matching (or no longer matching) the selector any time the attribute is added/changed/removed in the DOM. The user agent MAY alter the mapping of - the host language features into an accessibility APIinput[aria-invalid="true"]), user agents MUST update the visual display of any elements matching (or + no longer matching) the selector any time the attribute is added/changed/removed in the DOM. The user agent MAY alter the mapping of the host + language features into an accessibility API, but the user agent MUST NOT alter the DOM in order to remap WAI-ARIA markup into host language features.

@@ -4755,15 +4755,19 @@

Definition of Roles

group

A set of user interface objects that is not intended to be included in a page summary or table of contents by assistive technologies.

-

Contrast with region, which is a grouping of user interface objects that will be included in a page summary or table of contents.

- Authors SHOULD use a group to form a logical collection of items in a widget, such as children in a tree widget forming a collection of siblings in a hierarchy. - However, when a group is used in the context of a listbox, for example, authors MUST limit its children to option elements. Therefore, proper - handling of group by authors and assistive technologies is determined by the context in which it is provided. -

+ Contrast with region, which is a grouping of user interface objects that will be included in a page summary or table of contents. If a section is significant enough to + warrant inclusion in the web page's table of contents, the author SHOULD assign it a role ofregion or a standard landmark role. +

- Authors MAY nest group elements. If a section is significant enough to warrant inclusion in the web page's table of contents, the author SHOULD assign it a role of - region or a standard landmark role. + Authors SHOULD use a group to form a logical collection of items in a widget, such as children in a tree widget forming a collection of siblings in a hierarchy. + Authors MAY nest group elements. +

+

+ The proper handling of group by authors and assistive technologies is determined by the context in which it is provided. For example, when a group is the + accessibility child of a menu or menubar, authors MAY nest additional group elements. However, the accessibility children of the + innermost group MUST be limited to menuitem, menuitemcheckbox, menuitemradio and separator elements. Whereas when a + group is the accessibility child of a listbox, authors MUST NOT nest any group and MUST limit the groups accessibility children to option elements.

@@ -6200,6 +6204,13 @@

Plain HTML or Polyfill DOM Result of the MathML Quadratic Formula

To be keyboard accessible, authors SHOULD manage focus of descendants for all instances of this role, as described in Managing Focus.

Elements with the role menu have an implicit aria-orientation value of vertical.

+

+ The menu role allows only roles menuitem, menuitemcheckbox, menuitemradio, and separator as + accessibility children. These roles may be nested within structural elements with roles generic, group, or none that sit between them and the + menu. This allows authors to organize menus logically using groups or to style them using generic containers. However, aside from group, no other semantically + meaningful roles may intervene between the allowed child roles and the menu. This structure mirrors the concept of "accessibility children", but explicitly permits + group in addition to generic and none as intervening elements. +

@@ -6245,9 +6256,7 @@

Plain HTML or Polyfill DOM Result of the MathML Quadratic Formula

    -
  • group with accessibility child menuitem
    • -
  • group with accessibility child menuitemradio
    • -
  • group with accessibility child menuitemcheckbox
    • +
  • group as intervening role
  • menuitem
  • menuitemcheckbox
  • menuitemradio
    • @@ -6304,6 +6313,13 @@

    Plain HTML or Polyfill DOM Result of the MathML Quadratic Formula

    To be keyboard accessible, authors SHOULD manage focus of descendants for all instances of this role, as described in Managing Focus.

    Elements with the role menubar have an implicit aria-orientation value of horizontal.

    +

    + The menubar role allows only roles menuitem, menuitemcheckbox, menuitemradio, and separator as + accessibility children. These roles may be nested within structural elements with roles generic, group, or none that sit between them and the + menubar. This allows authors to organize menubars logically using groups or to style them using generic containers. However, aside from group, no other semantically + meaningful roles may intervene between the allowed child roles and the menubar. This structure mirrors the concept of "accessibility children", but explicitly permits + group in addition to generic and none as intervening elements. +

    @@ -6345,9 +6361,7 @@

    Plain HTML or Polyfill DOM Result of the MathML Quadratic Formula

      -
    • group with accessibility child menuitem
      • -
    • group with accessibility child menuitemradio
      • -
    • group with accessibility child menuitemcheckbox
      • +
    • group as intervening role
    • menuitem
    • menuitemcheckbox
    • menuitemradio
      • @@ -6399,8 +6413,8 @@

      Plain HTML or Polyfill DOM Result of the MathML Quadratic Formula

      An option in a set of choices contained by a menu or menubar.

      - Authors MUST ensure [=elements=] with role menuitem are accessibility children of an element with role menu, menubar, or an element - with role group that is an accessibility child of an element with role menu or menubar. + Authors MUST ensure [=elements=] with role menuitem have an accessibility ancestor with role menu, menubar, with only elements of + role generic, group, and none intervening.

      Authors MAY disable a menu item with the aria-disabled attribute. If the menu item has its aria-haspopup attribute set to true, it indicates that @@ -6457,6 +6471,7 @@

      Plain HTML or Polyfill DOM Result of the MathML Quadratic Formula

      @@ -6519,8 +6534,8 @@

      Plain HTML or Polyfill DOM Result of the MathML Quadratic Formula

      A menuitem with a checkable state whose possible values are true, false, or mixed.

      - Authors MUST ensure [=elements=] with role menuitemcheckbox are accessibility children of an element with role menu, menubar, or an - element with role group that is an accessibility child of an element with role menu or menubar. + Authors MUST ensure [=elements=] with role menuitemcheckbox have an accessibility ancestor with role menu or menubar, with only + elements of role generic, group, and none intervening.

      The aria-checked attribute of a menuitemcheckbox indicates whether the menu item is checked (true), unchecked (false), or @@ -6573,6 +6588,7 @@

      Plain HTML or Polyfill DOM Result of the MathML Quadratic Formula

      @@ -6631,8 +6647,8 @@

      Plain HTML or Polyfill DOM Result of the MathML Quadratic Formula

      A checkable menuitem in a set of elements with the same role, only one of which can be checked at a time.

      - Authors MUST ensure [=elements=] with role menuitemradio are accessibility children of an element with role menu, menubar, or an - element with role group that is an accessibility child of an element with role menu or menubar. + Authors MUST ensure [=elements=] with role menuitemradio have an accessibility ancestor with role menu, menubar, with only elements + of role generic, group, and none intervening.

      Authors SHOULD enforce that only one menuitemradio in a group can be checked at the same time. When one item in the group is checked, the previously checked item becomes @@ -6690,6 +6706,7 @@

      Plain HTML or Polyfill DOM Result of the MathML Quadratic Formula

      @@ -16143,6 +16160,10 @@

      Including Elements in the Accessibility Tree

      Relationships in the Accessibility Tree

      The following terms are used to describe relationships between DOM elements.

      +

      + The accessibility ancestors of a DOM element are all DOM elements of which the given DOM element is an + accessibility descendant. +

      The accessibility children of a DOM element are all of the children of that element's corresponding accessible object in the accessibility tree. In terms of the DOM, that includes the following (with exclusions listed blow):