diff --git a/index.html b/index.html index cd2235c7..77edf029 100644 --- a/index.html +++ b/index.html @@ -1454,7 +1454,7 @@

HTML Element Role Mappings

- If implemented as a color picker, any UI controls presented for selecting a color are exposed in the accessibility tree, associated with the `input` element, and mapped as appropriate for the type of control (e.g. button or slider). + If implemented as a color picker, any UI controls presented for selecting a color are exposed in the accessibility tree, associated with the `input` element, and mapped as appropriate for the type of control (e.g., button or slider).
@@ -2865,7 +2865,7 @@

HTML Element Role Mappings

Note: There are instances where CSS properties can affect what is exposed by accessibility APIs. - For instance, `display: none` or `visibility: hidden` will remove an element from the accessibility tree + For instance, `display: none` or `visibility: hidden` will remove an element from the accessibility tree and hide its presence from assistive technologies.
@@ -4321,7 +4321,7 @@

HTML Attribute State and Property Mappings

`AXTitle`: `<value>` - See Also: Accessible Name and Description: Computation and API Mappings 1.1 + See Also: Accessible Name and Description: Computation and API Mappings 1.2 @@ -5362,8 +5362,8 @@

HTML Attribute State and Property Mappings

- Either the accessible name, or the - accessible description, or Not mapped (see Comments). + Either contributes to the accessible name, the + accessible description, or is not mapped (see comments).
@@ -5644,31 +5644,118 @@

HTML Attribute State and Property Mappings

Not mapped
+ + `value` + + `input` + `type=button`; + `type=reset`; + `type=submit` + + + Contributes to the accessible name of the `input` + + See comments + See comments + See comments + See comments + + If specified, the value of the attribute will contribute to the + accessible name computations for these button-type `input` elements and render as the button's text label. + + + + `value` + + `input` + `type=checkbox`; + `type=hidden`; + `type=radio` + +
Not mapped
+
Not mapped
+
Not mapped
+
Not mapped
+
Not mapped
+ + + + `value` + + `input` + `type=color` + + + `aria-valuenow` & + `aria-valuetext` + + Use WAI-ARIA mapping + Use WAI-ARIA mapping + Use WAI-ARIA mapping + Use WAI-ARIA mapping + +

+ If specified, expose the value of the attribute as the initial value of the `input`. User Agents MUST expose the modified value of the input to the accessibility tree. User Agents MAY expose the initial or modified value as a human readable text alternative. E.g., `#ff0000` as a localized text alternative of "Red". +

+

+ If the `value` attribute is not specified, has no specified value, or if the specified value is invalid, the initial value of the `input` is `#000000` with a localized text alternative of "Black". +

+ + + `value` + + `input`; + `type=date`; + `type=datetime-local`; + `type=email`; + `type=month`; + `type=number`; + `type=password`; + `type=search`; + `type=tel`; + `type=text`; + `type=url`; + `type=week`; + + Not mapped + See comments + See comments + See comments + See comments + + If specified, expose the value of the attribute as the initial value entry of the `input` element. + + + `value` `input` + `type=image` - Not mapped - -
- Associates the accessible value for entry type input elements - and accessible name for button type input elements -
+ + Contributes to the accessible name of the `input` - -
- Associates the accessible value for entry type input elements - and accessible name for button type input elements -
+ See comments + See comments + See comments + See comments + + If specified, and the `input type=image` element has no `alt` attribute specified, then the value of the attribute will contribute to the + accessible name computations, and will render as text if the image source is broken. Otherwise, the attribute is ignored. - -
- Associates the accessible value for entry type input elements - and accessible name for button type input elements -
+ + + `value` + + `input` + `type=range` - `AXValue: <value>` + `aria-valuenow` + Use WAI-ARIA mapping + Use WAI-ARIA mapping + Use WAI-ARIA mapping + Use WAI-ARIA mapping @@ -5713,26 +5800,10 @@

HTML Attribute State and Property Mappings

`progress` `aria-valuenow` - -
- Exposed as `IAccessibleValue::currentValue` -
- - -
- Exposed as `Value.Value` -
- - -
- Exposed as `atk_value_get_current_value` -
- - -
- `AXValue: <value>` -
- + Use WAI-ARIA mapping + Use WAI-ARIA mapping + Use WAI-ARIA mapping + Use WAI-ARIA mapping @@ -5799,12 +5870,12 @@

Accessible Name and Description Computation

The terms accessible name and accessible description are properties provided in all accessibility APIs. The name of the properties may differ across APIs but they serve the same function: as a container for a short (name) or longer (description) string of text.

The text alternative computation is used to generate both the accessible name and accessible description. There are different rules provided for several different types of elements, nodes, and combinations of markup.

-

`input type="text"`, `input type="password"`,` input type="search"`,` input type="tel"`, `input type="url"` and `textarea` Element

+

`input type="text"`, `input type="password"`, `input type="search"`, `input type="tel"`, `input type="url"` and `textarea` Element

-

`input type="text"`, `input type="password"`,` input type="search"`,` input type="tel"`, `input type="email"`, `input type="url"` and `textarea` Element Accessible Name Computation

+

`input type="text"`, `input type="password"`, `input type="search"`, `input type="tel"`, `input type="email"`, `input type="url"` and `textarea` Element Accessible Name Computation

  1. - If the control has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the control has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
  2. Otherwise use the associated `label` element(s) accessible name(s) - if more than one label is associated; concatenate by DOM order, delimited by spaces. @@ -5820,7 +5891,7 @@

    `input type="text"`, `input type="password"`,` input type="search"`,` input

    `input type="text"`, `input type="password"`, `input type="search"`, `input type="tel"`, `input type="email"`, `input type="url"` and `textarea` Element Accessible Description Computation

    1. - If the element has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the element has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
    2. Otherwise use the `title` attribute if it wasn't used as the accessible name. @@ -5837,7 +5908,7 @@

      `input type="button"`, `input type="submit"` and `input type="reset"`

      `input type="button"` ,` input type="submit"` and `input type="reset"` Accessible Name Computation

      1. - If the control has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the control has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
      2. Otherwise use the `value` attribute.
      3. @@ -5856,7 +5927,7 @@

        `input type="button"` ,` input type="submit"` and `input type="reset"` Acces

        `input type="button"` ,` input type="submit"` and `input type="reset"` Accessible Description Computation

        1. - If the element has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the element has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
        2. Otherwise use the `value` attribute if it wasn't used as the accessible name. @@ -5876,7 +5947,7 @@

          `input type="image"`

          `input type="image"` Accessible Name Computation

          1. - If the control has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the control has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
          2. Otherwise use `alt` attribute.
            3. @@ -5893,7 +5964,7 @@

            `input type="image"` Accessible Name Computation

            input type="image" Accessible Description Computation

            1. - If the element has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the element has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
            2. Otherwise use the `title` attribute if it wasn't used as the accessible name. @@ -5910,7 +5981,7 @@

              `button` Element

              `button` Element Accessible Name Computation

              1. - If the `button` element has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the `button` element has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
              2. Otherwise use the `button` element subtree.
              3. Otherwise use `title` attribute.
                4. @@ -5923,7 +5994,7 @@

                `button` Element Accessible Name Computation

                `button` Element Accessible Description Computation

                1. - If the `button` has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the `button` has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
                2. Otherwise use the `title` attribute if it wasn't used as the accessible name. @@ -5940,7 +6011,7 @@

                  `fieldset` and legend Elements

                  `fieldset` Element Accessible Name Computation

                  1. - If the `fieldset` element has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the `fieldset` element has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
                  2. If the accessible name is still empty, then: if the `fieldset` element has a child that is a legend element, then use the subtree of the first such element. @@ -5955,7 +6026,7 @@

                    `fieldset` Element Accessible Name Computation

                    `fieldset` Element Accessible Description Computation

                    1. - If the `fieldset` element has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the `fieldset` element has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
                    2. Otherwise use the `title` attribute if it wasn't used as the accessible name. @@ -5972,7 +6043,7 @@

                      `output` Element

                      `output` Element Accessible Name Computation

                      1. - If the `output` element has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the `output` element has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
                      2. Otherwise use the `output` element subtree.
                      3. Otherwise use `title` attribute.
                        4. @@ -6000,7 +6071,7 @@

                        Other Form Elements

                        Other Form Elements Accessible Name Computation

                        1. - If the control has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the control has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
                        2. Otherwise use `label` element.
                        3. Otherwise use `title` attribute.
                          4. @@ -6013,7 +6084,7 @@

                          Other Form Elements Accessible Name Computation

                          Other Form Elements Accessible Description Computation

                          1. - If the element has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the element has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
                          2. Otherwise use the `title` attribute if it wasn't used as the accessible name. @@ -6030,7 +6101,7 @@

                            `summary` Element

                            `summary` Element Accessible Name Computation

                            1. - If the first `summary` element, which is a direct child of the `details` element, has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the first `summary` element, which is a direct child of the `details` element, has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
                            2. Otherwise use `summary` element subtree.
                            3. Otherwise use `title` attribute.
                              4. @@ -6046,7 +6117,7 @@

                              `summary` Element Accessible Name Computation

                              `summary` Element Accessible Description Computation

                              1. - If the element has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the element has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
                              2. Otherwise use `summary` element subtree if not used as the accessible name. @@ -6066,7 +6137,7 @@

                                `figure` and `figcaption` Elements

                                `figure` Element Accessible Name Computation

                                1. - If the `figure` element has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the `figure` element has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
                                2. If the accessible name is still empty, then: if the `figure` element has a child that is a `figcaption` element, then use the subtree of the first such element. @@ -6081,7 +6152,7 @@

                                  `figure` Element Accessible Name Computation

                                  `figure` Element Accessible Description Computation

                                  1. - If the element has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the element has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
                                  2. Otherwise use the `title` attribute if it wasn't used as the accessible name. @@ -6096,7 +6167,7 @@

                                    `img` Element

                                    `img` Element Accessible Name Computation

                                    1. - If the `img` element has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the `img` element has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
                                    2. Otherwise use `alt` attribute.
                                    3. Otherwise use `title` attribute.
                                      4. @@ -6110,7 +6181,7 @@

                                      `img` Element Accessible Name Computation

                                      `img` Element Accessible Description Computation

                                      1. - If the element has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the element has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
                                      2. Otherwise use the `title` attribute if it wasn't used as the accessible name. @@ -6127,7 +6198,7 @@

                                        `table` Element

                                        `table` Element Accessible Name Computation

                                        1. - If the `table` element has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the `table` element has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
                                        2. If the accessible name is still empty, then: if the `table` element has a child that is a caption element, then use the subtree of the first such element. @@ -6142,7 +6213,7 @@

                                          `table` Element Accessible Name Computation

                                          `table` Element Accessible Description Computation

                                          1. - If the element has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the element has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
                                          2. If the accessible description is still empty, then:, if the `table` element has a child that is a `caption` element and it wasn't used as the accessible name, then use the subtree of the first such element. @@ -6160,7 +6231,7 @@

                                            Other Tabular data elements

                                            `tr`, `td`, `th` Elements Accessible Name Computation

                                            1. - If the element has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the element has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
                                            2. Otherwise use the `title` attribute.
                                            3. @@ -6172,7 +6243,7 @@

                                              `tr`, `td`, `th` Elements Accessible Name Computation

                                              `tr`, `td`, `th` Elements Accessible Description Computation

                                              1. - If the element has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the element has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
                                              2. Otherwise use the `title` attribute if it wasn't used as the accessible name. @@ -6189,7 +6260,7 @@

                                                `a` Element with a `href` attribute

                                                `a` Element Accessible Name Computation

                                                1. - If the `a` element has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the `a` element has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
                                                2. Otherwise use `a` element subtree.
                                                3. Otherwise use the `title` attribute.
                                                  4. @@ -6202,7 +6273,7 @@

                                                  `a` Element Accessible Name Computation

                                                  `a` Element with a `href` attribute Accessible Description Computation

                                                  1. - If the element has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the element has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
                                                  2. Otherwise use the `title` attribute if it wasn't used as the accessible name. @@ -6219,7 +6290,7 @@

                                                    `area` Element

                                                    `area` Element Accessible Name Computation

                                                    1. - If the `area` element has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the `area` element has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
                                                    2. Otherwise use `area` element's `alt` attribute.
                                                    3. Otherwise use the `title` attribute.
                                                      4. @@ -6232,7 +6303,7 @@

                                                      `area` Element Accessible Name Computation

                                                      `area` Element Accessible Description Computation

                                                      1. - If the element has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the element has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
                                                      2. Otherwise use the `title` attribute if it wasn't used as the accessible name. @@ -6248,7 +6319,7 @@

                                                        `iframe` Element

                                                        `iframe` Element Accessible Name Computation

                                                          -
                                                        1. If the element has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. +
                                                        2. If the element has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
                                                        3. Otherwise use the `title` attribute.
                                                        4. If none of the above yield a usable text string there is no accessible name.
                                                          5. @@ -6259,7 +6330,7 @@

                                                          `iframe` Element Accessible Name Computation

                                                          `iframe` Element Accessible Description Computation

                                                          1. - If the element has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the element has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
                                                          2. Otherwise use the `title` attribute if it wasn't used as the accessible name. @@ -6276,7 +6347,7 @@

                                                            Section Elements and Section and Grouping Element Accessible Name Computation

                                                            1. - If the element has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the element has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
                                                            2. Otherwise use the `title` attribute.
                                                            3. @@ -6288,7 +6359,7 @@

                                                              Section and Grouping Element Accessible Name Computation

                                                              Section and Grouping Element Accessible Description Computation

                                                              1. - If the element has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the element has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
                                                              2. Otherwise use the `title` attribute if it wasn't used as the accessible name. @@ -6308,7 +6379,7 @@

                                                                Text Level Elements Not Listed Elsewhere

                                                                Text Level Element Accessible Name Computation

                                                                1. - If the element has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the element has an `aria-label` or an `aria-labelledby` attribute the accessible name is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
                                                                2. Otherwise use the `title` attribute.
                                                                3. @@ -6320,7 +6391,7 @@

                                                                  Text Level Element Accessible Name Computation

                                                                  Text Level Element Accessible Description Computation

                                                                  1. - If the element has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.1. + If the element has an `aria-describedby` attribute the accessible description is to be calculated using the algorithm defined in Accessible Name and Description: Computation and API Mappings 1.2.
                                                                  2. Otherwise use the `title` attribute if it wasn't used as the accessible name.