update figure role (#1705)

scottaohara · web-flow · commit c625cb7055f0 · 2022-09-01T21:21:10.000+02:00
* update figure role This PR requires #1703 be merged. * Update index.html * revisions per sarah's review * further updates to figure def
diff --git a/index.html b/index.html
@@ -3425,9 +3425,11 @@ <h2>Definition of Roles</h2>
 		<div class="role" id="figure">
 			<rdef>figure</rdef>
 			<div class="role-description">
-				<p>A perceivable <rref>section</rref> of content that typically contains a <a>graphical document</a>, images, code snippets, or example text. The parts of a <code>figure</code> MAY be user-navigable.</p>
-				<p>Authors SHOULD provide a reference to the <code>figure</code> from the main text, but the <code>figure</code> need not be displayed at the same location as the referencing element. Authors MAY reference text serving as a caption using <pref>aria-describedby</pref>. Authors MAY provide a label using <pref>aria-label</pref> or MAY reference text serving as a label using <pref>aria-labelledby</pref>.</p>
-				<p><a>Assistive technologies</a> SHOULD enable users to quickly navigate to figures. [=User agents=] MAY enable users to quickly navigate to figures.</p>
+				<p>A perceivable <rref>section</rref> of content that typically contains a <a>graphical document</a>, images, media player, code snippets, or example text. The parts of a <code>figure</code> MAY be user-navigable.</p>
+				<p>Authors SHOULD provide a reference to the <code>figure</code> from the main text, but the <code>figure</code> need not be displayed at the same location as the referencing element. Authors MAY provide a <code>figure</code> a <rref>caption</rref> which can include its name, descriptive text, or both. If a <code>caption</code> is provided, and it serves as a description to the contents of the <code>figure</code>, authors SHOULD associate it to the <code>figure</code> element using <pref>aria-details</pref>.</p>
+				<p>Authors MAY provide a <code>figure</code> an accessible name using <pref>aria-label</pref> or use <pref>aria-labelledby</pref> to reference other text in the page to serve as the element's label and accessible name.</p>
+				<p>Please refer to the <rref>caption</rref> role for more information on how to associate a <code>figure</code> with its <code>caption</code>.</p>
+				<p><a>Assistive technologies</a> SHOULD enable users to quickly navigate to figures. <a>User agents</a> MAY enable users to quickly navigate to figures.</p>
 			</div>
 			<table class="role-features">
 				<caption>Characteristics:</caption>
