[html5] r5196 - [e] (0) Add example of using ARIA with <figure>.

[whatwg at whatwg.org]

Author: ianh
Date: 2010-07-23 16:15:16 -0700 (Fri, 23 Jul 2010)
New Revision: 5196

Modified:
   complete.html
   index
   source
Log:
[e] (0) Add example of using ARIA with <figure>.

Modified: complete.html
===================================================================
--- complete.html	2010-07-23 20:48:05 UTC (rev 5195)
+++ complete.html	2010-07-23 23:15:16 UTC (rev 5196)
@@ -10735,7 +10735,40 @@
 
   </div>
 
+  <div class=example>
 
+   <p>These features can be used to make accessibility tools render
+   content to their users in more useful ways. For example, ASCII art,
+   which is really an image, appears to be text, and in the absence of
+   appropriate annotations would end up being rendered by screen
+   readers as a very painful reading of lots of punctuation. Using the
+   features described in this section, one can instead make the ATs
+   skip the ASCII art and just read the caption:</p>
+
+   <pre><figure <strong>role="img" aria-labeledby="fish-caption"</strong>>
+ <pre>
+ o           .'`/
+     '      /  (
+   O    .-'` ` `'-._      .')
+      _/ (o)        '.  .' /
+      )       )))     ><  <
+      `\  |_\      _.'  '. \
+        '-._  _ .-'       '.)
+    jgs     `\__\
+ </pre>
+ <figcaption <strong>id="fish-caption"</strong>>
+  Joan G. Stark, "<cite>fish</cite>".
+  October 1997. ASCII on electrons. 28×8.
+ </figcaption> 
+</figure> 
+   </pre>
+
+   <!-- source: http://www.geocities.com/SoHo/7373/aquatic.htm#fish -->
+
+  </div>
+
+
+
   <h3 id=apis-in-html-documents><span class=secno>3.3 </span>APIs in HTML documents</h3>
 
   <p>For <a href=#html-documents>HTML documents</a>, and for <a href=#html-elements>HTML

Modified: index
===================================================================
--- index	2010-07-23 20:48:05 UTC (rev 5195)
+++ index	2010-07-23 23:15:16 UTC (rev 5196)
@@ -10659,7 +10659,40 @@
 
   </div>
 
+  <div class=example>
 
+   <p>These features can be used to make accessibility tools render
+   content to their users in more useful ways. For example, ASCII art,
+   which is really an image, appears to be text, and in the absence of
+   appropriate annotations would end up being rendered by screen
+   readers as a very painful reading of lots of punctuation. Using the
+   features described in this section, one can instead make the ATs
+   skip the ASCII art and just read the caption:</p>
+
+   <pre><figure <strong>role="img" aria-labeledby="fish-caption"</strong>>
+ <pre>
+ o           .'`/
+     '      /  (
+   O    .-'` ` `'-._      .')
+      _/ (o)        '.  .' /
+      )       )))     ><  <
+      `\  |_\      _.'  '. \
+        '-._  _ .-'       '.)
+    jgs     `\__\
+ </pre>
+ <figcaption <strong>id="fish-caption"</strong>>
+  Joan G. Stark, "<cite>fish</cite>".
+  October 1997. ASCII on electrons. 28×8.
+ </figcaption> 
+</figure> 
+   </pre>
+
+   <!-- source: http://www.geocities.com/SoHo/7373/aquatic.htm#fish -->
+
+  </div>
+
+
+
   <h3 id=apis-in-html-documents><span class=secno>3.3 </span>APIs in HTML documents</h3>
 
   <p>For <a href=#html-documents>HTML documents</a>, and for <a href=#html-elements>HTML

Modified: source
===================================================================
--- source	2010-07-23 20:48:05 UTC (rev 5195)
+++ source	2010-07-23 23:15:16 UTC (rev 5196)
@@ -10989,7 +10989,40 @@
 
   </div>
 
+  <div class="example">
 
+   <p>These features can be used to make accessibility tools render
+   content to their users in more useful ways. For example, ASCII art,
+   which is really an image, appears to be text, and in the absence of
+   appropriate annotations would end up being rendered by screen
+   readers as a very painful reading of lots of punctuation. Using the
+   features described in this section, one can instead make the ATs
+   skip the ASCII art and just read the caption:</p>
+
+   <pre><figure <strong>role="img" aria-labeledby="fish-caption"</strong>>
+ <pre>
+ o           .'`/
+     '      /  (
+   O    .-'` ` `'-._      .')
+      _/ (o)        '.  .' /
+      )       )))     ><  <
+      `\  |_\      _.'  '. \
+        '-._  _ .-'       '.)
+    jgs     `\__\
+ </pre>
+ <figcaption <strong>id="fish-caption"</strong>>
+  Joan G. Stark, "<cite>fish</cite>".
+  October 1997. ASCII on electrons. 28×8.
+ </figcaption> 
+</figure> 
+   </pre>
+
+   <!-- source: http://www.geocities.com/SoHo/7373/aquatic.htm#fish -->
+
+  </div>
+
+
+
   <h3>APIs in HTML documents</h3>
 
   <p>For <span>HTML documents</span>, and for <span>HTML