From 269e80652c2bdebe8828c611877b66f24a8b8cf8 Mon Sep 17 00:00:00 2001 From: Giacomo Petri Date: Fri, 21 Mar 2025 15:41:19 +0100 Subject: [PATCH 01/15] Update index.html --- index.html | 21 ++++++++++++++++++--- 1 file changed, 18 insertions(+), 3 deletions(-) diff --git a/index.html b/index.html index 35f29aca8..e0882a0ca 100644 --- a/index.html +++ b/index.html @@ -6200,6 +6200,10 @@

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 doesn't allow for accessibility children roles other than menuitem, menuitemcheckbox, menuitemradio, + separator, and group. In this context, the role group allows only accessibility children with a role group, menuitem, menuitemcheckbox, menuitemradio or separator. +

@@ -6245,9 +6249,11 @@

Plain HTML or Polyfill DOM Result of the MathML Quadratic Formula

    +
  • group with accessibility child group
  • group with accessibility child menuitem
  • group with accessibility child menuitemradio
  • group with accessibility child menuitemcheckbox
    • +
  • group with accessibility child separator
  • menuitem
  • menuitemcheckbox
  • menuitemradio
    • @@ -6304,6 +6310,10 @@

    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 doesn't allow for accessibility children roles other than menuitem, menuitemcheckbox, menuitemradio, + separator, and group. In this context, the role group allows only accessibility children with a role group, menuitem, menuitemcheckbox, menuitemradio or separator. +

    @@ -6345,9 +6355,11 @@

    Plain HTML or Polyfill DOM Result of the MathML Quadratic Formula

      +
    • group with accessibility child group
    • group with accessibility child menuitem
    • group with accessibility child menuitemradio
    • group with accessibility child menuitemcheckbox
      • +
    • group with accessibility child separator
    • menuitem
    • menuitemcheckbox
    • menuitemradio
      • @@ -6400,7 +6412,7 @@

      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. + with role group that is an accessibility child of an element with role group, menu or menubar.

      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 +6469,7 @@

      Plain HTML or Polyfill DOM Result of the MathML Quadratic Formula

      @@ -6520,7 +6533,7 @@

      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. + element with role group that is an accessibility child of an element with role group, menu or menubar.

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

      Plain HTML or Polyfill DOM Result of the MathML Quadratic Formula

      @@ -6632,7 +6646,7 @@

      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. + element with role group that is an accessibility child of an element with role group, menu or menubar.

      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 +6704,7 @@

      Plain HTML or Polyfill DOM Result of the MathML Quadratic Formula

      From e980d4b1f5f02e8c6854d5db760470bca90e3a3e Mon Sep 17 00:00:00 2001 From: giacomo-petri Date: Fri, 21 Mar 2025 14:55:24 +0000 Subject: [PATCH 02/15] chore: prettier --- index.html | 20 +++++++++++--------- 1 file changed, 11 insertions(+), 9 deletions(-) diff --git a/index.html b/index.html index e0882a0ca..60154c341 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.

      @@ -6200,9 +6200,10 @@

      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 doesn't allow for accessibility children roles other than menuitem, menuitemcheckbox, menuitemradio, - separator, and group. In this context, the role group allows only accessibility children with a role group, menuitem, menuitemcheckbox, menuitemradio or separator. +

      + The menu role doesn't allow for accessibility children roles other than menuitem, menuitemcheckbox, menuitemradio, + separator, and group. In this context, the role group allows only accessibility children with a role group, + menuitem, menuitemcheckbox, menuitemradio or separator.

      @@ -6310,9 +6311,10 @@

      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 doesn't allow for accessibility children roles other than menuitem, menuitemcheckbox, menuitemradio, - separator, and group. In this context, the role group allows only accessibility children with a role group, menuitem, menuitemcheckbox, menuitemradio or separator. +

      + The menubar role doesn't allow for accessibility children roles other than menuitem, menuitemcheckbox, menuitemradio, + separator, and group. In this context, the role group allows only accessibility children with a role group, + menuitem, menuitemcheckbox, menuitemradio or separator.

      From 6ff9aadeb053ddd192045edddc1ba20d48139920 Mon Sep 17 00:00:00 2001 From: Giacomo Petri Date: Fri, 21 Mar 2025 20:53:02 +0100 Subject: [PATCH 03/15] Update index.html Co-authored-by: Peter Krautzberger --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 60154c341..daa4c3dde 100644 --- a/index.html +++ b/index.html @@ -6201,7 +6201,7 @@

      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 doesn't allow for accessibility children roles other than menuitem, menuitemcheckbox, menuitemradio, + The menu role does not allow for accessibility children roles other than menuitem, menuitemcheckbox, menuitemradio, separator, and group. In this context, the role group allows only accessibility children with a role group, menuitem, menuitemcheckbox, menuitemradio or separator.

      From 6678aef93872492f8b08f408dabe1d0059c8764a Mon Sep 17 00:00:00 2001 From: Giacomo Petri Date: Fri, 21 Mar 2025 20:53:08 +0100 Subject: [PATCH 04/15] Update index.html Co-authored-by: Peter Krautzberger --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index daa4c3dde..ac7e0279d 100644 --- a/index.html +++ b/index.html @@ -6312,7 +6312,7 @@

      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 doesn't allow for accessibility children roles other than menuitem, menuitemcheckbox, menuitemradio, + The menubar role does not allow for accessibility children roles other than menuitem, menuitemcheckbox, menuitemradio, separator, and group. In this context, the role group allows only accessibility children with a role group, menuitem, menuitemcheckbox, menuitemradio or separator.

      From c5ee99aee04c9836b7feb3f9f54acff555aad9d3 Mon Sep 17 00:00:00 2001 From: Giacomo Petri Date: Fri, 21 Mar 2025 21:11:33 +0100 Subject: [PATCH 05/15] Update index.html --- index.html | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/index.html b/index.html index ac7e0279d..9d4e2c8aa 100644 --- a/index.html +++ b/index.html @@ -4758,8 +4758,10 @@

      Definition of Roles

      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. + However, when a group is used in the context of a listbox, for example, authors MUST limit its children to option elements. Similarly, when a + group is used in the context of a menu or menubar, authors MUST limit its children to menuitem, menuitemcheckbox, + menuitemradio, separator, and group elements. Therefore, proper handling of group by authors and assistive technologies is + determined by the context in which it is provided.

      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 From 02376602685911f01dfd9c284372e9a29afa7f79 Mon Sep 17 00:00:00 2001 From: giacomo-petri Date: Fri, 21 Mar 2025 20:11:55 +0000 Subject: [PATCH 06/15] chore: prettier --- index.html | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/index.html b/index.html index 9d4e2c8aa..958bd313c 100644 --- a/index.html +++ b/index.html @@ -4758,10 +4758,10 @@

      Definition of Roles

      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. Similarly, when a - group is used in the context of a menu or menubar, authors MUST limit its children to menuitem, menuitemcheckbox, - menuitemradio, separator, and group elements. Therefore, proper handling of group by authors and assistive technologies is - determined by the context in which it is provided. + However, when a group is used in the context of a listbox, for example, authors MUST limit its children to option elements. Similarly, when a + group is used in the context of a menu or menubar, authors MUST limit its children to menuitem, menuitemcheckbox, + menuitemradio, separator, and group elements. Therefore, proper handling of group by authors and assistive technologies is determined + by the context in which it is provided.

      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 From 6e9a04bfd7bd5d4f6fe31c338347789be1ebe2cc Mon Sep 17 00:00:00 2001 From: Giacomo Petri Date: Tue, 25 Mar 2025 13:06:08 +0100 Subject: [PATCH 07/15] Update index.html --- index.html | 31 ++++++++++++++++--------------- 1 file changed, 16 insertions(+), 15 deletions(-) diff --git a/index.html b/index.html index 958bd313c..297ab8054 100644 --- a/index.html +++ b/index.html @@ -4759,9 +4759,9 @@

      Definition of Roles

      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. Similarly, when a - group is used in the context of a menu or menubar, authors MUST limit its children to menuitem, menuitemcheckbox, - menuitemradio, separator, and group elements. Therefore, proper handling of group by authors and assistive technologies is determined - by the context in which it is provided. + group is used in the context of a menu or menubar, authors MUST limit its accessibility descendants to menuitem, menuitemcheckbox, + menuitemradio and separator, with only elements of role generic, group, and none intervening. Therefore, + proper handling of group by authors and assistive technologies is determined by the context in which it is provided.

      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 @@ -6203,9 +6203,8 @@

      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 does not allow for accessibility children roles other than menuitem, menuitemcheckbox, menuitemradio, - separator, and group. In this context, the role group allows only accessibility children with a role group, - menuitem, menuitemcheckbox, menuitemradio or separator. + The menu role allows only role menuitem, menuitemcheckbox, menuitemradio, and separator as + accessibility descendants, with only elements of role generic, group, and none intervening.

      @@ -6314,9 +6313,8 @@

      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 does not allow for accessibility children roles other than menuitem, menuitemcheckbox, menuitemradio, - separator, and group. In this context, the role group allows only accessibility children with a role group, - menuitem, menuitemcheckbox, menuitemradio or separator. + The menubar role allows only role menuitem, menuitemcheckbox, menuitemradio, and separator as + accessibility descendants, with only elements of role generic, group, and none intervening.

      @@ -6415,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 group, menu or menubar. + Authors MUST ensure [=elements=] with role menuitem are accessibility descendants of an element 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 @@ -6536,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 group, menu or menubar. + Authors MUST ensure [=elements=] with role menuitemcheckbox are accessibility descendants of an element 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 @@ -6649,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 group, menu or menubar. + Authors MUST ensure [=elements=] with role menuitemradio are accessibility descendants of an element 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 @@ -16162,6 +16160,9 @@

      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): From 79f6da991cf307400d285c971909e33b04b2bec7 Mon Sep 17 00:00:00 2001 From: giacomo-petri Date: Tue, 25 Mar 2025 12:06:32 +0000 Subject: [PATCH 08/15] chore: prettier --- index.html | 33 +++++++++++++++++---------------- 1 file changed, 17 insertions(+), 16 deletions(-) diff --git a/index.html b/index.html index 297ab8054..3e2da05be 100644 --- a/index.html +++ b/index.html @@ -4759,9 +4759,9 @@

      Definition of Roles

      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. Similarly, when a - group is used in the context of a menu or menubar, authors MUST limit its accessibility descendants to menuitem, menuitemcheckbox, - menuitemradio and separator, with only elements of role generic, group, and none intervening. Therefore, - proper handling of group by authors and assistive technologies is determined by the context in which it is provided. + group is used in the context of a menu or menubar, authors MUST limit its accessibility descendants to menuitem, + menuitemcheckbox, menuitemradio and separator, with only elements of role generic, group, and + none intervening. Therefore, proper handling of group by authors and assistive technologies is determined by the context in which it is provided.

      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 @@ -6203,8 +6203,8 @@

      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 role menuitem, menuitemcheckbox, menuitemradio, and separator as - accessibility descendants, with only elements of role generic, group, and none intervening. + The menu role allows only role menuitem, menuitemcheckbox, menuitemradio, and separator as + accessibility descendants, with only elements of role generic, group, and none intervening.

      @@ -6313,8 +6313,8 @@

      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 role menuitem, menuitemcheckbox, menuitemradio, and separator as - accessibility descendants, with only elements of role generic, group, and none intervening. + The menubar role allows only role menuitem, menuitemcheckbox, menuitemradio, and separator as + accessibility descendants, with only elements of role generic, group, and none intervening.

      @@ -6413,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 descendants of an element with role menu, menubar, with - only elements of role generic, group, and none intervening. + Authors MUST ensure [=elements=] with role menuitem are accessibility descendants of an element 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 @@ -6534,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 descendants of an element with role menu or menubar, with - only elements of role generic, group, and none intervening. + Authors MUST ensure [=elements=] with role menuitemcheckbox are accessibility descendants of an element 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 @@ -6647,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 descendants of an element with role menu, menubar, with - only elements of role generic, group, and none intervening. + Authors MUST ensure [=elements=] with role menuitemradio are accessibility descendants of an element 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 @@ -16160,9 +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 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): From db5ed0847a8ae09f8b1ea6e8a18034222fd90a05 Mon Sep 17 00:00:00 2001 From: Giacomo Petri Date: Tue, 25 Mar 2025 13:10:35 +0100 Subject: [PATCH 09/15] Update index.html --- index.html | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/index.html b/index.html index 3e2da05be..b3becac37 100644 --- a/index.html +++ b/index.html @@ -6413,7 +6413,7 @@

      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 descendants of an element with role menu, menubar, with only + 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.

      @@ -6534,7 +6534,7 @@

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

      @@ -6647,7 +6647,7 @@

      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 descendants of an element with role menu, menubar, with + 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.

      From d14eff87abfb3be6849cc4a93a2660f38c957ffb Mon Sep 17 00:00:00 2001 From: giacomo-petri Date: Tue, 25 Mar 2025 12:11:03 +0000 Subject: [PATCH 10/15] chore: prettier --- index.html | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/index.html b/index.html index b3becac37..65872c78f 100644 --- a/index.html +++ b/index.html @@ -6413,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 have an accessibility ancestor with role menu, menubar, with only - elements of role generic, group, and none intervening. + 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 @@ -6534,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 have an accessibility ancestor with role menu or menubar, - with only elements of role generic, group, and none intervening. + 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 @@ -6647,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 have an accessibility ancestor with role menu, menubar, with - only elements of role generic, group, and none intervening. + 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 From cecd77871d7c77417d45c933358a8783f123a812 Mon Sep 17 00:00:00 2001 From: Giacomo Petri Date: Tue, 25 Mar 2025 19:47:42 +0100 Subject: [PATCH 11/15] Update index.html fix typo --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 65872c78f..9b356fe9b 100644 --- a/index.html +++ b/index.html @@ -16161,7 +16161,7 @@

      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 + The accessibility ancestors of a DOM element are all DOM elements of which the given DOM element is an accessibility descendant.

      From 2b66bd07dd360a441133d07b3d1ff6ff3c32b549 Mon Sep 17 00:00:00 2001 From: Giacomo Petri Date: Mon, 4 Aug 2025 12:10:47 +0200 Subject: [PATCH 12/15] edit to group def, implementing Valerie's suggetion --- index.html | 20 +++++++++++--------- 1 file changed, 11 insertions(+), 9 deletions(-) diff --git a/index.html b/index.html index 9b356fe9b..9d8977ec8 100644 --- a/index.html +++ b/index.html @@ -4755,17 +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. Similarly, when a - group is used in the context of a menu or menubar, authors MUST limit its accessibility descendants to menuitem, - menuitemcheckbox, menuitemradio and separator, with only elements of role generic, group, and - none intervening. 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.

      From e155a274b970aa7154ecd072a2bdb5435a5dd38c Mon Sep 17 00:00:00 2001 From: Giacomo Petri Date: Tue, 5 Aug 2025 08:33:30 +0200 Subject: [PATCH 13/15] Update index.html Co-authored-by: Valerie Young --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 9d8977ec8..e64f03d2a 100644 --- a/index.html +++ b/index.html @@ -4756,7 +4756,7 @@

      Definition of Roles

      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 If a section is significant enough to + 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.

      From 35bfe75485b8f0f8f161a56cfa23271c509fb4a5 Mon Sep 17 00:00:00 2001 From: Giacomo Petri Date: Tue, 5 Aug 2025 09:11:30 +0200 Subject: [PATCH 14/15] updated menu and menubar notes --- index.html | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/index.html b/index.html index e64f03d2a..ec9e507c7 100644 --- a/index.html +++ b/index.html @@ -6205,8 +6205,11 @@

      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 role menuitem, menuitemcheckbox, menuitemradio, and separator as - accessibility descendants, with only elements of role generic, group, and none intervening. + 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.

      @@ -6315,8 +6318,11 @@

      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 role menuitem, menuitemcheckbox, menuitemradio, and separator as - accessibility descendants, with only elements of role generic, group, and none intervening. + 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.

      From 7048eb6295e6438239fc9d8ead70a3205214b133 Mon Sep 17 00:00:00 2001 From: Giacomo Petri Date: Thu, 7 Aug 2025 18:58:05 +0200 Subject: [PATCH 15/15] replaced group with specific acc desc with group as intervening --- index.html | 12 ++---------- 1 file changed, 2 insertions(+), 10 deletions(-) diff --git a/index.html b/index.html index ec9e507c7..b08fc133c 100644 --- a/index.html +++ b/index.html @@ -6256,11 +6256,7 @@

      Plain HTML or Polyfill DOM Result of the MathML Quadratic Formula