From 54c42c6e3d67ed17e6ddfd5e061d486c07e6a343 Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Wed, 11 Dec 2019 15:47:13 -0500 Subject: [PATCH 01/24] Update aria-details: 1) Support multiple elements. 2) Support types of information/annotations that are not descriptions. Refers to issue #749. --- index.html | 25 +++++++++++++++++-------- 1 file changed, 17 insertions(+), 8 deletions(-) diff --git a/index.html b/index.html index 8b1b896d4..3bff61daa 100644 --- a/index.html +++ b/index.html @@ -2567,7 +2567,7 @@

Definition of Roles

definition

A definition of a term or concept. See related term.

-

Authors SHOULD identify the element being defined by giving that element a role of term and referencing it with the aria-labelledby attribute or by making the element with role term a descendant of the element with role definition.

+

Authors SHOULD identify the element being defined by giving that element a role of term and referencing it with the aria-details attribute or by making the element with role term a descendant of the element with role definition.

@@ -10711,12 +10711,21 @@

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

Characteristics:
-
+
aria-details
-

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

-

The aria-details attribute references a single element that provides more detailed information than would normally be provided by aria-describedby. It enables assistive technologies to make users aware of the availability of an extended description as well as navigate to it. Authors SHOULD ensure the element referenced by aria-details is visible to all users.

-

Unlike elements referenced by aria-describedby, the element referenced by aria-details is not used in either the Accessible Name Computation or the Accessible Description Computation as defined in the Accessible Name and Description specification [[ACCNAME-1.1]]. Thus, the content of an element referenced by aria-details is not flattened to a string when presented to assistive technology users. This makes aria-details particularly useful when converting the information to a string would cause a loss of information or make the extended description more difficult to understand.

+

Identifies one or more elements that provide additional, extended information about the object.

+

The additional information can be:

+
    +
  • A description or general annotation (this is the default). See related aria-describedby.
    • +
  • A comment — in this case the element referred to SHOULD use the comment role.
    • +
  • A definition — in this case the referring element SHOULD use the term role and the element referred to SHOULD use the definition role.
    • +
  • A footnote — in this case the element referred to SHOULD use the doc-footnote role from [[DPUB-ARIA]].
    • +
  • An endnote — in this case the element referred to SHOULD use the doc-endnote role from [[DPUB-ARIA]].
    • +
+ +

The aria-details attribute references elements that provide more detailed information than would normally be provided by aria-describedby. It enables assistive technologies to make users aware of the availability of extended information as well as navigate to it. Authors SHOULD ensure elements referenced by aria-details are visible to all users.

+

Unlike elements referenced by aria-describedby, elements referenced by aria-details are not used in either the Accessible Name Computation or the Accessible Description Computation as defined in the Accessible Name and Description specification [[ACCNAME-1.1]]. Thus, the content of elements referenced by aria-details are not flattened to a string when presented to assistive technology users. This makes aria-details particularly useful when converting the information to a string would cause a loss of information or make the extended description more difficult to understand.

In some user agents, multiple reference relationships for descriptive information are not supported by the accessibility API. In such cases, if both aria-describedby and aria-details are provided on an element, aria-details takes precedence.

A common use for aria-details is in digital publishing where an extended description needs to be conveyed in a book that requires structural markup or the embedding of other technology to provide illustrative content. The following example demonstrates this scenario.

@@ -10766,7 +10775,7 @@ 
Definitions of States and Properties (all aria-* attributes)

 					
 					
 						Value:
-						ID reference
+						ID reference list
 					
 				
 			
@@ -13125,7 +13134,7 @@ 
Interface Mixin AriaAttributes

 				attribute FrozenArray<Element>? ariaControlsElements;
 				attribute DOMString? ariaCurrent;
 				attribute FrozenArray<Element>? ariaDescribedByElements;
-				attribute Element? ariaDetailsElement;
+				attribute Element? ariaDetailsElements;
 				attribute DOMString? ariaDisabled;
 				attribute Element? ariaErrorMessageElement;
 				attribute DOMString? ariaExpanded;
@@ -13181,7 +13190,7 @@ 
ARIA Attribute Reflection

 				ariaControlsElementsaria-controls
 				ariaCurrentaria-current
 				ariaDescribedByElementsaria-describedby
-				ariaDetailsElementaria-details
+				ariaDetailsElementsaria-details
 				ariaDisabledaria-disabled
 				ariaErrorMessageElementaria-errormessage
 				ariaExpandedaria-expanded

From 7729c67d888bf74edd5f976bb8d23596cbc2f398 Mon Sep 17 00:00:00 2001
From: Aaron Leventhal 
Date: Wed, 11 Dec 2019 17:14:04 -0500
Subject: [PATCH 02/24] Support new aria-description property

Closes issue #891
---
 index.html | 47 +++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 45 insertions(+), 2 deletions(-)

diff --git a/index.html b/index.html
index 3bff61daa..63e602121 100644
--- a/index.html
+++ b/index.html
@@ -10711,6 +10711,46 @@ 
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
@@ -11384,7 +11424,7 @@

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

Related Concepts: - title attribute in [[HTML]] + Used in Roles: @@ -11404,7 +11444,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.

@@ -12907,6 +12947,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
@@ -13133,6 +13174,7 @@

Interface Mixin AriaAttributes

attribute DOMString? ariaColSpan; attribute FrozenArray<Element>? ariaControlsElements; attribute DOMString? ariaCurrent; + attribute DOMString? ariaDescription; attribute FrozenArray<Element>? ariaDescribedByElements; attribute Element? ariaDetailsElements; attribute DOMString? ariaDisabled; @@ -13189,6 +13231,7 @@

ARIA Attribute Reflection

ariaColSpanaria-colspan ariaControlsElementsaria-controls ariaCurrentaria-current + ariaDescriptionaria-description ariaDescribedByElementsaria-describedby ariaDetailsElementsaria-details ariaDisabledaria-disabled From 410ce3693f2fea4deb4e3be1bd12976c0e3fa2ca Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Wed, 11 Dec 2019 17:19:28 -0500 Subject: [PATCH 03/24] Don't include aria-description changes --- index.html | 47 ++--------------------------------------------- 1 file changed, 2 insertions(+), 45 deletions(-) diff --git a/index.html b/index.html index 63e602121..3bff61daa 100644 --- a/index.html +++ b/index.html @@ -10711,46 +10711,6 @@

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
@@ -11424,7 +11384,7 @@

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

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

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

aria-labelledby
-

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

+

Identifies the element (or elements) that labels the current element. See related 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.

@@ -12947,7 +12907,6 @@

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
@@ -13174,7 +13133,6 @@

Interface Mixin AriaAttributes

attribute DOMString? ariaColSpan; attribute FrozenArray<Element>? ariaControlsElements; attribute DOMString? ariaCurrent; - attribute DOMString? ariaDescription; attribute FrozenArray<Element>? ariaDescribedByElements; attribute Element? ariaDetailsElements; attribute DOMString? ariaDisabled; @@ -13231,7 +13189,6 @@

ARIA Attribute Reflection

ariaColSpanaria-colspan ariaControlsElementsaria-controls ariaCurrentaria-current - ariaDescriptionaria-description ariaDescribedByElementsaria-describedby ariaDetailsElementsaria-details ariaDisabledaria-disabled From 7253506efc8a756a4b8d27bee512d6510b915166 Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Mon, 6 Jan 2020 16:48:52 -0500 Subject: [PATCH 04/24] Update index.html Co-Authored-By: James Nurthen --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 3bff61daa..ac8742b41 100644 --- a/index.html +++ b/index.html @@ -10714,7 +10714,7 @@

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

aria-details
-

Identifies one or more elements that provide additional, extended information about the object.

+

Identifies the element (or elements) that provide additional, extended information about the object.

The additional information can be:

  • A description or general annotation (this is the default). See related aria-describedby.
    • From 56750883f2dc6e89a56b80f2498735db8705d2f3 Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Mon, 6 Jan 2020 16:56:31 -0500 Subject: [PATCH 05/24] Use FrozenArray for ariaDetailsElements --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index ac8742b41..995c64807 100644 --- a/index.html +++ b/index.html @@ -13134,7 +13134,7 @@

    Interface Mixin AriaAttributes

    attribute FrozenArray<Element>? ariaControlsElements; attribute DOMString? ariaCurrent; attribute FrozenArray<Element>? ariaDescribedByElements; - attribute Element? ariaDetailsElements; + attribute FrozenArray? ariaDetailsElements; attribute DOMString? ariaDisabled; attribute Element? ariaErrorMessageElement; attribute DOMString? ariaExpanded; From 9553a7dee650b2767d7ec0b4219b1605a4457a0b Mon Sep 17 00:00:00 2001 From: Aaron Leventhal Date: Mon, 6 Jan 2020 17:02:18 -0500 Subject: [PATCH 06/24] Update index.html Co-Authored-By: James Nurthen --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index 995c64807..5d55646c2 100644 --- a/index.html +++ b/index.html @@ -10725,7 +10725,7 @@

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

The aria-details attribute references elements that provide more detailed information than would normally be provided by aria-describedby. It enables assistive technologies to make users aware of the availability of extended information as well as navigate to it. Authors SHOULD ensure elements referenced by aria-details are visible to all users.

-

Unlike elements referenced by aria-describedby, elements referenced by aria-details are not used in either the Accessible Name Computation or the Accessible Description Computation as defined in the Accessible Name and Description specification [[ACCNAME-1.1]]. Thus, the content of elements referenced by aria-details are not flattened to a string when presented to assistive technology users. This makes aria-details particularly useful when converting the information to a string would cause a loss of information or make the extended description more difficult to understand.

+

Unlike elements referenced by aria-describedby, elements referenced by aria-details are not used in either the Accessible Name Computation or the Accessible Description Computation as defined in the Accessible Name and Description specification [[ACCNAME-1.1]]. Thus, the content of elements referenced by aria-details are not flattened to a string when presented to assistive technology users. This makes aria-details particularly useful when converting the information to a string would cause a loss of information or make the extended information more difficult to understand.

In some user agents, multiple reference relationships for descriptive information are not supported by the accessibility API. In such cases, if both aria-describedby and aria-details are provided on an element, aria-details takes precedence.

A common use for aria-details is in digital publishing where an extended description needs to be conveyed in a book that requires structural markup or the embedding of other technology to provide illustrative content. The following example demonstrates this scenario.


From a6a496e2e3acbe728d8fcc34f5e2a81bf1b1a7c8 Mon Sep 17 00:00:00 2001
From: Aaron Leventhal 
Date: Tue, 7 Jan 2020 11:28:47 -0500
Subject: [PATCH 07/24] Separate term/definition change into different PR

---
 index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.html b/index.html
index 5d55646c2..df5b30114 100644
--- a/index.html
+++ b/index.html
@@ -2567,7 +2567,7 @@ 
Definition of Roles

 			definition
 			

 				
A definition of a term or concept. See related term.

-				
Authors SHOULD identify the element being defined by giving that element a role of term and referencing it with the aria-details attribute or by making the element with role term a descendant of the element with role definition.

+				
Authors SHOULD identify the element being defined by giving that element a role of term and referencing it with the aria-labelledby attribute or by making the element with role term a descendant of the element with role definition.

 			

 			

From 32e3e4ba850bf79cd4dd46a7e0f94073413e5d9e Mon Sep 17 00:00:00 2001
From: Aaron Leventhal 
Date: Tue, 7 Jan 2020 11:52:42 -0500
Subject: [PATCH 08/24] Address review comments

---
 index.html | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/index.html b/index.html
index df5b30114..7f458e61f 100644
--- a/index.html
+++ b/index.html
@@ -10714,10 +10714,10 @@ 
Definitions of States and Properties (all aria-* attributes)

 		

 			aria-details
 			

-				
Identifies the element (or elements) that provide additional, extended information about the object.

+				
Identifies the element or elements that provide additional, extended information about the object. See related aria-describedby.

 				
The additional information can be:

 				
    
-					
  • A description or general annotation (this is the default). See related aria-describedby.
    • 
+					
  • A description or general annotation (this is the default).
    • 
 					
  • A comment — in this case the element referred to SHOULD use the comment role.
    • 
 					
  • A definition — in this case the referring element SHOULD use the term role and the element referred to SHOULD use the definition role.
    • 
 					
  • A footnote — in this case the element referred to SHOULD use the doc-footnote role from [[DPUB-ARIA]].
    • 

From 1d16d0e4b1169411ca99bb8e5e168d36225533bc Mon Sep 17 00:00:00 2001
From: Aaron Leventhal 
Date: Tue, 7 Jan 2020 11:52:49 -0500
Subject: [PATCH 09/24] Address review comments

---
 index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.html b/index.html
index 7f458e61f..4dbb5b768 100644
--- a/index.html
+++ b/index.html
@@ -10714,7 +10714,7 @@ 
    Definitions of States and Properties (all aria-* attributes)
    
 		
    
 			aria-details
 			
    
-				
    Identifies the element or elements that provide additional, extended information about the object. See related aria-describedby.
    
+				
    Identifies the element (or elements) that provide additional, extended information about the object. See related aria-describedby.
    
 				
    The additional information can be:
    
 				
      
 					
    • A description or general annotation (this is the default).
      • 

From e107cf76ee5ecd905cf54f045421cdc79ef130b7 Mon Sep 17 00:00:00 2001
From: Aaron Leventhal 
Date: Thu, 9 Jan 2020 14:15:49 -0500
Subject: [PATCH 10/24] 1) aria-describedby doesn't affect name, 2) Improve
 wording of what to do when aria-details is used in conjunction with
 aria-description or aria-describedby

---
 index.html | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/index.html b/index.html
index 4dbb5b768..53395cf45 100644
--- a/index.html
+++ b/index.html
@@ -10725,8 +10725,8 @@ 
      Definitions of States and Properties (all aria-* attributes)
      
 				
    
 
 				
    The aria-details attribute references elements that provide more detailed information than would normally be provided by aria-describedby. It enables assistive technologies to make users aware of the availability of extended information as well as navigate to it. Authors SHOULD ensure elements referenced by aria-details are visible to all users.
    
-				
    Unlike elements referenced by aria-describedby, elements referenced by aria-details are not used in either the Accessible Name Computation or the Accessible Description Computation as defined in the Accessible Name and Description specification [[ACCNAME-1.1]]. Thus, the content of elements referenced by aria-details are not flattened to a string when presented to assistive technology users. This makes aria-details particularly useful when converting the information to a string would cause a loss of information or make the extended information more difficult to understand.
    
-				
    In some user agents, multiple reference relationships for descriptive information are not supported by the accessibility API. In such cases, if both aria-describedby and aria-details are provided on an element, aria-details takes precedence.
    
+				
    Unlike elements referenced by aria-describedby, elements referenced by aria-details are not used in the Accessible Description Computation as defined in the Accessible Name and Description specification [[ACCNAME-1.1]]. Thus, the content of elements referenced by aria-details are not flattened to a string when presented to assistive technology users. This makes aria-details particularly useful when converting the information to a string would cause a loss of information or make the extended information more difficult to understand.
    
+				
    It is valid for an element to contain both aria-details and a description via aria-describedby or aria-description. In this case, user agents should minimally expose the aria-details relation and the computed flat description string. In user agents that cannot expose multiple descriptive relations, the first aria-details should take precedence.
    
 				
    A common use for aria-details is in digital publishing where an extended description needs to be conveyed in a book that requires structural markup or the embedding of other technology to provide illustrative content. The following example demonstrates this scenario.
    
 				
                                     <!-- Provision of an extended description -->

From 4b1718de8c1f5fdc61fc300a2e9c7624398be16f Mon Sep 17 00:00:00 2001
From: Aaron Leventhal 
Date: Thu, 9 Jan 2020 14:18:49 -0500
Subject: [PATCH 11/24] Remove a should

---
 index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.html b/index.html
index 53395cf45..e649da710 100644
--- a/index.html
+++ b/index.html
@@ -10726,7 +10726,7 @@ 
    Definitions of States and Properties (all aria-* attributes)
    
 
 				
    The aria-details attribute references elements that provide more detailed information than would normally be provided by aria-describedby. It enables assistive technologies to make users aware of the availability of extended information as well as navigate to it. Authors SHOULD ensure elements referenced by aria-details are visible to all users.
    
 				
    Unlike elements referenced by aria-describedby, elements referenced by aria-details are not used in the Accessible Description Computation as defined in the Accessible Name and Description specification [[ACCNAME-1.1]]. Thus, the content of elements referenced by aria-details are not flattened to a string when presented to assistive technology users. This makes aria-details particularly useful when converting the information to a string would cause a loss of information or make the extended information more difficult to understand.
    
-				
    It is valid for an element to contain both aria-details and a description via aria-describedby or aria-description. In this case, user agents should minimally expose the aria-details relation and the computed flat description string. In user agents that cannot expose multiple descriptive relations, the first aria-details should take precedence.
    
+				
    It is valid for an element to contain both aria-details and a description via aria-describedby or aria-description. In this case, user agents should minimally expose the aria-details relation and the computed flat description string. In user agents that cannot expose multiple descriptive relations, the first aria-details takes precedence.
    
 				
    A common use for aria-details is in digital publishing where an extended description needs to be conveyed in a book that requires structural markup or the embedding of other technology to provide illustrative content. The following example demonstrates this scenario.
    
 				
                                     <!-- Provision of an extended description -->

From c418c18562e5273b60c6ef835b8609e21c63d8c6 Mon Sep 17 00:00:00 2001
From: Aaron Leventhal 
Date: Fri, 24 Jan 2020 13:28:21 -0500
Subject: [PATCH 12/24] Update index.html

Co-Authored-By: Matt King 
---
 index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.html b/index.html
index e649da710..235946f47 100644
--- a/index.html
+++ b/index.html
@@ -10714,7 +10714,7 @@ 
    Definitions of States and Properties (all aria-* attributes)
    
 		
    
 			aria-details
 			
    
-				
    Identifies the element (or elements) that provide additional, extended information about the object. See related aria-describedby.
    
+				
    Identifies the element (or elements) that provide additional information related to the object. See related aria-describedby.
    
 				
    The additional information can be:
    
 				
      
 					
    • A description or general annotation (this is the default).
      • 

From 05c09bbe3c17ddfa692d98f65566cba62be0cd68 Mon Sep 17 00:00:00 2001
From: Aaron Leventhal 
Date: Fri, 24 Jan 2020 13:29:15 -0500
Subject: [PATCH 13/24] Update index.html

Co-Authored-By: Matt King 
---
 index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.html b/index.html
index 235946f47..87599ddf2 100644
--- a/index.html
+++ b/index.html
@@ -10715,7 +10715,7 @@ 
      Definitions of States and Properties (all aria-* attributes)
      
 			aria-details
 			
      
 				
      Identifies the element (or elements) that provide additional information related to the object. See related aria-describedby.
      
-				
      The additional information can be:
      
+				
      Assistive technologies MAY use the role of elements referenced by the aria-details property to help users understand the types of information associated with the element. Authors MAY convey the type of details associated with an element as follows:
      
 				
        
 					
      • A description or general annotation (this is the default).
        • 
 					
      • A comment — in this case the element referred to SHOULD use the comment role.
        • 

From 8fcd65596b63c1d102529366ec052f44c9404760 Mon Sep 17 00:00:00 2001
From: Aaron Leventhal 
Date: Fri, 24 Jan 2020 13:29:38 -0500
Subject: [PATCH 14/24] Update index.html

Co-Authored-By: Matt King 
---
 index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.html b/index.html
index 87599ddf2..cb2703c56 100644
--- a/index.html
+++ b/index.html
@@ -10717,7 +10717,7 @@ 
        Definitions of States and Properties (all aria-* attributes)
        
 				
        Identifies the element (or elements) that provide additional information related to the object. See related aria-describedby.
        
 				
        Assistive technologies MAY use the role of elements referenced by the aria-details property to help users understand the types of information associated with the element. Authors MAY convey the type of details associated with an element as follows:
        
 				
          
-					
        • A description or general annotation (this is the default).
          • 
+					
        • Description or general annotation: aria-details refers to an element with any other role.
          • 
 					
        • A comment — in this case the element referred to SHOULD use the comment role.
          • 
 					
        • A definition — in this case the referring element SHOULD use the term role and the element referred to SHOULD use the definition role.
          • 
 					
        • A footnote — in this case the element referred to SHOULD use the doc-footnote role from [[DPUB-ARIA]].
          • 

From a5cb33f634920e377e28dfe0e1858e2f94e52321 Mon Sep 17 00:00:00 2001
From: Aaron Leventhal 
Date: Fri, 24 Jan 2020 13:30:01 -0500
Subject: [PATCH 15/24] Update index.html

Co-Authored-By: Matt King 
---
 index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.html b/index.html
index cb2703c56..257fa2641 100644
--- a/index.html
+++ b/index.html
@@ -10719,7 +10719,7 @@ 
          Definitions of States and Properties (all aria-* attributes)
          
 				
            
 					
          • Description or general annotation: aria-details refers to an element with any other role.
            • 
 					
          • A comment — in this case the element referred to SHOULD use the comment role.
            • 
-					
          • A definition — in this case the referring element SHOULD use the term role and the element referred to SHOULD use the definition role.
            • 
+					
          • Definition: aria-details is applied to an element with role term and refers to an element with role definition.
            • 
 					
          • A footnote — in this case the element referred to SHOULD use the doc-footnote role from [[DPUB-ARIA]].
            • 
 					
          • An endnote — in this case the element referred to SHOULD use the doc-endnote role from [[DPUB-ARIA]].
            • 
 				
          

From 6518bdf91b77e00a8023e6c4aaed70c93416ae66 Mon Sep 17 00:00:00 2001
From: Aaron Leventhal 
Date: Fri, 24 Jan 2020 13:30:31 -0500
Subject: [PATCH 16/24] Update index.html

Co-Authored-By: Matt King 
---
 index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.html b/index.html
index 257fa2641..6e51b037f 100644
--- a/index.html
+++ b/index.html
@@ -10720,7 +10720,7 @@ 
          Definitions of States and Properties (all aria-* attributes)
          
 					
        • Description or general annotation: aria-details refers to an element with any other role.
          • 
 					
        • A comment — in this case the element referred to SHOULD use the comment role.
          • 
 					
        • Definition: aria-details is applied to an element with role term and refers to an element with role definition.
          • 
-					
        • A footnote — in this case the element referred to SHOULD use the doc-footnote role from [[DPUB-ARIA]].
          • 
+					
        • Footnote: aria-details refers to an element with role doc-footnote. This role is defined in [[DPUB-ARIA]].
          • 
 					
        • An endnote — in this case the element referred to SHOULD use the doc-endnote role from [[DPUB-ARIA]].
          • 
 				
        
 

From 699c60d41400c707688647557f0ae70469bda2eb Mon Sep 17 00:00:00 2001
From: Aaron Leventhal 
Date: Fri, 24 Jan 2020 13:30:43 -0500
Subject: [PATCH 17/24] Update index.html

Co-Authored-By: Matt King 
---
 index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.html b/index.html
index 6e51b037f..fbdd59a65 100644
--- a/index.html
+++ b/index.html
@@ -10721,7 +10721,7 @@ 
        Definitions of States and Properties (all aria-* attributes)
        
 					
      • A comment — in this case the element referred to SHOULD use the comment role.
        • 
 					
      • Definition: aria-details is applied to an element with role term and refers to an element with role definition.
        • 
 					
      • Footnote: aria-details refers to an element with role doc-footnote. This role is defined in [[DPUB-ARIA]].
        • 
-					
      • An endnote — in this case the element referred to SHOULD use the doc-endnote role from [[DPUB-ARIA]].
        • 
+					
      • Endnote: aria-details refers to an element with role doc-endnote. This role is defined in [[DPUB-ARIA]].
        • 
 				
      
 
 				
      The aria-details attribute references elements that provide more detailed information than would normally be provided by aria-describedby. It enables assistive technologies to make users aware of the availability of extended information as well as navigate to it. Authors SHOULD ensure elements referenced by aria-details are visible to all users.
      

From d7a8fb371eb912429ca1b987613bc994b7071337 Mon Sep 17 00:00:00 2001
From: Aaron Leventhal 
Date: Fri, 24 Jan 2020 13:31:38 -0500
Subject: [PATCH 18/24] Update index.html

Co-Authored-By: Matt King 
---
 index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.html b/index.html
index fbdd59a65..105900b4f 100644
--- a/index.html
+++ b/index.html
@@ -10718,7 +10718,7 @@ 
      Definitions of States and Properties (all aria-* attributes)
      
 				
      Assistive technologies MAY use the role of elements referenced by the aria-details property to help users understand the types of information associated with the element. Authors MAY convey the type of details associated with an element as follows:
      
 				
        
 					
      • Description or general annotation: aria-details refers to an element with any other role.
        • 
-					
      • A comment — in this case the element referred to SHOULD use the comment role.
        • 
+					
      • Comment: aria-details refers to an element with role comment.
        • 
 					
      • Definition: aria-details is applied to an element with role term and refers to an element with role definition.
        • 
 					
      • Footnote: aria-details refers to an element with role doc-footnote. This role is defined in [[DPUB-ARIA]].
        • 
 					
      • Endnote: aria-details refers to an element with role doc-endnote. This role is defined in [[DPUB-ARIA]].
        • 

From 6aab5b61dfa90598ca006b3f5dec186a6caae99b Mon Sep 17 00:00:00 2001
From: Aaron Leventhal 
Date: Fri, 24 Jan 2020 13:34:18 -0500
Subject: [PATCH 19/24] Update index.html

Co-Authored-By: Matt King 
---
 index.html | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/index.html b/index.html
index 105900b4f..c91ad2041 100644
--- a/index.html
+++ b/index.html
@@ -10726,7 +10726,8 @@ 
        Definitions of States and Properties (all aria-* attributes)
        
 
 				
        The aria-details attribute references elements that provide more detailed information than would normally be provided by aria-describedby. It enables assistive technologies to make users aware of the availability of extended information as well as navigate to it. Authors SHOULD ensure elements referenced by aria-details are visible to all users.
        
 				
        Unlike elements referenced by aria-describedby, elements referenced by aria-details are not used in the Accessible Description Computation as defined in the Accessible Name and Description specification [[ACCNAME-1.1]]. Thus, the content of elements referenced by aria-details are not flattened to a string when presented to assistive technology users. This makes aria-details particularly useful when converting the information to a string would cause a loss of information or make the extended information more difficult to understand.
        
-				
        It is valid for an element to contain both aria-details and a description via aria-describedby or aria-description. In this case, user agents should minimally expose the aria-details relation and the computed flat description string. In user agents that cannot expose multiple descriptive relations, the first aria-details takes precedence.
        
+				
        The aria-details property supports referring to multiple elements. For example, a paragraph in a document editor may reference multiple comments that are not related to each other. If a user agent relies on an accessibility API that does not support exposing multiple descriptive relations, the user agent SHOULD expose the relationship to the first element referenced by aria-details.
        
+				
        It is valid for an element to have both aria-details and a description specified with either aria-describedby or aria-description. If a user agent relies on an accessibility API that does not support exposing multiple descriptive relations, and if an element has both aria-details and aria-describedby, the user agent SHOULD expose the aria-details relation and the description string computed from the aria-describedby relationship.
        
 				
        A common use for aria-details is in digital publishing where an extended description needs to be conveyed in a book that requires structural markup or the embedding of other technology to provide illustrative content. The following example demonstrates this scenario.
        
 				
                                         <!-- Provision of an extended description -->

From 3e0333551ad642f5ebf07395a63890e47b7845bb Mon Sep 17 00:00:00 2001
From: Aaron Leventhal 
Date: Fri, 24 Jan 2020 17:07:33 -0500
Subject: [PATCH 20/24] 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 c91ad2041..03954ed08 100644
--- a/index.html
+++ b/index.html
@@ -13135,7 +13135,7 @@ 
        Interface Mixin AriaAttributes
        
 				attribute FrozenArray<Element>? ariaControlsElements;
 				attribute DOMString? ariaCurrent;
 				attribute FrozenArray<Element>? ariaDescribedByElements;
-				attribute FrozenArray? ariaDetailsElements;
+				attribute FrozenArray<Element>? ariaDetailsElements;
 				attribute DOMString? ariaDisabled;
 				attribute Element? ariaErrorMessageElement;
 				attribute DOMString? ariaExpanded;

From 2ecbbdaf15c219be0eda4eca4192ff76783327fb Mon Sep 17 00:00:00 2001
From: Aaron Leventhal 
Date: Fri, 24 Jan 2020 17:08:13 -0500
Subject: [PATCH 21/24] 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 03954ed08..1e86e6395 100644
--- a/index.html
+++ b/index.html
@@ -10724,7 +10724,7 @@ 
        Definitions of States and Properties (all aria-* attributes)
        
 					
      • Endnote: aria-details refers to an element with role doc-endnote. This role is defined in [[DPUB-ARIA]].
        • 
 				
      
 
-				
      The aria-details attribute references elements that provide more detailed information than would normally be provided by aria-describedby. It enables assistive technologies to make users aware of the availability of extended information as well as navigate to it. Authors SHOULD ensure elements referenced by aria-details are visible to all users.
      
+				
      The aria-details attribute references elements that provide more detailed information than would normally be provided by aria-describedby. It enables assistive technologies to make users aware of the availability of extended information as well as navigate to it. Authors SHOULD ensure that elements referenced by aria-details are visible to all users.
      
 				
      Unlike elements referenced by aria-describedby, elements referenced by aria-details are not used in the Accessible Description Computation as defined in the Accessible Name and Description specification [[ACCNAME-1.1]]. Thus, the content of elements referenced by aria-details are not flattened to a string when presented to assistive technology users. This makes aria-details particularly useful when converting the information to a string would cause a loss of information or make the extended information more difficult to understand.
      
 				
      The aria-details property supports referring to multiple elements. For example, a paragraph in a document editor may reference multiple comments that are not related to each other. If a user agent relies on an accessibility API that does not support exposing multiple descriptive relations, the user agent SHOULD expose the relationship to the first element referenced by aria-details.
      
 				
      It is valid for an element to have both aria-details and a description specified with either aria-describedby or aria-description. If a user agent relies on an accessibility API that does not support exposing multiple descriptive relations, and if an element has both aria-details and aria-describedby, the user agent SHOULD expose the aria-details relation and the description string computed from the aria-describedby relationship.
      

From e6da389d0a69222370946e0e54b75f249ef6eac1 Mon Sep 17 00:00:00 2001
From: Aaron Leventhal 
Date: Fri, 24 Jan 2020 18:02:02 -0500
Subject: [PATCH 22/24] Fix DPUB-ARIA reference

---
 index.html | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/index.html b/index.html
index 1e86e6395..20d68afbd 100644
--- a/index.html
+++ b/index.html
@@ -10720,8 +10720,8 @@ 
      Definitions of States and Properties (all aria-* attributes)
      
 					
    • Description or general annotation: aria-details refers to an element with any other role.
      • 
 					
    • Comment: aria-details refers to an element with role comment.
      • 
 					
    • Definition: aria-details is applied to an element with role term and refers to an element with role definition.
      • 
-					
    • Footnote: aria-details refers to an element with role doc-footnote. This role is defined in [[DPUB-ARIA]].
      • 
-					
    • Endnote: aria-details refers to an element with role doc-endnote. This role is defined in [[DPUB-ARIA]].
      • 
+					
    • Footnote: aria-details refers to an element with role doc-footnote. This role is defined in [[DPUB-ARIA-1.0]].
      • 
+					
    • Endnote: aria-details refers to an element with role doc-endnote. This role is defined in [[DPUB-ARIA-1.0]].
      • 
 				
    
 
 				
    The aria-details attribute references elements that provide more detailed information than would normally be provided by aria-describedby. It enables assistive technologies to make users aware of the availability of extended information as well as navigate to it. Authors SHOULD ensure that elements referenced by aria-details are visible to all users.
    

From 1b8b1d06db8e4d5c758351831435b7cb50a29ada Mon Sep 17 00:00:00 2001
From: Aaron Leventhal 
Date: Mon, 27 Jan 2020 12:12:39 -0500
Subject: [PATCH 23/24] Address review comments from mck

---
 index.html | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/index.html b/index.html
index 20d68afbd..6666c44d8 100644
--- a/index.html
+++ b/index.html
@@ -10715,16 +10715,16 @@ 
    Definitions of States and Properties (all aria-* attributes)
    
 			aria-details
 			
    
 				
    Identifies the element (or elements) that provide additional information related to the object. See related aria-describedby.
    
+				
    The aria-details property is for referencing elements that provide more detailed information than would normally be provided via aria-describedby. The presence of aria-details enables assistive technologies to make users aware of the availability of extended information and navigate to it. Authors SHOULD ensure that elements referenced by aria-details are visible to all users.
    
 				
    Assistive technologies MAY use the role of elements referenced by the aria-details property to help users understand the types of information associated with the element. Authors MAY convey the type of details associated with an element as follows:
    
 				
      
-					
    • Description or general annotation: aria-details refers to an element with any other role.
      • 
 					
    • Comment: aria-details refers to an element with role comment.
      • 
 					
    • Definition: aria-details is applied to an element with role term and refers to an element with role definition.
      • 
 					
    • Footnote: aria-details refers to an element with role doc-footnote. This role is defined in [[DPUB-ARIA-1.0]].
      • 
 					
    • Endnote: aria-details refers to an element with role doc-endnote. This role is defined in [[DPUB-ARIA-1.0]].
      • 
+					
    • Description or general annotation: aria-details refers to an element with any other role.
      • 
 				
    
 
-				
    The aria-details attribute references elements that provide more detailed information than would normally be provided by aria-describedby. It enables assistive technologies to make users aware of the availability of extended information as well as navigate to it. Authors SHOULD ensure that elements referenced by aria-details are visible to all users.
    
 				
    Unlike elements referenced by aria-describedby, elements referenced by aria-details are not used in the Accessible Description Computation as defined in the Accessible Name and Description specification [[ACCNAME-1.1]]. Thus, the content of elements referenced by aria-details are not flattened to a string when presented to assistive technology users. This makes aria-details particularly useful when converting the information to a string would cause a loss of information or make the extended information more difficult to understand.
    
 				
    The aria-details property supports referring to multiple elements. For example, a paragraph in a document editor may reference multiple comments that are not related to each other. If a user agent relies on an accessibility API that does not support exposing multiple descriptive relations, the user agent SHOULD expose the relationship to the first element referenced by aria-details.
    
 				
    It is valid for an element to have both aria-details and a description specified with either aria-describedby or aria-description. If a user agent relies on an accessibility API that does not support exposing multiple descriptive relations, and if an element has both aria-details and aria-describedby, the user agent SHOULD expose the aria-details relation and the description string computed from the aria-describedby relationship.
    

From 6be7d821e5df8dbc01b955c830676491c6960e70 Mon Sep 17 00:00:00 2001
From: Aaron Leventhal 
Date: Mon, 3 Feb 2020 18:51:36 -0500
Subject: [PATCH 24/24] Fix missing word 'ramp' in example

---
 index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.html b/index.html
index 6666c44d8..81ac0b263 100644
--- a/index.html
+++ b/index.html
@@ -10745,7 +10745,7 @@ 
    Definitions of States and Properties (all aria-* attributes)
    
                                   </p>
                                   <object data="skatebd-ramp.svg"  type="image/svg+xml"></object>
                                   <p>
-                                    In this example you will notice a skateboard with a base and vertical board whose width
+                                    In this example you will notice a skateboard ramp with a base and vertical board whose width
                                     is the width of the ramp. To compute how long the ramp must be, simply calculate the
                                     base length, square it, sum it with the square of the height of the ramp, and take the
                                     square root of the sum.


 				Characteristics: