diff --git a/index.html b/index.html index f4fef22d7..56f8fa06f 100644 --- a/index.html +++ b/index.html @@ -1790,15 +1790,25 @@

Definition of Roles

caption
-

Visible content that names, and may also describe, a figure, table, grid, or treegrid.

+

Visible content that names, or describes a group, figure, table, grid, radiogroup, or treegrid.

When using caption authors SHOULD ensure:

-

Authors SHOULD set aria-labelledby on the parent figure, table, grid, or treegrid to reference the element with role caption. However, if a caption contains content that serves as both a name and description for its parent, authors MAY instead set aria-labelledby to reference an element within the caption that contains a concise name, and set aria-describedby to reference an element within the caption that contains the descriptive content.

- +

If the caption represents an accessible name for its containing element, authors SHOULD specify aria-labelledby on the parent element to reference the element with role caption.

+ +
+					<div role="radiogroup" aria-labelledby="name">
+				    <div role="caption">
+				      Choose your favorite fruit
+				    </div>
+				    <!-- ... -->
+				
+ +

If a caption contains content that serves as both a name and description for its parent, authors MAY instead specify aria-labelledby to reference an element within the caption that represents the "name" of the parent element, and specify aria-describedby to reference an element within the caption that contains the descriptive content.

+
 					<div role="table" aria-labelledby="name" aria-describedby="desc">
 				    <div role="caption">
@@ -1810,6 +1820,24 @@ 

Definition of Roles

</div> <!-- ... -->
+ +

If the caption represents a long-form description, or if the description contains semantic elements which are important in understanding the description, authors MAY instead specify aria-labelledby to reference an element within the caption that represents the "name" of the parent element, and specify aria-details to reference an element within the caption that contains the descriptive content.

+ +
+					<div role="figure" aria-labelledby="name" aria-details="details">
+					  <!-- figure content here, such as a complex data viz SVG -->
+				    <div role="caption">
+				      <div id="name">Sales information for 20XX</div>
+				      <div id="details">
+				        This barchart represents the total amount of sales over the course
+								of five years. Sales information for last year can
+								be reviewed, or you can overlay 
+								information in this graphic.
+				      </div>
+				    </div>
+				    <!-- ... -->
+				
+
@@ -1838,7 +1866,11 @@

Definition of Roles

- +
Characteristics:
Related Concepts:
Required Context Role: