From de58e32bb6c807002b393e50bc398d4d9bcaa1a9 Mon Sep 17 00:00:00 2001 From: Keith Cirkel Date: Fri, 11 Oct 2024 21:38:11 +0100 Subject: [PATCH 01/21] Add command & commandfor attribute related mappings --- html-aam/index.html | 131 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 131 insertions(+) diff --git a/html-aam/index.html b/html-aam/index.html index ca3f951e6..5f4d4f80b 100644 --- a/html-aam/index.html +++ b/html-aam/index.html @@ -9365,6 +9365,137 @@

`controls`

+

`command`

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
HTML Specification`command`
Element(s) + `button`; +
[[WAI-ARIA-1.2]] +
Not mapped
+
+ MSAA + IAccessible2 + +
Not mapped
+
UIA +
Not mapped
+
ATK +
Not mapped
+
AX +
Not mapped
+
CommentsThe value of this attribute can impact the mappings of its related `commandfor` attribute.
+

`commandfor`

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
HTML Specification`commandfor`
Element(s) + `button`; +
[[WAI-ARIA-1.2]] +
+

+ If the associated element is displayed as a popover: + `aria-expanded=true` +

+

+ If the element with the `commandfor` attribute has a `command` attribute with value of "`show-popover`", or "`toggle-popover`" and + the associated element is hidden, or not present in the DOM: + `aria-expanded=false` +

+

+ If the element with the `commandfor` attribute has a `command` attribute with value of "`show-popover`", or "`toggle-popover`", and + the associated element is an accessibility ancestor of the element with the `commandfor` attribute: + `aria-expanded=undefined` +

+
+
+ MSAA + IAccessible2 + +
Use WAI-ARIA mapping
+
Object attributes: `details-roles:popover`
+
UIA +
Use WAI-ARIA mapping
+
ATK +
Use WAI-ARIA mapping
+
Object attributes: `details-roles:popover`
+
AX +
Use WAI-ARIA mapping
+
Comments +

+ User Agents MUST expose an `aria-details` relation with the associated element except under the following + conditions: +

+
    +
  • The element's `command` attribute value is a value other than "`show-popover`" or "`toggle-popover`",
    • +
  • The associated popover element is the next immediate accessibility sibling to the invoking element,
    • +
  • The element's `command` attribute is in the "`toggle-popover`" state and the element is a descendant of the `popover` it is associated with.
    • + +
+

A button that a [=button/form owner=] without `type` in the "`button`" state cannot invoke a command.

+

`coords`

From a0fb231ee8f855282dba732283373373a50984ee Mon Sep 17 00:00:00 2001 From: keithamus Date: Fri, 11 Oct 2024 20:54:56 +0000 Subject: [PATCH 02/21] chore: prettier --- html-aam/index.html | 19 +++++++------------ 1 file changed, 7 insertions(+), 12 deletions(-) diff --git a/html-aam/index.html b/html-aam/index.html index 5f4d4f80b..1312fec1a 100644 --- a/html-aam/index.html +++ b/html-aam/index.html @@ -9374,9 +9374,7 @@

`command`

 - + @@ -9425,9 +9423,7 @@

`commandfor`

- + @@ -9438,13 +9434,13 @@

`commandfor`

`aria-expanded=true`

- If the element with the `commandfor` attribute has a `command` attribute with value of "`show-popover`", or "`toggle-popover`" and - the associated element is hidden, or not present in the DOM: + If the element with the `commandfor` attribute has a `command` attribute with value of "`show-popover`", or "`toggle-popover`" and the associated element is hidden, or not present + in the DOM: `aria-expanded=false`

- If the element with the `commandfor` attribute has a `command` attribute with value of "`show-popover`", or "`toggle-popover`", and - the associated element is an accessibility ancestor of the element with the `commandfor` attribute: + If the element with the `commandfor` attribute has a `command` attribute with value of "`show-popover`", or "`toggle-popover`", and the associated element is an accessibility + ancestor of the element with the `commandfor` attribute: `aria-expanded=undefined`

@@ -9482,8 +9478,7 @@

`commandfor`

- + From 0b1053cc9964dd49d29ee3ffe6cc99cd7f8e9972 Mon Sep 17 00:00:00 2001 From: Keith Cirkel Date: Thu, 17 Oct 2024 23:23:28 +0100 Subject: [PATCH 04/21] expand to 1 table per command attribute state --- html-aam/index.html | 438 +++++++++++++++++++++++++++++++------------- 1 file changed, 312 insertions(+), 126 deletions(-) diff --git a/html-aam/index.html b/html-aam/index.html index 21a8303cf..74bec6ece 100644 --- a/html-aam/index.html +++ b/html-aam/index.html @@ -1257,6 +1257,318 @@

`button`

Element(s) - `button`; - `button`;
[[WAI-ARIA-1.2]]
Element(s) - `button`; - `button`;
[[WAI-ARIA-1.2]] Comments

- User Agents MUST expose an `aria-details` relation with the associated element except under the following - conditions: + User Agents MUST expose an `aria-details` relation with the associated element except under the following conditions:

  • The element's `command` attribute value is a value other than "`show-popover`" or "`toggle-popover`",
    • From 503a46f9ba34c030727b8fd945d91f502080c8a9 Mon Sep 17 00:00:00 2001 From: Scott O'Hara Date: Thu, 17 Oct 2024 15:00:03 -0400 Subject: [PATCH 03/21] Update html-aam/index.html --- html-aam/index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/html-aam/index.html b/html-aam/index.html index 1312fec1a..21a8303cf 100644 --- a/html-aam/index.html +++ b/html-aam/index.html @@ -9374,7 +9374,7 @@

    `command`

Element(s)`button`;`button`;
[[WAI-ARIA-1.2]]
+

`button` (`command` attribute in the Toggle popover state)

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
HTML Specification + `button` + (`command` attribute in the Toggle popover state) +
[[WAI-ARIA-1.2]] + `button` role. +

+ If the associated element is displayed as a popover: + `aria-expanded=true` +

+

+ If the the associated element is hidden, or not present in the DOM: + `aria-expanded=false` +

+

+ If the the associated element is an accessibility ancestor of the element with the `command` attribute: + `aria-expanded=undefined` +

+
+ MSAA + IAccessible2 + +
Use WAI-ARIA mapping
+
Object attributes: `details-roles:popover`
+
UIA +
Use WAI-ARIA mapping
+
ATK +
Use WAI-ARIA mapping
+
Object attributes: `details-roles:popover`
+
AX +
Use WAI-ARIA mapping
+
Comments +

+ User Agents MUST expose an `aria-details` relation with the associated element except under the following conditions: +

+
    +
  • The associated popover element is the next immediate accessibility sibling to the invoking element,
    • +
  • The element is a descendant of the `popover` it is associated with.
    • + +
+

A button that has a [=button/form owner=] without `type` in the "`button`" state cannot invoke a command.

+
+

`button` (`command` attribute in the Show popover state)

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
HTML Specification + `button` + (`command` attribute in the Show popover state) +
[[WAI-ARIA-1.2]] + `button` role. +

+ If the associated element is displayed as a popover: + `aria-expanded=true` +

+

+ If the the associated element is hidden, or not present in the DOM: + `aria-expanded=false` +

+

+ If the the associated element is an accessibility ancestor of the element with the `command` attribute: + `aria-expanded=undefined` +

+
+ MSAA + IAccessible2 + +
Use WAI-ARIA mapping
+
Object attributes: `details-roles:popover`
+
UIA +
Use WAI-ARIA mapping
+
ATK +
Use WAI-ARIA mapping
+
Object attributes: `details-roles:popover`
+
AX +
Use WAI-ARIA mapping
+
Comments +

User Agents MUST NOT expose an `aria-details` relation with the associated element if the associated popover element is the next immediate accessibility sibling to the invoking element.

+

A button that has a [=button/form owner=] without `type` in the "`button`" state cannot invoke a command.

+
+

`button` (`command` attribute in the Hide popover state)

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
HTML Specification + `button` + (`command` attribute in the Hide popover state) +
[[WAI-ARIA-1.2]] + `button` role. +

+ If the associated element is displayed as a popover: + `aria-expanded=true` +

+

+ If the the associated element is hidden, or not present in the DOM: + `aria-expanded=false` +

+

+ If the the associated element is an accessibility ancestor of the element with the `command` attribute: + `aria-expanded=undefined` +

+
+ MSAA + IAccessible2 + +
Use WAI-ARIA mapping
+
Object attributes: `details-roles:popover`
+
UIA +
Use WAI-ARIA mapping
+
ATK +
Use WAI-ARIA mapping
+
Object attributes: `details-roles:popover`
+
AX +
Use WAI-ARIA mapping
+
Comments +

User Agents MUST NOT expose an `aria-details` relation with the associated element if the associated popover element is the next immediate accessibility sibling to the invoking element.

+

A button that has a [=button/form owner=] without `type` in the "`button`" state cannot invoke a command.

+
+

`button` (`command` attribute in the Close state)

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
HTML Specification + `button` + (`command` attribute in the Close popover state) +
[[WAI-ARIA-1.2]] + `button` role. +

+ If the associated element is an open dialog: + `aria-expanded=true` +

+

+ If the the associated element is hidden, or not present in the DOM: + `aria-expanded=false` +

+

+ If the the associated element is an accessibility ancestor of the element with the `command` attribute: + `aria-expanded=undefined` +

+
+ MSAA + IAccessible2 + +
Use WAI-ARIA mapping
+
UIA +
Use WAI-ARIA mapping
+
ATK +
Use WAI-ARIA mapping
+
AX +
Use WAI-ARIA mapping
+
Comments +

A button that has a [=button/form owner=] without `type` in the "`button`" state cannot invoke a command.

+
+

`button` (`command` attribute in the Show modal state)

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
HTML Specification + `button` + (`command` attribute in the Show modal state) +
[[WAI-ARIA-1.2]]`button` role.
+ MSAA + IAccessible2 + +
Use WAI-ARIA mapping
+
UIA +
Use WAI-ARIA mapping
+
ATK +
Use WAI-ARIA mapping
+
AX +
Use WAI-ARIA mapping
+
Comments +

A button that has a [=button/form owner=] without `type` in the "`button`" state cannot invoke a command.

+

`canvas`

@@ -9365,132 +9677,6 @@

`controls`

-

`command`

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
HTML Specification`command`
Element(s)`button`;
[[WAI-ARIA-1.2]] -
Not mapped
-
- MSAA + IAccessible2 - -
Not mapped
-
UIA -
Not mapped
-
ATK -
Not mapped
-
AX -
Not mapped
-
CommentsThe value of this attribute can impact the mappings of its related `commandfor` attribute.
-

`commandfor`

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
HTML Specification`commandfor`
Element(s)`button`;
[[WAI-ARIA-1.2]] -
-

- If the associated element is displayed as a popover: - `aria-expanded=true` -

-

- If the element with the `commandfor` attribute has a `command` attribute with value of "`show-popover`", or "`toggle-popover`" and the associated element is hidden, or not present - in the DOM: - `aria-expanded=false` -

-

- If the element with the `commandfor` attribute has a `command` attribute with value of "`show-popover`", or "`toggle-popover`", and the associated element is an accessibility - ancestor of the element with the `commandfor` attribute: - `aria-expanded=undefined` -

-
-
- MSAA + IAccessible2 - -
Use WAI-ARIA mapping
-
Object attributes: `details-roles:popover`
-
UIA -
Use WAI-ARIA mapping
-
ATK -
Use WAI-ARIA mapping
-
Object attributes: `details-roles:popover`
-
AX -
Use WAI-ARIA mapping
-
Comments -

- User Agents MUST expose an `aria-details` relation with the associated element except under the following conditions: -

-
    -
  • The element's `command` attribute value is a value other than "`show-popover`" or "`toggle-popover`",
    • -
  • The associated popover element is the next immediate accessibility sibling to the invoking element,
    • -
  • The element's `command` attribute is in the "`toggle-popover`" state and the element is a descendant of the `popover` it is associated with.
    • - -
-

A button that a [=button/form owner=] without `type` in the "`button`" state cannot invoke a command.

-

`coords`

From f94c4c3f578f9467e168897b897273c547fab260 Mon Sep 17 00:00:00 2001 From: Keith Cirkel Date: Fri, 18 Oct 2024 16:15:07 +0100 Subject: [PATCH 05/21] fix typo --- html-aam/index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/html-aam/index.html b/html-aam/index.html index 74bec6ece..81de03abc 100644 --- a/html-aam/index.html +++ b/html-aam/index.html @@ -1466,7 +1466,7 @@

`button` (`command` at

From bf0440a8a1ffc429dcb5eca351558e960b1b2f78 Mon Sep 17 00:00:00 2001 From: Keith Cirkel Date: Fri, 18 Oct 2024 16:41:19 +0100 Subject: [PATCH 06/21] rephrase MUST NOTs to MUST EXCEPT --- html-aam/index.html | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/html-aam/index.html b/html-aam/index.html index 81de03abc..6821aebfd 100644 --- a/html-aam/index.html +++ b/html-aam/index.html @@ -1388,7 +1388,12 @@

`button` (`comma

@@ -1453,7 +1458,12 @@

`button` (`comma

From 733c39e6ee5cefb0a083f38a6a1ee435f2ac0de2 Mon Sep 17 00:00:00 2001 From: Keith Cirkel Date: Wed, 4 Dec 2024 09:45:10 +0000 Subject: [PATCH 07/21] correct note around submit buttons and command attributes --- html-aam/index.html | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/html-aam/index.html b/html-aam/index.html index 6821aebfd..8fa140cbd 100644 --- a/html-aam/index.html +++ b/html-aam/index.html @@ -1324,7 +1324,7 @@

`button` (`com
  • The element is a descendant of the `popover` it is associated with.
    • -

    A button that has a [=button/form owner=] without `type` in the "`button`" state cannot invoke a command.

    +

    A button that represents a submit button with a [=button/form owner=] cannot invoke a command.

     @@ -1394,7 +1394,7 @@

    `button` (`comma
    • The associated popover element is the next immediate accessibility sibling to the invoking element,
    -

    A button that has a [=button/form owner=] without `type` in the "`button`" state cannot invoke a command.

    +

    A button that represents a submit button with a [=button/form owner=] cannot invoke a command.

    @@ -1464,7 +1464,7 @@

    `button` (`comma
    • The associated popover element is the next immediate accessibility sibling to the invoking element,
    -

    A button that has a [=button/form owner=] without `type` in the "`button`" state cannot invoke a command.

    +

    A button that represents a submit button with a [=button/form owner=] cannot invoke a command.

    @@ -1526,7 +1526,7 @@

    `button` (`command` at

    @@ -1574,7 +1574,7 @@

    `button` (`command

    From 683691db58317dcc7ac425e47ff219991f81e93b Mon Sep 17 00:00:00 2001 From: Scott O'Hara Date: Tue, 10 Dec 2024 10:55:32 -0500 Subject: [PATCH 08/21] Consolidate button command popover states taking aaron's feedback, re-combined the popover commands into a single table, since they all should match. similarly, combined the close and show-modal into a single table - as these also should have matched. this means i removed all the extra aria-expanded mappings that were in the close command. but we dont need these. a close button won't exist outside of a modal dialog, since it'd be inert. and we don't need expanded states on the close button, because someone is already within the dialog. --- html-aam/index.html | 219 +++----------------------------------------- 1 file changed, 13 insertions(+), 206 deletions(-) diff --git a/html-aam/index.html b/html-aam/index.html index 8fa140cbd..8be882ece 100644 --- a/html-aam/index.html +++ b/html-aam/index.html @@ -1257,14 +1257,19 @@

    `button`

    HTML Specification `button` - (`command` attribute in the Close popover state) + (`command` attribute in the Close state)
    Comments -

    User Agents MUST NOT expose an `aria-details` relation with the associated element if the associated popover element is the next immediate accessibility sibling to the invoking element.

    +

    User Agents MUST expose an `aria-details` relation with the associated element except under the following + conditions: +

    +
      +
    • The associated popover element is the next immediate accessibility sibling to the invoking element,
      • +

    A button that has a [=button/form owner=] without `type` in the "`button`" state cannot invoke a command.
    Comments -

    User Agents MUST NOT expose an `aria-details` relation with the associated element if the associated popover element is the next immediate accessibility sibling to the invoking element.

    +

    User Agents MUST expose an `aria-details` relation with the associated element except under the following + conditions: +

    +
      +
    • The associated popover element is the next immediate accessibility sibling to the invoking element,
      • +

    A button that has a [=button/form owner=] without `type` in the "`button`" state cannot invoke a command.
    Comments -

    A button that has a [=button/form owner=] without `type` in the "`button`" state cannot invoke a command.

    +

    A button that represents a submit button with a [=button/form owner=] cannot invoke a command.
    Comments -

    A button that has a [=button/form owner=] without `type` in the "`button`" state cannot invoke a command.

    +

    A button that represents a submit button with a [=button/form owner=] cannot invoke a command.
    -

    `button` (`command` attribute in the Toggle popover state)

    - +

    `button` (`command` attribute in the Toggle, Show, and Hide popover states)

    +
    @@ -1329,222 +1334,24 @@

    `button` (`com

    HTML Specification `button` - (`command` attribute in the Toggle popover state) + + (`command` attribute in the + Toggle popover state + Show popover state + Hide popover state) +
    -

    `button` (`command` attribute in the Show popover state)

    - +

    `button` (`command` attribute in the Close and Show Modal states)

    +
    - - - - - - - - - - - - - - - - - - - - - - -
    HTML Specification `button` - (`command` attribute in the Show popover state) + (`command` attribute in the + Close state) + Show Modal state)
    [[WAI-ARIA-1.2]] `button` role. -

    - If the associated element is displayed as a popover: - `aria-expanded=true` -

    -

    - If the the associated element is hidden, or not present in the DOM: - `aria-expanded=false` -

    -

    - If the the associated element is an accessibility ancestor of the element with the `command` attribute: - `aria-expanded=undefined` -

    -
    - MSAA + IAccessible2 - -
    Use WAI-ARIA mapping
    -
    Object attributes: `details-roles:popover`
    -
    UIA -
    Use WAI-ARIA mapping
    -
    ATK -
    Use WAI-ARIA mapping
    -
    Object attributes: `details-roles:popover`
    -
    AX -
    Use WAI-ARIA mapping
    -
    Comments -

    User Agents MUST expose an `aria-details` relation with the associated element except under the following - conditions: -

    -
      -
    • The associated popover element is the next immediate accessibility sibling to the invoking element,
      • -
    -

    A button that represents a submit button with a [=button/form owner=] cannot invoke a command.

    -
    -

    `button` (`command` attribute in the Hide popover state)

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    HTML Specification - `button` - (`command` attribute in the Hide popover state) -
    [[WAI-ARIA-1.2]] - `button` role. -

    - If the associated element is displayed as a popover: - `aria-expanded=true` -

    -

    - If the the associated element is hidden, or not present in the DOM: - `aria-expanded=false` -

    -

    - If the the associated element is an accessibility ancestor of the element with the `command` attribute: - `aria-expanded=undefined` -

    -
    - MSAA + IAccessible2 - -
    Use WAI-ARIA mapping
    -
    Object attributes: `details-roles:popover`
    -
    UIA -
    Use WAI-ARIA mapping
    ATK -
    Use WAI-ARIA mapping
    -
    Object attributes: `details-roles:popover`
    -
    AX -
    Use WAI-ARIA mapping
    -
    Comments -

    User Agents MUST expose an `aria-details` relation with the associated element except under the following - conditions: -

    -
      -
    • The associated popover element is the next immediate accessibility sibling to the invoking element,
      • -
    -

    A button that represents a submit button with a [=button/form owner=] cannot invoke a command.

    -
    -

    `button` (`command` attribute in the Close state)

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    HTML Specification - `button` - (`command` attribute in the Close state) -
    [[WAI-ARIA-1.2]] - `button` role. -

    - If the associated element is an open dialog: - `aria-expanded=true` -

    -

    - If the the associated element is hidden, or not present in the DOM: - `aria-expanded=false` -

    -

    - If the the associated element is an accessibility ancestor of the element with the `command` attribute: - `aria-expanded=undefined` -

    -
    - MSAA + IAccessible2 - -
    Use WAI-ARIA mapping
    -
    UIA -
    Use WAI-ARIA mapping
    -
    ATK -
    Use WAI-ARIA mapping
    -
    AX -
    Use WAI-ARIA mapping
    -
    Comments -

    A button that represents a submit button with a [=button/form owner=] cannot invoke a command.

    -
    -

    `button` (`command` attribute in the Show modal state)

    - - - - - - - - - -
    HTML Specification - `button` - (`command` attribute in the Show modal state) -
    [[WAI-ARIA-1.2]]`button` role.
    MSAA + IAccessible2 From eb740360efea47e09c52e92525537b52eacef18b Mon Sep 17 00:00:00 2001 From: Scott O'Hara Date: Tue, 10 Dec 2024 13:59:47 -0500 Subject: [PATCH 09/21] move command tables to attribute section moves the command tables to the attributes section. otherwise, a new table for command would have been necessary, and it would have then just pointed to these other tables. so, moving them down here negates the need for that. adds the commandfor attribute mapping table --- html-aam/index.html | 197 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 197 insertions(+) diff --git a/html-aam/index.html b/html-aam/index.html index 8be882ece..4b1e9539d 100644 --- a/html-aam/index.html +++ b/html-aam/index.html @@ -9313,6 +9313,203 @@

    `colspan`
    +

    `button` (`command` attribute in the Toggle, Show, and Hide popover states)

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    HTML Specification + + (`command` in the + Toggle popover state + Show popover state and + Hide popover state) + +
    Element(s) + `button` +
    [[WAI-ARIA-1.2]] +

    + If the associated element is displayed as a popover: + `aria-expanded=true` +

    +

    + If the the associated element is hidden, or not present in the DOM: + `aria-expanded=false` +

    +

    + If the the associated element is an accessibility ancestor of the element with the `command` attribute: + `aria-expanded=undefined` +

    +
    + MSAA + IAccessible2 + +
    Use WAI-ARIA mapping
    +
    Object attributes: `details-roles:popover`
    +
    UIA +
    Use WAI-ARIA mapping
    +
    ATK +
    Use WAI-ARIA mapping
    +
    Object attributes: `details-roles:popover`
    +
    AX +
    Use WAI-ARIA mapping
    +
    Comments +

    + User Agents MUST expose an `aria-details` relation with the associated element (identified via the specified `commandfor` attribute) except under the following conditions: +

    +
      +
    • The associated popover element is the next immediate accessibility sibling to the invoking element,
      • +
    • The element is a descendant of the `popover` it is associated with.
      • +
    +

    A button that represents a submit button with a [=button/form owner=] cannot invoke a command.

    +
    +

    `button` (`command` attribute in the Close and Show Modal states)

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    HTML Specification + + (`command` in the + Close state) and + Show Modal state) +
    Element(s) + `button` +
    [[WAI-ARIA-1.2]] +
    + A `command` attribute in the `close` and `show-modal` states provide no additional accessibility mappings to the `button` element. +
    +
    + MSAA + IAccessible2 + +
    Not mapped
    +
    UIA +
    Not mapped
    +
    ATK +
    Not mapped
    +
    AX +
    Not mapped
    +
    Comments +

    A button that represents a submit button with a [=button/form owner=] cannot invoke a command.

    +
    +

    `command`

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    HTML Specification`commandfor`
    Element(s) + `button` +
    [[WAI-ARIA-1.2]] +
    See comments
    +
    + MSAA + IAccessible2 + +
    See comments
    +
    UIA +
    See comments
    +
    ATK +
    See comments
    +
    AX +
    See comments
    +
    Comments +

    The `commandfor` attribute identifies the associated element for the `button` element.

    +

    + The specified `command` will indicate if a mapping needs to be exposed between the `button` and + its programmatically associated element. +

    +

    `content`

    From 86d1225fa27e59ad9a453048d5a3fcf19810e29c Mon Sep 17 00:00:00 2001 From: Scott O'Hara Date: Tue, 10 Dec 2024 14:16:47 -0500 Subject: [PATCH 10/21] fix headings --- html-aam/index.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/html-aam/index.html b/html-aam/index.html index 4b1e9539d..229c6163b 100644 --- a/html-aam/index.html +++ b/html-aam/index.html @@ -9313,7 +9313,7 @@

    `colspan`

    -

    `button` (`command` attribute in the Toggle, Show, and Hide popover states)

    +

    `command` (in the Toggle, Show, and Hide popover states)

    @@ -9393,7 +9393,7 @@

    `button` (`command` attri

    -

    `button` (`command` attribute in the Close and Show Modal states)

    +

    `command` (in the Close and Show Modal states)

    From 793899b6566a3f56ab589733b8925e52543a3b1b Mon Sep 17 00:00:00 2001 From: Scott O'Hara Date: Tue, 10 Dec 2024 14:27:20 -0500 Subject: [PATCH 11/21] fix up attr titling, remove prior role mapping tables --- html-aam/index.html | 152 ++++---------------------------------------- 1 file changed, 12 insertions(+), 140 deletions(-) diff --git a/html-aam/index.html b/html-aam/index.html index 229c6163b..ff15af643 100644 --- a/html-aam/index.html +++ b/html-aam/index.html @@ -1257,135 +1257,6 @@

    `button`
    -

    `button` (`command` attribute in the Toggle, Show, and Hide popover states)

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    HTML Specification - `button` - - (`command` attribute in the - Toggle popover state - Show popover state - Hide popover state) - -
    [[WAI-ARIA-1.2]] - `button` role. -

    - If the associated element is displayed as a popover: - `aria-expanded=true` -

    -

    - If the the associated element is hidden, or not present in the DOM: - `aria-expanded=false` -

    -

    - If the the associated element is an accessibility ancestor of the element with the `command` attribute: - `aria-expanded=undefined` -

    -
    - MSAA + IAccessible2 - -
    Use WAI-ARIA mapping
    -
    Object attributes: `details-roles:popover`
    -
    UIA -
    Use WAI-ARIA mapping
    -
    ATK -
    Use WAI-ARIA mapping
    -
    Object attributes: `details-roles:popover`
    -
    AX -
    Use WAI-ARIA mapping
    -
    Comments -

    - User Agents MUST expose an `aria-details` relation with the associated element except under the following conditions: -

    -
      -
    • The associated popover element is the next immediate accessibility sibling to the invoking element,
      • -
    • The element is a descendant of the `popover` it is associated with.
      • - -
    -

    A button that represents a submit button with a [=button/form owner=] cannot invoke a command.

    -
    -

    `button` (`command` attribute in the Close and Show Modal states)

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    HTML Specification - `button` - (`command` attribute in the - Close state) - Show Modal state) -
    [[WAI-ARIA-1.2]] - `button` role. -
    - MSAA + IAccessible2 - -
    Use WAI-ARIA mapping
    -
    UIA -
    Use WAI-ARIA mapping
    -
    ATK -
    Use WAI-ARIA mapping
    -
    AX -
    Use WAI-ARIA mapping
    -
    Comments -

    A button that represents a submit button with a [=button/form owner=] cannot invoke a command.

    -

    `canvas`

    @@ -9320,17 +9191,18 @@

    `command` (in the Toggle

    @@ -9399,16 +9271,16 @@

    `command` (in the Close a

    @@ -9453,7 +9325,7 @@

    `command` (in the Close a

    HTML Specification - (`command` in the - Toggle popover state - Show popover state and - Hide popover state) + `command`
    Element(s) - `button` + `button` + (`command` in the + Toggle popover state + Show popover state and + Hide popover state)
    HTML Specification - - (`command` in the - Close state) and - Show Modal state) + `command`
    Element(s) - `button` + `button` + (`command` in the + Close state) and + Show Modal state)
    -

    `command`

    +

    `commandfor`

    From ea141518c14865beb1da76cd39147fdbda378e1e Mon Sep 17 00:00:00 2001 From: Scott O'Hara Date: Tue, 10 Dec 2024 14:50:02 -0500 Subject: [PATCH 12/21] Update html-aam/index.html --- html-aam/index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/html-aam/index.html b/html-aam/index.html index ff15af643..0316517de 100644 --- a/html-aam/index.html +++ b/html-aam/index.html @@ -9375,7 +9375,7 @@

    `commandfor`

     From 2483768c72a737b21a85ceb2b959748c6228a814 Mon Sep 17 00:00:00 2001 From: Scott O'Hara Date: Mon, 16 Dec 2024 10:38:37 -0500 Subject: [PATCH 13/21] Update html-aam/index.html Co-authored-by: James Craig --- html-aam/index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/html-aam/index.html b/html-aam/index.html index 0316517de..579c669e7 100644 --- a/html-aam/index.html +++ b/html-aam/index.html @@ -9254,7 +9254,7 @@

    `command` (in the Toggle

    From 43f0357db1273c46df18fd5b3f17f35abc4c6129 Mon Sep 17 00:00:00 2001 From: keithamus Date: Fri, 7 Mar 2025 16:51:40 +0000 Subject: [PATCH 15/21] chore: prettier --- core-aam/index.html | 3 +-- dpub-aria/index.html | 6 ++--- html-aam/index.html | 48 ++++++++++++++++----------------- pdf-aam/index.html | 64 +++++++++++++++++++++----------------------- 4 files changed, 59 insertions(+), 62 deletions(-) diff --git a/core-aam/index.html b/core-aam/index.html index 7923afd10..6b824ba13 100644 --- a/core-aam/index.html +++ b/core-aam/index.html @@ -4363,8 +4363,7 @@ >
    Object Attribute: xml-roles:searchbox
    - Object Attribute: text-input-type:search - + Object Attribute: text-input-type:search
    Interface: EditableText if aria-readonly is not "true"Definition of Roles

    The `commandfor` attribute identifies the associated element for the `button` element.

    - The specified `command` will indicate if a mapping needs to be exposed between the `button` and + The specified `command` state will determine if a relationship mapping needs to be exposed between the `button` and its programmatically associated element.

    		Comments

    - User Agents MUST expose an `aria-details` relation with the associated element (identified via the specified `commandfor` attribute) except under the following conditions: + User Agents MUST expose an `aria-details` relationship with the associated element (identified via the specified `commandfor` attribute) except under the following conditions:

    • The associated popover element is the next immediate accessibility sibling to the invoking element,
      • From a969e1c748ab23a3eb235e31c2f1a5c340a9e9e3 Mon Sep 17 00:00:00 2001 From: Keith Cirkel Date: Fri, 7 Mar 2025 16:51:18 +0000 Subject: [PATCH 14/21] Apply suggestions from code review Co-authored-by: Luke Warlow --- html-aam/index.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/html-aam/index.html b/html-aam/index.html index 82efe72ed..45a747327 100644 --- a/html-aam/index.html +++ b/html-aam/index.html @@ -9301,11 +9301,11 @@

      `command` (in the Toggle `aria-expanded=true`

      - If the the associated element is hidden, or not present in the DOM: + If the associated element is hidden, or not present in the DOM: `aria-expanded=false`

      - If the the associated element is an accessibility ancestor of the element with the `command` attribute: + If the associated element is an accessibility ancestor of the element with the `command` attribute: `aria-expanded=undefined`

    -
    +
    doc-pagelist
    @@ -3616,7 +3616,7 @@

    Definition of Roles

    - +
    doc-part diff --git a/html-aam/index.html b/html-aam/index.html index 45a747327..87a344cf7 100644 --- a/html-aam/index.html +++ b/html-aam/index.html @@ -3178,7 +3178,9 @@

    `img` (`alt` attribute value HTML Specification `img` - (`alt` attribute value is the empty string, i.e., `alt=""` or `alt` with no value in the markup) + (`alt` attribute value is the empty string, i.e., `alt=""` or `alt` with no value in the markup) @@ -3225,9 +3227,8 @@

    `img` (`alt` attribute value Comments

    - If an `img` has an empty `alt`, but has been provided an accessible name - via another valid naming mechanism per the naming steps of this specification, user agents will expose the element - with its implicit `image` role. + If an `img` has an empty `alt`, but has been provided an accessible name via another valid naming mechanism per the + naming steps of this specification, user agents will expose the element with its implicit `image` role.

    @@ -9278,16 +9279,14 @@

    `command` (in the Toggle HTML Specification - - `command` - + `command` Element(s) `button` - (`command` in the + (`command` in the Toggle popover state Show popover state and Hide popover state) @@ -9342,7 +9341,8 @@

    `command` (in the Toggle Comments

    - User Agents MUST expose an `aria-details` relationship with the associated element (identified via the specified `commandfor` attribute) except under the following conditions: + User Agents MUST expose an `aria-details` relationship with the associated element (identified via the specified `commandfor` + attribute) except under the following conditions:

    • The associated popover element is the next immediate accessibility sibling to the invoking element,
      • @@ -9358,25 +9358,22 @@

      `command` (in the Close a HTML Specification - - `command` - + `command` Element(s) `button` - (`command` in the - Close state) and - Show Modal state) + (`command` in the Close state) and + Show Modal state) [[WAI-ARIA-1.2]] -
      - A `command` attribute in the `close` and `show-modal` states provide no additional accessibility mappings to the `button` element. -
      +
      A `command` attribute in the `close` and `show-modal` states provide no additional accessibility mappings to the `button` element.
      @@ -9462,10 +9459,7 @@

      `commandfor`

      Comments

      The `commandfor` attribute identifies the associated element for the `button` element.

      -

      - The specified `command` state will determine if a relationship mapping needs to be exposed between the `button` and - its programmatically associated element. -

      +

      The specified `command` state will determine if a relationship mapping needs to be exposed between the `button` and its programmatically associated element.

      @@ -13654,8 +13648,14 @@

      `popover`

    • when the element has a `popovertargetaction=hide` attribute value,
    • or when the element is a descendant of the `popover` and its `popovertarget` is the "`auto`" state.

    -

    If specified on an element with an implicit role of `generic`, then the element's role instead maps to `group` for all `popover` states.

    -

    There are no unique mappings for the different `popover` states. Any accessibility mapping changes for the popover element would be the responsibility of the author. e.g., using different base HTML elements, attributes, or ARIA attributes to make such changes.

    +

    + If specified on an element with an implicit role of `generic`, then the element's role instead maps to `group` for all + `popover` states. +

    +

    + There are no unique mappings for the different `popover` states. Any accessibility mapping changes for the popover element would be the responsibility of the author. e.g., using + different base HTML elements, attributes, or ARIA attributes to make such changes. +

    diff --git a/pdf-aam/index.html b/pdf-aam/index.html index 3e9fed7b2..6f461b2be 100644 --- a/pdf-aam/index.html +++ b/pdf-aam/index.html @@ -64,8 +64,7 @@ w3cid: "160220", }, ], - formerEditors: [ - ], + formerEditors: [], // authors, add as many as you like. // This is optional, uncomment if you have authors as well as editors. @@ -114,7 +113,6 @@ preProcess: [linkCrossReferences], xref: ["HTML", "core-aam", "dom", "accname", "wai-aria", "infra"], - }; @@ -129,17 +127,15 @@

    The Accessible Rich Internet Applications Working Group seeks feedback on any aspect of the specification. When submitting feedback, please consider issues in the context of the companion - documents. To comment, file an issue in the W3C pdf-aam GitHub repository. If this is - not feasible, send email to public-aria@w3.org (file an issue in the W3C pdf-aam GitHub repository. If this is not + feasible, send email to public-aria@w3.org (comment archive). In-progress updates to the document may be viewed in the publicly visible editors' draft.

    Introduction

    -

    - TBD. Some from Core-AAM. -

    +

    TBD. Some from Core-AAM.

    Accessibility APIs

    TBD. Should we duplicate or cross-reference this content from the corresponding Core-AAM section?

    @@ -157,14 +153,16 @@
    Accessible Names and Descriptions

    RFC-2119 Keywords

    - RFC-2119 keywords are formatted in uppercase and contained in a strong element with class="rfc2119". When the keywords shown above are used, but do not share this format, they do not convey formal information in the RFC 2119 sense, and are merely explanatory, i.e., informative. As much as possible, such usages are avoided in this specification. + RFC-2119 keywords are formatted in uppercase and contained in a strong element with class="rfc2119". When the keywords shown above are used, but do not share this + format, they do not convey formal information in the RFC 2119 sense, and are merely explanatory, i.e., informative. As much as possible, such usages are avoided in this specification.

    Normative and Informative Sections

    The indication whether a section is normative or non-normative (informative) applies to the entire section including sub-sections.

    - Informative sections provide information useful to understanding the specification. Such sections may contain examples of recommended practice, but it is not required to follow such recommendations in order to conform to this specification. + Informative sections provide information useful to understanding the specification. Such sections may contain examples of recommended practice, but it is not required to follow such + recommendations in order to conform to this specification.

    @@ -175,15 +173,11 @@

    Important Terms

    term 1
    -

    - definition 1 -

    +

    definition 1

    term 2
    -

    - definition 2 -

    +

    definition 2

    @@ -192,7 +186,6 @@

    Important Terms

    Mapping WAI-ARIA to Accessibility APIs

    TBD. Should we duplicate or cross-reference this content from the corresponding Core-AAM section?

    -

    Role mapping

    TBD. Should we duplicate or cross-reference this content from the corresponding Core-AAM section?

    @@ -216,20 +209,22 @@

    example

    MSAA + IAccessible2 - Role: ROLE_SYSTEM_EXAMPLE
    - + Role: ROLE_SYSTEM_EXAMPLE
    UIA - Control Type: Example
    + Control Type: Example
    ATK/AT-SPI - Role: ROLE_EXAMPLE
    + Role: ROLE_EXAMPLE
    @@ -237,13 +232,13 @@

    example

    AX API[Note 1] - AXRole: AXxample
    - AXSubrole:
    + AXRole: AXxample
    + AXSubrole:
    -

    @@ -251,7 +246,6 @@

    example

    Footnote content

    -
    @@ -267,7 +261,9 @@

    State and Property Mapping Tables

    Not Mapped

    - There are a number of occurrences in the table where a given state or property is declared "Not mapped". In some cases, this occurs for the default value of the state/property, and is equivalent to its absence. User agents might find it quicker to map the value than check to see if it is the default. For computational efficiency, user agents MAY expose the state or property value if doing so is equivalent to not mapping it. These cases are marked with an asterisk. + There are a number of occurrences in the table where a given state or property is declared "Not mapped". In some cases, this occurs for the default value of the state/property, and is + equivalent to its absence. User agents might find it quicker to map the value than check to see if it is the default. For computational efficiency, user agents MAY expose the state or + property value if doing so is equivalent to not mapping it. These cases are marked with an asterisk.

    In other cases, it is mandatory that the state/property not be mapped, since exposing it implies a related affordance. An example is @@ -275,7 +271,7 @@

    Not Mapped

    >. Its absence not only indicates that the accessible object is not grabbed, but further defines it as not grab-able. These cases are marked as "Not mapped" without an asterisk.

    - +

    aria-example=true

    @@ -289,30 +285,33 @@

    aria-example=true

    MSAA + IAccessible2 - Object Attribute: example: true
    + Object Attribute: example: true
    UIA - Property: example: true
    + Property: example: true
    ATK/AT-SPI - Object Attribute: example:true
    + Object Attribute: example:true
    AX API - Property: AXExample: YES
    + Property: AXExample: YES
    -
    @@ -322,7 +321,6 @@

    Special Processing Requiring Additional Computation

    Actions

    TBD. Should we duplicate or cross-reference this content from the corresponding Core-AAM section?

    -
    From d379824d3a6bf1252799b0986b214ac23aaabb56 Mon Sep 17 00:00:00 2001 From: Scott O'Hara Date: Fri, 7 Mar 2025 13:10:16 -0500 Subject: [PATCH 16/21] update mappings per feedback from luke/james --- html-aam/index.html | 18 ++++++++++++------ 1 file changed, 12 insertions(+), 6 deletions(-) diff --git a/html-aam/index.html b/html-aam/index.html index 0cc06161b..fc7d0b2db 100644 --- a/html-aam/index.html +++ b/html-aam/index.html @@ -9297,13 +9297,16 @@

    `command` (in the Toggle `aria-expanded=true`

    - If the associated element is hidden, or not present in the DOM: + If the associated element is hidden: `aria-expanded=false`

    - If the associated element is an accessibility ancestor of the element with the `command` attribute: + If the associated element is an accessibility ancestor of the element with the `command` attribute or is not present in the DOM: `aria-expanded=undefined`

    +

    + If the associated element is not a valid `popover` element: no `aria-expanded` mapping. +

    @@ -9345,7 +9348,7 @@

    `command` (in the Toggle
  • The associated popover element is the next immediate accessibility sibling to the invoking element,
  • The element is a descendant of the `popover` it is associated with.
    • -

    A button that represents a submit button with a [=button/form owner=] cannot invoke a command.

    +

    A button that represents a submit button or is in the reset state with a [=button/form owner=] cannot invoke a command.

    @@ -13632,7 +13635,7 @@

    `popover`

    AX - Not mapped + TBD @@ -13680,13 +13683,16 @@

    `popovertarget`

    `aria-expanded=true`

    - If the associated element is hidden, or not present in the DOM: + If the associated element is hidden: `aria-expanded=false`

    - If the associated element is an accessibility ancestor of the element with the `popovertarget` attribute: + If the associated element is an accessibility ancestor of the element with the `command` attribute or is not present in the DOM: `aria-expanded=undefined`

    +

    + If the associated element is not a valid `popover` element: no `aria-expanded` mapping. +

    From 410a008c8610fc35db80b56565da91ec7d07ae4f Mon Sep 17 00:00:00 2001 From: scottaohara Date: Fri, 7 Mar 2025 18:10:38 +0000 Subject: [PATCH 17/21] chore: prettier --- html-aam/index.html | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/html-aam/index.html b/html-aam/index.html index fc7d0b2db..4030e11eb 100644 --- a/html-aam/index.html +++ b/html-aam/index.html @@ -9304,9 +9304,7 @@

    `command` (in the Toggle If the associated element is an accessibility ancestor of the element with the `command` attribute or is not present in the DOM: `aria-expanded=undefined`

    -

    - If the associated element is not a valid `popover` element: no `aria-expanded` mapping. -

    +

    If the associated element is not a valid `popover` element: no `aria-expanded` mapping.

    @@ -9348,7 +9346,10 @@

    `command` (in the Toggle
  • The associated popover element is the next immediate accessibility sibling to the invoking element,
  • The element is a descendant of the `popover` it is associated with.
    • -

    A button that represents a submit button or is in the reset state with a [=button/form owner=] cannot invoke a command.

    +

    + A button that represents a submit button or is in the + reset state with a [=button/form owner=] cannot invoke a command. +

    @@ -13690,9 +13691,7 @@

    `popovertarget`

    If the associated element is an accessibility ancestor of the element with the `command` attribute or is not present in the DOM: `aria-expanded=undefined`

    -

    - If the associated element is not a valid `popover` element: no `aria-expanded` mapping. -

    +

    If the associated element is not a valid `popover` element: no `aria-expanded` mapping.

    From cbe8916748cb1bda119ce75f2550f236233802ba Mon Sep 17 00:00:00 2001 From: Keith Cirkel Date: Mon, 10 Mar 2025 10:27:31 +0000 Subject: [PATCH 18/21] Add `class=data` to tables Co-authored-by: Peter Krautzberger --- html-aam/index.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/html-aam/index.html b/html-aam/index.html index 4030e11eb..8028d05ef 100644 --- a/html-aam/index.html +++ b/html-aam/index.html @@ -9271,7 +9271,7 @@

    `colspan`

    `command` (in the Toggle, Show, and Hide popover states)

    - +
    @@ -9355,7 +9355,7 @@

    `command` (in the Toggle

    HTML Specification

    `command` (in the Close and Show Modal states)

    - +
    From 5cf0bfede3c24820b50daff328236c9d65248b16 Mon Sep 17 00:00:00 2001 From: keithamus Date: Mon, 10 Mar 2025 10:28:32 +0000 Subject: [PATCH 19/21] chore: prettier --- accname/index.html | 4 ++-- index.html | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/accname/index.html b/accname/index.html index c9f9aedd1..7e5e70ec5 100644 --- a/accname/index.html +++ b/accname/index.html @@ -597,8 +597,8 @@

    Computation steps

  • - AriaLabel: Otherwise, if the current node is not a [=slot=] element and has an aria-label [=attribute=] - whose value is not undefined, not the empty string, nor, when trimmed of [=ascii whitespace|whitespace=], is not the empty string: + AriaLabel: Otherwise, if the current node is not a [=slot=] element and has an + aria-label [=attribute=] whose value is not undefined, not the empty string, nor, when trimmed of [=ascii whitespace|whitespace=], is not the empty string:
    1. If traversal of the current node is due to recursion and the current node is an embedded control, ignore aria-label and diff --git a/index.html b/index.html index de3cd2fed..4a6a9186b 100644 --- a/index.html +++ b/index.html @@ -8521,8 +8521,8 @@
      Presentational Role Inheritance
    2. If aria-valuemax is missing or not a number, it defaults to 100.

      3. - Authors MUST set the aria-valuenow attribute to indicate the current thumb position. If aria-valuenow is missing or has an unexpected value, user agents MAY implement the - repair techniques specified in the section describing handling author errors in states and properties, which are equivalent to the repair + Authors MUST set the aria-valuenow attribute to indicate the current thumb position. If aria-valuenow is missing or has an unexpected value, user agents MAY implement + the repair techniques specified in the section describing handling author errors in states and properties, which are equivalent to the repair techniques for <input type="[^input/type/range^]"> in HTML.

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

      From 127839a5cce9691b98e0644d14baa35f1c30d142 Mon Sep 17 00:00:00 2001 From: scottaohara Date: Thu, 13 Mar 2025 17:22:20 +0000 Subject: [PATCH 20/21] chore: prettier --- accname/index.html | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/accname/index.html b/accname/index.html index a685deaad..2c020a2aa 100644 --- a/accname/index.html +++ b/accname/index.html @@ -628,7 +628,8 @@

      Computation steps

    3. Host Language Label: Otherwise, if the current node's native markup provides an [=attribute=] (e.g. alt) or [=element=] (e.g. HTML label or SVG title) that defines a text alternative, return that alternative in the form of - a flat string as defined by the host language, unless the current node is exposed as presentational (role="presentation" or role="none"). + a flat string as defined by the host language, unless the current node is exposed as presentational (role="presentation" or + role="none").
      See HTML-AAM, SVG-AAM, or other host language documentation for more information on markup that defines a text alternative. From 881654a3d41c22eef26c60c70523fed5517daf77 Mon Sep 17 00:00:00 2001 From: Scott O'Hara Date: Fri, 14 Mar 2025 10:04:37 -0400 Subject: [PATCH 21/21] Update accname/index.html Co-authored-by: James Craig --- accname/index.html | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/accname/index.html b/accname/index.html index 2c020a2aa..92f6d616f 100644 --- a/accname/index.html +++ b/accname/index.html @@ -628,8 +628,7 @@

      Computation steps

    4. Host Language Label: Otherwise, if the current node's native markup provides an [=attribute=] (e.g. alt) or [=element=] (e.g. HTML label or SVG title) that defines a text alternative, return that alternative in the form of - a flat string as defined by the host language, unless the current node is exposed as presentational (role="presentation" or - role="none"). + a flat string as defined by the host language, unless the current node is exposed as presentational (role="none").
      See HTML-AAM, SVG-AAM, or other host language documentation for more information on markup that defines a text alternative.
    • HTML Specification