diff --git a/index.html b/index.html index ada510da..0d439514 100644 --- a/index.html +++ b/index.html @@ -2180,17 +2180,18 @@

`figcaption`

[[wai-aria-1.2]] - No corresponding role + `caption` role MSAA + IAccessible2
- Roles: `ROLE_SYSTEM_TEXT`; `IA2_ROLE_CAPTION` + Role: Use WAI-ARIA mapping
- Relations: `IA2_RELATION_LABEL_FOR` with parent `figure` element + Relations: + If the first instance of a child `figcaption` to its parent `figure`, then `IA2_RELATION_DETAILS_FOR` with parent `figure`.
@@ -2198,7 +2199,7 @@

`figcaption`

UIA
- Control Type: `Text` + Role: Use WAI-ARIA mapping
@@ -2206,11 +2207,12 @@

`figcaption`

ATK
- Role: `ATK_ROLE_CAPTION` + Role: Use WAI-ARIA mapping
Relations: - `ATK_RELATION_LABEL_FOR` with parent `figure` element + If this is the first instance of a child `figcaption` to its parent `figure` element, + then expose `RELATION_DETAILS_FOR` referencing the parent `figure` element.
@@ -2218,13 +2220,7 @@

`figcaption`

AX
- AXRole: `AXGroup` -
-
- AXSubrole: `(nil)` -
-
- AXRoleDescription: `"group"` + Role: Use WAI-ARIA mapping
@@ -2232,6 +2228,9 @@

`figcaption`

Comments +

+ Only the first child instance of a `figcaption` element that is present in the accessibility tree (e.g., not 'hidden') + provides details for its parent `figure` element.

@@ -2258,7 +2257,9 @@

`figure`

Role: Use WAI-ARIA mapping
- Relations: `IA2_RELATION_LABELLED_BY` with child `figcaption` element + Relations: + `IA2_RELATION_DETAILS` points to the first instance of a child `figcaption` if the element is present in the accessibility tree of the + parent `figure` element.
@@ -2268,8 +2269,10 @@

`figure`

Role: Use WAI-ARIA mapping
-
- Accessible name derived from `figcaption` according to the `figure` Element Accessible Name Computation +
+ Property: + `DescribedBy` references the first instance of a child `figcaption` element if the element is present in the accessibility tree + of the parent `figure` element.
@@ -2283,7 +2286,9 @@

`figure`

Name: related `figcaption` content
- Relations: `ATK_RELATION_LABELLED_BY` with child `figcaption` element + Relations: + `RELATION_DETAILS` references the first instance of a child `figcaption` element if the element is present in the accessibility tree + of the parent `figure` element.
@@ -2293,12 +2298,25 @@

`figure`

AXRole: Use WAI-ARIA mapping
+
+ Property: + `AXDetailsElements` references the first instance of a child `figcaption` element if the element is present in the accessibility tree + of the parent `figure` element. +
Comments +

+ If an author specifies a `figure` element to acquire its accessible name or description from the first instance + of a child `figcaption` element via an `aria-labelledby` or `aria-describedby` association, then user agents SHOULD NOT expose a + details relationship between the parent `figure` and child `figcaption` elements.

+

+ An explicit declaration of the `aria-details` attribute on the `figure` element will override the implicit `aria-details` + association with the element's child `figcaption` element, if one exists. If the `aria-details` attribute has an empty value, + then the `figure` element has no details relation to expose.

@@ -16453,17 +16471,25 @@

`summary` Element Accessible Name Computation

`figure` Element Accessible Name Computation

+

+ A `figcaption` provides additional details related to its parent + `figure` element. A `figcaption` does not take part in the + accessible name or accessible description + computation, unless explicitly referenced by an author. +

+

+ When an author uses `aria-labelledby` or `aria-describedby` to reference the first child `figcaption` element from the parent `figure` element, + user agents SHOULD NOT expose the details relationship between the `figure` and `figcaption` elements, and instead expose the `figcaption` as the element's accessible name or description, + according to the following steps. +

  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.
  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. + Otherwise, use the `title` attribute.
    3. -
  3. - If the accessible name is still empty, then: if the `figure` element has a `title` attribute, then use that attribute. -
    4. -
  4. Otherwise, there is no accessible name.
    5. +
  5. If none of the above yield a usable text string there is no accessible name.