diff --git a/html-aam/index.html b/html-aam/index.html index ca3f951e6..b2238549b 100644 --- a/html-aam/index.html +++ b/html-aam/index.html @@ -1257,6 +1257,83 @@

`button`

+ +

`button` as a child of a `select` element

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
HTML Specification + `button` +
[[wai-aria-1.2]] +
Not mapped. See comments.
+ +
Computed Role +
Not mapped. See comments.
+
+ MSAA + IAccessible2 + +
See comments
+
UIA +
See comments
+
ATK +
See comments
+
AX +
See comments
+
Comments +

+ User agents MUST treat the child `button` element of a `select` element as inert. + The `select` and its child `button` part are meant to be considered a single item to users and in the user agent's accessibility tree. +

+

+ The text equivalent computation of the subtree of the + `button` element participates in the accessible value calculation of the `select` element. + See the `select` (with NO `multiple` attribute and NO `size` attribute having value greater than `1`) for more information. +

+

+ User agents MAY warn developers that the use of global HTML or ARIA attributes, or attributes specific to the `button` element or ARIA's `button` role are not expected to be used on a `button` element in this context. +

+

+ As this `button` element is inert, any use of global HTML or ARIA attributes, or attributes specific to the `button` element or ARIA's `button` role are not exposed to the user agent's accessibility API. +

+

`canvas`

@@ -6339,7 +6416,31 @@

`select` (with NO `multiple

- +
Comments +

To calculate the accessible value of a `select` element:

+
    +
  1. If `aria-valuetext` is specified on the `select` element, use the attribute's value, including the empty string.
    2. +
  2. Else if the is a `button` part, calcluate the accessible value from the text equivalent computation of the subtree of that element, even if it returns the empty string.
    3. +
  3. If the `select` element does not have an `aria-valuetext` attribute and does not contain a `button` part, then the accessible value is calculated from the accessible name of the selected `option` element.
    4. +
+ + +

The following text is still being refined

+

+ The calculated role of the customizable `select` element's popup picker is a `listbox`, by default.

+

+ If authors render invalid elements, in regard to the select element's content model, as descendants of the select element, and those invalid elements result in accessible objects being present as siblings in the accessibility tree to the valid descendent elements of the select, then user agents SHOULD expose the popup picker with the role of a modeless dialog.

+ +

+ In the event invalid elements are present, but are not rendered, then no user agent role repair is necessary.

+

+ In the event that invalid elements are present, but are empty, or are only used as wrapping elements for the valid descendent element's of a select, then user agents SHOULD ignore these elements in the accessibility tree. +

+ +

Treating the picker as a `dialog` can help inform users that content beyond the expected elements of a `listbox` popup are present, as they can then inspect the content of the dialog with their assistive technology to discover such content.

+ +

See also `button` element as a child of a `select` element.

+