From 5a14d4d194902dffd0fc0460e90d6c780325fd87 Mon Sep 17 00:00:00 2001 From: Scott O'Hara Date: Sat, 12 Mar 2022 12:18:07 -0500 Subject: [PATCH 1/4] update figure role This PR requires #1703 be merged. --- index.html | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/index.html b/index.html index f4fef22d7..c67986c89 100644 --- a/index.html +++ b/index.html @@ -3453,7 +3453,8 @@

Definition of Roles

figure

A perceivable section of content that typically contains a graphical document, images, code snippets, or example text. The parts of a figure MAY be user-navigable.

-

Authors SHOULD provide a reference to the figure from the main text, but the figure need not be displayed at the same location as the referencing element. Authors MAY reference text serving as a caption using aria-describedby. Authors MAY provide a label using aria-label or MAY reference text serving as a label using aria-labelledby.

+

Authors SHOULD provide a reference to the figure from the main text, but the figure need not be displayed at the same location as the referencing element. Authors MAY provide a figure a caption to serve as the name, description, or both to the element. Please refer to the caption role for more information on how to associate these roles.

+

If a figure does not contain a caption, authors MAY provide a figure an accessible name using aria-label or MAY reference other text serving as a label using aria-labelledby.

Assistive technologies SHOULD enable users to quickly navigate to figures. User agents MAY enable users to quickly navigate to figures.

From a8f3f3df24b05c9fa15baed67f8c91923221ee23 Mon Sep 17 00:00:00 2001 From: Scott O'Hara Date: Fri, 1 Apr 2022 17:07:48 -0400 Subject: [PATCH 2/4] Update index.html --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index c67986c89..771eac44a 100644 --- a/index.html +++ b/index.html @@ -3453,7 +3453,7 @@

Definition of Roles

figure

A perceivable section of content that typically contains a graphical document, images, code snippets, or example text. The parts of a figure MAY be user-navigable.

-

Authors SHOULD provide a reference to the figure from the main text, but the figure need not be displayed at the same location as the referencing element. Authors MAY provide a figure a caption to serve as the name, description, or both to the element. Please refer to the caption role for more information on how to associate these roles.

+

Authors SHOULD provide a reference to the figure from the main text, but the figure need not be displayed at the same location as the referencing element. Authors MAY provide a figure a caption to serve as its name, description, or both. Please refer to the caption role for more information on how to associate these roles.

If a figure does not contain a caption, authors MAY provide a figure an accessible name using aria-label or MAY reference other text serving as a label using aria-labelledby.

Assistive technologies SHOULD enable users to quickly navigate to figures. User agents MAY enable users to quickly navigate to figures.

From e539face3554eff1c51ff6fa9ff5a207e6c9e6cd Mon Sep 17 00:00:00 2001 From: Scott O'Hara Date: Fri, 1 Apr 2022 17:32:07 -0400 Subject: [PATCH 3/4] revisions per sarah's review --- index.html | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/index.html b/index.html index 771eac44a..a99e9b9f2 100644 --- a/index.html +++ b/index.html @@ -3452,9 +3452,10 @@

Definition of Roles

figure
-

A perceivable section of content that typically contains a graphical document, images, code snippets, or example text. The parts of a figure MAY be user-navigable.

-

Authors SHOULD provide a reference to the figure from the main text, but the figure need not be displayed at the same location as the referencing element. Authors MAY provide a figure a caption to serve as its name, description, or both. Please refer to the caption role for more information on how to associate these roles.

-

If a figure does not contain a caption, authors MAY provide a figure an accessible name using aria-label or MAY reference other text serving as a label using aria-labelledby.

+

A perceivable section of content that typically contains a graphical document, images, media file, code snippets, or example text. The parts of a figure MAY be user-navigable.

+

Authors SHOULD provide a reference to the figure from the main text, but the figure need not be displayed at the same location as the referencing element. Authors MAY provide a figure a caption to serve as its name, description, or both. If a caption is provided, authors SHOULD associate it with the figure using aria-details.

+

Authors MAY provide a figure an accessible name using aria-label or use aria-labelledby to reference other text serving as the element's label.

+

Please refer to the caption role for more information on how to associate a figure with its caption.

Assistive technologies SHOULD enable users to quickly navigate to figures. User agents MAY enable users to quickly navigate to figures.

From bc28d99879f2d15aad5ab4266e5412edd3035ae5 Mon Sep 17 00:00:00 2001 From: Scott O'Hara Date: Fri, 1 Apr 2022 17:39:45 -0400 Subject: [PATCH 4/4] further updates to figure def --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index a99e9b9f2..d904b67e6 100644 --- a/index.html +++ b/index.html @@ -3453,7 +3453,7 @@

Definition of Roles

figure

A perceivable section of content that typically contains a graphical document, images, media file, code snippets, or example text. The parts of a figure MAY be user-navigable.

-

Authors SHOULD provide a reference to the figure from the main text, but the figure need not be displayed at the same location as the referencing element. Authors MAY provide a figure a caption to serve as its name, description, or both. If a caption is provided, authors SHOULD associate it with the figure using aria-details.

+

Authors SHOULD provide a reference to the figure from the main text, but the figure need not be displayed at the same location as the referencing element. Authors MAY provide a figure a caption which can serve as its name, description, or both. If a caption is provided, and it serves as a description to the contents of the figure, authors SHOULD associate it to the figure element using aria-details.

Authors MAY provide a figure an accessible name using aria-label or use aria-labelledby to reference other text serving as the element's label.

Please refer to the caption role for more information on how to associate a figure with its caption.

Assistive technologies SHOULD enable users to quickly navigate to figures. User agents MAY enable users to quickly navigate to figures.