From ae5906adf0827080b9e301408d1ed489bba854ba Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Wed, 11 Dec 2019 17:23:15 -0500 Subject: [PATCH 01/17] Add aria-description Closes issue #891 --- index.html | 49 ++++++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 46 insertions(+), 3 deletions(-) diff --git a/index.html b/index.html index 8b1b896d4..f9c4990e1 100644 --- a/index.html +++ b/index.html @@ -10711,7 +10711,47 @@

Definitions of States and Properties (all aria-* attributes)

-
+
+ aria-description +
+

Defines a string value that describes or annotates the current element. See related aria-describedby.

+

The aria-description attribute is similar to the aria-label in that both profide a flat string to associate with the element, but a label should be concise, where a description is intended to provide more verbose information.

+

The purpose of aria-description is the same as that of aria-describedby. It provides the user with additional descriptive text for the object. The most common accessibility API mapping for a description is the accessible description property.

+

If the description text is visible on screen, authors SHOULD NOT use aria-description.

+
    +
  • Authors SHOULD use aria-details when the description or annotation is large, complex or has useful semantics or structure. Using aria-details will allow assistive technology users to visit the structured content and provide additional navigation commands within the content.
    • +
  • Authors SHOULD use aria-describedby when the desription or annotation is very small and simple, and is best experienced as a flat string.
    • +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + +
Characteristics:
CharacteristicValue
Related Concepts:title attribute in [[HTML]]
Used in Roles:All elements of the base markup except for some roles or elements that prohibit its use
Inherits into Roles:Placeholder
Value:string
+
+
aria-details

Identifies the element that provides a detailed, extended description for the object. See related aria-describedby.

@@ -11375,7 +11415,7 @@

Definitions of States and Properties (all aria-* attributes)

Related Concepts: - title attribute in [[HTML]] + Used in Roles: @@ -11395,7 +11435,7 @@

Definitions of States and Properties (all aria-* attributes)

aria-labelledby
-

Identifies the element (or elements) that labels the current element. See related aria-describedby.

+

Identifies the element (or elements) that labels the current element. See related aria-label and aria-describedby.

The purpose of aria-labelledby is the same as that of aria-label. It provides the user with a recognizable name of the object. The most common accessibility API mapping for a label is the accessible name property.

If the interface is such that it is not possible to have a visible label on the screen, authors SHOULD use aria-label and SHOULD NOT use aria-labelledby. As required by the accessible name and description computation, user agents give precedence to aria-labelledby over aria-label when computing the accessible name property.

The aria-labelledby attribute is similar to aria-describedby in that both reference other elements to calculate a text alternative, but a label should be concise, where a description is intended to provide more verbose information.

@@ -12898,6 +12938,7 @@

Conflicts with Host Language Semantics

Certain ARIA features are critical to building a complete model in the accessibility API. Such features are not expected to conflict with native host language semantics (though they may complement them). Therefore, host languages MUST NOT declare strong native semantics that prevent use of the following ARIA features:

  • aria-describedby
    • +
  • aria-description
  • aria-label
  • aria-labelledby
@@ -13124,6 +13165,7 @@

Interface Mixin AriaAttributes

attribute DOMString? ariaColSpan; attribute FrozenArray<Element>? ariaControlsElements; attribute DOMString? ariaCurrent; + attribute DOMString? ariaDescription; attribute FrozenArray<Element>? ariaDescribedByElements; attribute Element? ariaDetailsElement; attribute DOMString? ariaDisabled; @@ -13180,6 +13222,7 @@

ARIA Attribute Reflection

ariaColSpanaria-colspan ariaControlsElementsaria-controls ariaCurrentaria-current + ariaDescriptionaria-description ariaDescribedByElementsaria-describedby ariaDetailsElementaria-details ariaDisabledaria-disabled From 277ce84798d30d9806bdd2e52d3f9717a241952c Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Fri, 20 Dec 2019 13:11:35 -0500 Subject: [PATCH 02/17] Update index.html Co-Authored-By: Diane Ko --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index f9c4990e1..1d4d42c19 100644 --- a/index.html +++ b/index.html @@ -10715,7 +10715,7 @@

Definitions of States and Properties (all aria-* attributes)

aria-description

Defines a string value that describes or annotates the current element. See related aria-describedby.

-

The aria-description attribute is similar to the aria-label in that both profide a flat string to associate with the element, but a label should be concise, where a description is intended to provide more verbose information.

+

The aria-description attribute is similar to the aria-label in that both provide a flat string to associate with the element, but a label should be concise, where a description is intended to provide more verbose information.

The purpose of aria-description is the same as that of aria-describedby. It provides the user with additional descriptive text for the object. The most common accessibility API mapping for a description is the accessible description property.

If the description text is visible on screen, authors SHOULD NOT use aria-description.

    From fef0cfffd32ade6e60ec5e666e977a716af5538b Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Fri, 20 Dec 2019 13:24:09 -0500 Subject: [PATCH 03/17] Clarify --- index.html | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/index.html b/index.html index f9c4990e1..2cd9d1955 100644 --- a/index.html +++ b/index.html @@ -10717,10 +10717,10 @@

    Definitions of States and Properties (all aria-* attributes)

    Defines a string value that describes or annotates the current element. See related aria-describedby.

    The aria-description attribute is similar to the aria-label in that both profide a flat string to associate with the element, but a label should be concise, where a description is intended to provide more verbose information.

    The purpose of aria-description is the same as that of aria-describedby. It provides the user with additional descriptive text for the object. The most common accessibility API mapping for a description is the accessible description property.

    -

    If the description text is visible on screen, authors SHOULD NOT use aria-description.

    +

    If the description text is available in the content, authors SHOULD NOT use aria-description, but should use one of the following instead:

      -
    • Authors SHOULD use aria-details when the description or annotation is large, complex or has useful semantics or structure. Using aria-details will allow assistive technology users to visit the structured content and provide additional navigation commands within the content.
      • -
    • Authors SHOULD use aria-describedby when the desription or annotation is very small and simple, and is best experienced as a flat string.
      • +
    • Authors SHOULD use aria-describedby when the related description or annotation elements are hidden, or contain a simple, small description that is best experienced as a flat string, rather than by having the user navigate to them.
      • +
    • Authors SHOULD use aria-details when the related description or annotation elements contain useful semantics or structure, or there is a lot of content within them, making it difficult to experience as a flat string. Using aria-details will allow assistive technology users to visit the structured content and provide additional navigation commands, making it easier to understand the structure, or to experience the information in smaller pieces.
From fb818b3efedbc71cae106b33b817ad6b796f4313 Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Wed, 11 Dec 2019 17:23:15 -0500 Subject: [PATCH 04/17] Add aria-description Closes issue #891 --- index.html | 49 ++++++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 46 insertions(+), 3 deletions(-) diff --git a/index.html b/index.html index 8b1b896d4..f9c4990e1 100644 --- a/index.html +++ b/index.html @@ -10711,7 +10711,47 @@

Definitions of States and Properties (all aria-* attributes)

-
+
+ aria-description +
+

Defines a string value that describes or annotates the current element. See related aria-describedby.

+

The aria-description attribute is similar to the aria-label in that both profide a flat string to associate with the element, but a label should be concise, where a description is intended to provide more verbose information.

+

The purpose of aria-description is the same as that of aria-describedby. It provides the user with additional descriptive text for the object. The most common accessibility API mapping for a description is the accessible description property.

+

If the description text is visible on screen, authors SHOULD NOT use aria-description.

+
    +
  • Authors SHOULD use aria-details when the description or annotation is large, complex or has useful semantics or structure. Using aria-details will allow assistive technology users to visit the structured content and provide additional navigation commands within the content.
    • +
  • Authors SHOULD use aria-describedby when the desription or annotation is very small and simple, and is best experienced as a flat string.
    • +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + +
Characteristics:
CharacteristicValue
Related Concepts:title attribute in [[HTML]]
Used in Roles:All elements of the base markup except for some roles or elements that prohibit its use
Inherits into Roles:Placeholder
Value:string
+
+
aria-details

Identifies the element that provides a detailed, extended description for the object. See related aria-describedby.

@@ -11375,7 +11415,7 @@

Definitions of States and Properties (all aria-* attributes)

Related Concepts: - title attribute in [[HTML]] + Used in Roles: @@ -11395,7 +11435,7 @@

Definitions of States and Properties (all aria-* attributes)

aria-labelledby
-

Identifies the element (or elements) that labels the current element. See related aria-describedby.

+

Identifies the element (or elements) that labels the current element. See related aria-label and aria-describedby.

The purpose of aria-labelledby is the same as that of aria-label. It provides the user with a recognizable name of the object. The most common accessibility API mapping for a label is the accessible name property.

If the interface is such that it is not possible to have a visible label on the screen, authors SHOULD use aria-label and SHOULD NOT use aria-labelledby. As required by the accessible name and description computation, user agents give precedence to aria-labelledby over aria-label when computing the accessible name property.

The aria-labelledby attribute is similar to aria-describedby in that both reference other elements to calculate a text alternative, but a label should be concise, where a description is intended to provide more verbose information.

@@ -12898,6 +12938,7 @@

Conflicts with Host Language Semantics

Certain ARIA features are critical to building a complete model in the accessibility API. Such features are not expected to conflict with native host language semantics (though they may complement them). Therefore, host languages MUST NOT declare strong native semantics that prevent use of the following ARIA features:

  • aria-describedby
    • +
  • aria-description
  • aria-label
  • aria-labelledby
@@ -13124,6 +13165,7 @@

Interface Mixin AriaAttributes

attribute DOMString? ariaColSpan; attribute FrozenArray<Element>? ariaControlsElements; attribute DOMString? ariaCurrent; + attribute DOMString? ariaDescription; attribute FrozenArray<Element>? ariaDescribedByElements; attribute Element? ariaDetailsElement; attribute DOMString? ariaDisabled; @@ -13180,6 +13222,7 @@

ARIA Attribute Reflection

ariaColSpanaria-colspan ariaControlsElementsaria-controls ariaCurrentaria-current + ariaDescriptionaria-description ariaDescribedByElementsaria-describedby ariaDetailsElementaria-details ariaDisabledaria-disabled From f64925b9643e45ac3f030eeb2e3f7884299a25c9 Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Fri, 20 Dec 2019 13:24:09 -0500 Subject: [PATCH 05/17] Clarify --- index.html | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/index.html b/index.html index f9c4990e1..2cd9d1955 100644 --- a/index.html +++ b/index.html @@ -10717,10 +10717,10 @@

Definitions of States and Properties (all aria-* attributes)

Defines a string value that describes or annotates the current element. See related aria-describedby.

The aria-description attribute is similar to the aria-label in that both profide a flat string to associate with the element, but a label should be concise, where a description is intended to provide more verbose information.

The purpose of aria-description is the same as that of aria-describedby. It provides the user with additional descriptive text for the object. The most common accessibility API mapping for a description is the accessible description property.

-

If the description text is visible on screen, authors SHOULD NOT use aria-description.

+

If the description text is available in the content, authors SHOULD NOT use aria-description, but should use one of the following instead:

    -
  • Authors SHOULD use aria-details when the description or annotation is large, complex or has useful semantics or structure. Using aria-details will allow assistive technology users to visit the structured content and provide additional navigation commands within the content.
    • -
  • Authors SHOULD use aria-describedby when the desription or annotation is very small and simple, and is best experienced as a flat string.
    • +
  • Authors SHOULD use aria-describedby when the related description or annotation elements are hidden, or contain a simple, small description that is best experienced as a flat string, rather than by having the user navigate to them.
    • +
  • Authors SHOULD use aria-details when the related description or annotation elements contain useful semantics or structure, or there is a lot of content within them, making it difficult to experience as a flat string. Using aria-details will allow assistive technology users to visit the structured content and provide additional navigation commands, making it easier to understand the structure, or to experience the information in smaller pieces.
From 0e3cd23ba354c205ec1f485eecf126f8dfb71150 Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Fri, 20 Dec 2019 13:11:35 -0500 Subject: [PATCH 06/17] Update index.html Co-Authored-By: Diane Ko --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 2cd9d1955..7a604fae2 100644 --- a/index.html +++ b/index.html @@ -10715,7 +10715,7 @@

Definitions of States and Properties (all aria-* attributes)

aria-description

Defines a string value that describes or annotates the current element. See related aria-describedby.

-

The aria-description attribute is similar to the aria-label in that both profide a flat string to associate with the element, but a label should be concise, where a description is intended to provide more verbose information.

+

The aria-description attribute is similar to the aria-label in that both provide a flat string to associate with the element, but a label should be concise, where a description is intended to provide more verbose information.

The purpose of aria-description is the same as that of aria-describedby. It provides the user with additional descriptive text for the object. The most common accessibility API mapping for a description is the accessible description property.

If the description text is available in the content, authors SHOULD NOT use aria-description, but should use one of the following instead:

    From 12114e166651f4bcd23771e50e17471bebefe472 Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Mon, 6 Jan 2020 16:14:22 -0500 Subject: [PATCH 07/17] Add precedence info --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 7a604fae2..eb109c610 100644 --- a/index.html +++ b/index.html @@ -10716,7 +10716,7 @@

    Definitions of States and Properties (all aria-* attributes)

    Defines a string value that describes or annotates the current element. See related aria-describedby.

    The aria-description attribute is similar to the aria-label in that both provide a flat string to associate with the element, but a label should be concise, where a description is intended to provide more verbose information.

    -

    The purpose of aria-description is the same as that of aria-describedby. It provides the user with additional descriptive text for the object. The most common accessibility API mapping for a description is the accessible description property.

    +

    The purpose of aria-description is the same as that of aria-describedby. It provides the user with additional descriptive text for the object. The most common accessibility API mapping for a description is the accessible description property. User agents must give precedence to aria-describedby over aria-description when computing the accessible description property.

    If the description text is available in the content, authors SHOULD NOT use aria-description, but should use one of the following instead:

    • Authors SHOULD use aria-describedby when the related description or annotation elements are hidden, or contain a simple, small description that is best experienced as a flat string, rather than by having the user navigate to them.
      • From 00fba2999ea02aafbfa2324bc87cf2a117bf31b5 Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Mon, 6 Jan 2020 16:54:32 -0500 Subject: [PATCH 08/17] Say DOM --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index eb109c610..81a96a51d 100644 --- a/index.html +++ b/index.html @@ -10717,7 +10717,7 @@

      Definitions of States and Properties (all aria-* attributes)

      Defines a string value that describes or annotates the current element. See related aria-describedby.

      The aria-description attribute is similar to the aria-label in that both provide a flat string to associate with the element, but a label should be concise, where a description is intended to provide more verbose information.

      The purpose of aria-description is the same as that of aria-describedby. It provides the user with additional descriptive text for the object. The most common accessibility API mapping for a description is the accessible description property. User agents must give precedence to aria-describedby over aria-description when computing the accessible description property.

      -

      If the description text is available in the content, authors SHOULD NOT use aria-description, but should use one of the following instead:

      +

      If the description text is available in the DOM, authors SHOULD NOT use aria-description, but should use one of the following instead:

      • Authors SHOULD use aria-describedby when the related description or annotation elements are hidden, or contain a simple, small description that is best experienced as a flat string, rather than by having the user navigate to them.
      • Authors SHOULD use aria-details when the related description or annotation elements contain useful semantics or structure, or there is a lot of content within them, making it difficult to experience as a flat string. Using aria-details will allow assistive technology users to visit the structured content and provide additional navigation commands, making it easier to understand the structure, or to experience the information in smaller pieces.
        • From 2c88718f548fdd7183aa1d269df7eec9ac3ea1f4 Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Tue, 7 Jan 2020 12:03:49 -0500 Subject: [PATCH 09/17] Remove confusing info about hidden description in DOM, since it isn't a significant use case anymore --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 81a96a51d..ecea17cdb 100644 --- a/index.html +++ b/index.html @@ -10719,7 +10719,7 @@

        Definitions of States and Properties (all aria-* attributes)

        The purpose of aria-description is the same as that of aria-describedby. It provides the user with additional descriptive text for the object. The most common accessibility API mapping for a description is the accessible description property. User agents must give precedence to aria-describedby over aria-description when computing the accessible description property.

        If the description text is available in the DOM, authors SHOULD NOT use aria-description, but should use one of the following instead:

          -
        • Authors SHOULD use aria-describedby when the related description or annotation elements are hidden, or contain a simple, small description that is best experienced as a flat string, rather than by having the user navigate to them.
          • +
        • Authors SHOULD use aria-describedby when the related description or annotation elements contain a simple, small description that is best experienced as a flat string, rather than by having the user navigate to them.
        • Authors SHOULD use aria-details when the related description or annotation elements contain useful semantics or structure, or there is a lot of content within them, making it difficult to experience as a flat string. Using aria-details will allow assistive technology users to visit the structured content and provide additional navigation commands, making it easier to understand the structure, or to experience the information in smaller pieces.
    From 7d68704d9fd594f8948b58efe452de06f4c5a25c Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Thu, 9 Jan 2020 12:45:53 -0500 Subject: [PATCH 10/17] Update index.html Co-Authored-By: Carolyn MacLeod --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index ecea17cdb..ff2b39a61 100644 --- a/index.html +++ b/index.html @@ -10715,7 +10715,7 @@

    Definitions of States and Properties (all aria-* attributes)

    aria-description

    Defines a string value that describes or annotates the current element. See related aria-describedby.

    -

    The aria-description attribute is similar to the aria-label in that both provide a flat string to associate with the element, but a label should be concise, where a description is intended to provide more verbose information.

    +

    The aria-description attribute is similar to aria-label in that both provide a flat string to associate with the element, but a label should be concise, whereas a description is intended to provide more verbose information.

    The purpose of aria-description is the same as that of aria-describedby. It provides the user with additional descriptive text for the object. The most common accessibility API mapping for a description is the accessible description property. User agents must give precedence to aria-describedby over aria-description when computing the accessible description property.

    If the description text is available in the DOM, authors SHOULD NOT use aria-description, but should use one of the following instead:

      From c7113b67951bfa52f2e2d26ce9936f652db5ea06 Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Thu, 9 Jan 2020 14:26:01 -0500 Subject: [PATCH 11/17] Use word visible --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index ecea17cdb..2299840e4 100644 --- a/index.html +++ b/index.html @@ -10717,7 +10717,7 @@

      Definitions of States and Properties (all aria-* attributes)

      Defines a string value that describes or annotates the current element. See related aria-describedby.

      The aria-description attribute is similar to the aria-label in that both provide a flat string to associate with the element, but a label should be concise, where a description is intended to provide more verbose information.

      The purpose of aria-description is the same as that of aria-describedby. It provides the user with additional descriptive text for the object. The most common accessibility API mapping for a description is the accessible description property. User agents must give precedence to aria-describedby over aria-description when computing the accessible description property.

      -

      If the description text is available in the DOM, authors SHOULD NOT use aria-description, but should use one of the following instead:

      +

      If the description text is visible in the page, authors SHOULD NOT use aria-description, but should use one of the following instead:

      • Authors SHOULD use aria-describedby when the related description or annotation elements contain a simple, small description that is best experienced as a flat string, rather than by having the user navigate to them.
      • Authors SHOULD use aria-details when the related description or annotation elements contain useful semantics or structure, or there is a lot of content within them, making it difficult to experience as a flat string. Using aria-details will allow assistive technology users to visit the structured content and provide additional navigation commands, making it easier to understand the structure, or to experience the information in smaller pieces.
        • From 1a4eb7dd1c047c24eb82a35e7efeac866a5f9052 Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Thu, 9 Jan 2020 16:17:55 -0500 Subject: [PATCH 12/17] Update index.html Co-Authored-By: Carolyn MacLeod --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index bf61919db..1118874aa 100644 --- a/index.html +++ b/index.html @@ -10716,7 +10716,7 @@

        Definitions of States and Properties (all aria-* attributes)

        Defines a string value that describes or annotates the current element. See related aria-describedby.

        The aria-description attribute is similar to aria-label in that both provide a flat string to associate with the element, but a label should be concise, whereas a description is intended to provide more verbose information.

        -

        The purpose of aria-description is the same as that of aria-describedby. It provides the user with additional descriptive text for the object. The most common accessibility API mapping for a description is the accessible description property. User agents must give precedence to aria-describedby over aria-description when computing the accessible description property.

        +

        The purpose of aria-description is the same as that of aria-describedby. It provides the user with additional descriptive text for the object. The most common accessibility API mapping for a description is the accessible description property. User agents MUST give precedence to aria-describedby over aria-description when computing the accessible description property.

        If the description text is visible in the page, authors SHOULD NOT use aria-description, but should use one of the following instead:

        • Authors SHOULD use aria-describedby when the related description or annotation elements contain a simple, small description that is best experienced as a flat string, rather than by having the user navigate to them.
          • From a8cd90a138f07fc99753d93a6f9fafc74f64aaaf Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Fri, 10 Jan 2020 11:47:27 -0500 Subject: [PATCH 13/17] Improvements from carmacleod --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 1118874aa..f4dfd0308 100644 --- a/index.html +++ b/index.html @@ -10717,7 +10717,7 @@

          Definitions of States and Properties (all aria-* attributes)

          Defines a string value that describes or annotates the current element. See related aria-describedby.

          The aria-description attribute is similar to aria-label in that both provide a flat string to associate with the element, but a label should be concise, whereas a description is intended to provide more verbose information.

          The purpose of aria-description is the same as that of aria-describedby. It provides the user with additional descriptive text for the object. The most common accessibility API mapping for a description is the accessible description property. User agents MUST give precedence to aria-describedby over aria-description when computing the accessible description property.

          -

          If the description text is visible in the page, authors SHOULD NOT use aria-description, but should use one of the following instead:

          +

          In cases where providing a visible description is not the desired user experience, authors MAY set the accessible description of the element using aria-description. However, if the description text is available in the DOM, authors SHOULD NOT use aria-description, but should use one of the following instead:

          • Authors SHOULD use aria-describedby when the related description or annotation elements contain a simple, small description that is best experienced as a flat string, rather than by having the user navigate to them.
          • Authors SHOULD use aria-details when the related description or annotation elements contain useful semantics or structure, or there is a lot of content within them, making it difficult to experience as a flat string. Using aria-details will allow assistive technology users to visit the structured content and provide additional navigation commands, making it easier to understand the structure, or to experience the information in smaller pieces.
            • From a9fad1906ecb7e14f652b653a129835c4fb902a4 Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Fri, 10 Jan 2020 17:19:19 -0500 Subject: [PATCH 14/17] Update index.html Co-Authored-By: Carolyn MacLeod --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index f4dfd0308..f1bc2209e 100644 --- a/index.html +++ b/index.html @@ -10717,7 +10717,7 @@

            Definitions of States and Properties (all aria-* attributes)

            Defines a string value that describes or annotates the current element. See related aria-describedby.

            The aria-description attribute is similar to aria-label in that both provide a flat string to associate with the element, but a label should be concise, whereas a description is intended to provide more verbose information.

            The purpose of aria-description is the same as that of aria-describedby. It provides the user with additional descriptive text for the object. The most common accessibility API mapping for a description is the accessible description property. User agents MUST give precedence to aria-describedby over aria-description when computing the accessible description property.

            -

            In cases where providing a visible description is not the desired user experience, authors MAY set the accessible description of the element using aria-description. However, if the description text is available in the DOM, authors SHOULD NOT use aria-description, but should use one of the following instead:

            +

            In cases where providing a visible description is not the desired user experience, authors MAY set the accessible description of the element using aria-description. However, if the description text is available in the DOM, authors SHOULD NOT use aria-description, but should use one of the following instead:

            • Authors SHOULD use aria-describedby when the related description or annotation elements contain a simple, small description that is best experienced as a flat string, rather than by having the user navigate to them.
            • Authors SHOULD use aria-details when the related description or annotation elements contain useful semantics or structure, or there is a lot of content within them, making it difficult to experience as a flat string. Using aria-details will allow assistive technology users to visit the structured content and provide additional navigation commands, making it easier to understand the structure, or to experience the information in smaller pieces.
              • From e94818bbbb041fc37d3afb792c475864503d52f1 Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Tue, 14 Jan 2020 12:03:23 -0500 Subject: [PATCH 15/17] Correctly alphabetized --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index f4dfd0308..d9cf7fe32 100644 --- a/index.html +++ b/index.html @@ -13165,8 +13165,8 @@

              Interface Mixin AriaAttributes

              attribute DOMString? ariaColSpan; attribute FrozenArray<Element>? ariaControlsElements; attribute DOMString? ariaCurrent; - attribute DOMString? ariaDescription; attribute FrozenArray<Element>? ariaDescribedByElements; + attribute DOMString? ariaDescription; attribute Element? ariaDetailsElement; attribute DOMString? ariaDisabled; attribute Element? ariaErrorMessageElement; From 94082f562f107c59e26706abfef3c4a7eefd332e Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Tue, 14 Jan 2020 12:03:47 -0500 Subject: [PATCH 16/17] Correctly alphabetized --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index d9cf7fe32..5efc5f934 100644 --- a/index.html +++ b/index.html @@ -13222,8 +13222,8 @@

              ARIA Attribute Reflection

 - + From 73f119d39e52d6d577296c2a3b209bbcad925602 Mon Sep 17 00:00:00 2001 From: James Nurthen Date: Wed, 15 Jan 2020 21:13:27 -0800 Subject: [PATCH 17/17] Add related info to aria-describedby --- index.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/index.html b/index.html index 95c6a3ae7..34ee26297 100644 --- a/index.html +++ b/index.html @@ -10672,8 +10672,8 @@

Definitions of States and Properties (all aria-* attributes)

aria-describedby
-

Identifies the element (or elements) that describes the object. See related aria-labelledby.

-

The aria-labelledby attribute is similar to the aria-describedby in that both reference other elements to calculate a text alternative, but a label should be concise, where a description is intended to provide more verbose information.

+

Identifies the element (or elements) that describes the object. See related aria-labelledby and aria-description.

+

The aria-labelledby attribute is similar to aria-describedby in that both reference other elements to calculate a text alternative, but a label should be concise, where a description is intended to provide more verbose information.

The element or elements referenced by the aria-describedby comprise the entire description. Include ID references to multiple elements if necessary, or enclose a set of elements (e.g., paragraphs) with the element referenced by the ID.

ariaColSpanaria-colspan
ariaControlsElementsaria-controls
ariaCurrentaria-current
ariaDescriptionaria-description
ariaDescribedByElementsaria-describedby
ariaDescriptionaria-description
ariaDetailsElementaria-details
ariaDisabledaria-disabled
ariaErrorMessageElementaria-errormessage