[html5] r5320 - [e] (0) Add some examples of UIs that expose tooltips without a pointing device. [...]

[whatwg at whatwg.org]

Author: ianh
Date: 2010-08-23 16:43:26 -0700 (Mon, 23 Aug 2010)
New Revision: 5320

Modified:
   complete.html
   index
   source
Log:
[e] (0) Add some examples of UIs that expose tooltips without a pointing device.
Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=9589

Modified: complete.html
===================================================================
--- complete.html	2010-08-23 23:10:14 UTC (rev 5319)
+++ complete.html	2010-08-23 23:43:26 UTC (rev 5320)
@@ -89659,14 +89659,32 @@
   that the user agent will expose the contents of that attribute as a
   tooltip.</p>
 
+  <p>U+000A LINE FEED (LF) characters are expected to cause line
+  breaks in the tooltip.</p>
+
   <p>User agents are encouraged to make it possible to view tooltips
   without the use of a pointing device, since not all users are able
   to use pointing devices.</p>
 
-  <p>U+000A LINE FEED (LF) characters are expected to cause line
-  breaks in the tooltip.</p>
+  <div class=example>
 
+   <p>For example, a visual user agent could make elements with a
+   <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute focusable, and
+   could make any focused element with a <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute show its tooltip under
+   the element while the element has focus. This would allow a user to
+   tab around the document to find all the advisory text.</p>
 
+  </div>
+
+  <div class=example>
+
+   <p>As another example, a screen reader could provide an audio cue
+   when reading an element with a tooltip, with an associated key to
+   read the last tooltip for which a cue was played.</p>
+
+  </div>
+
+
   <h4 id=editing-hosts><span class=secno>14.6.3 </span>Editing hosts</h4>
 
   <p>The current text editing caret (the one at the <a href=#caret-position>caret

Modified: index
===================================================================
--- index	2010-08-23 23:10:14 UTC (rev 5319)
+++ index	2010-08-23 23:43:26 UTC (rev 5320)
@@ -82749,14 +82749,32 @@
   that the user agent will expose the contents of that attribute as a
   tooltip.</p>
 
+  <p>U+000A LINE FEED (LF) characters are expected to cause line
+  breaks in the tooltip.</p>
+
   <p>User agents are encouraged to make it possible to view tooltips
   without the use of a pointing device, since not all users are able
   to use pointing devices.</p>
 
-  <p>U+000A LINE FEED (LF) characters are expected to cause line
-  breaks in the tooltip.</p>
+  <div class=example>
 
+   <p>For example, a visual user agent could make elements with a
+   <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute focusable, and
+   could make any focused element with a <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute show its tooltip under
+   the element while the element has focus. This would allow a user to
+   tab around the document to find all the advisory text.</p>
 
+  </div>
+
+  <div class=example>
+
+   <p>As another example, a screen reader could provide an audio cue
+   when reading an element with a tooltip, with an associated key to
+   read the last tooltip for which a cue was played.</p>
+
+  </div>
+
+
   <h4 id=editing-hosts><span class=secno>12.6.3 </span>Editing hosts</h4>
 
   <p>The current text editing caret (the one at the <a href=#caret-position>caret

Modified: source
===================================================================
--- source	2010-08-23 23:10:14 UTC (rev 5319)
+++ source	2010-08-23 23:43:26 UTC (rev 5320)
@@ -102289,14 +102289,33 @@
   that the user agent will expose the contents of that attribute as a
   tooltip.</p>
 
+  <p>U+000A LINE FEED (LF) characters are expected to cause line
+  breaks in the tooltip.</p>
+
   <p>User agents are encouraged to make it possible to view tooltips
   without the use of a pointing device, since not all users are able
   to use pointing devices.</p>
 
-  <p>U+000A LINE FEED (LF) characters are expected to cause line
-  breaks in the tooltip.</p>
+  <div class="example">
 
+   <p>For example, a visual user agent could make elements with a
+   <code title="attr-title">title</code> attribute focusable, and
+   could make any focused element with a <code
+   title="attr-title">title</code> attribute show its tooltip under
+   the element while the element has focus. This would allow a user to
+   tab around the document to find all the advisory text.</p>
 
+  </div>
+
+  <div class="example">
+
+   <p>As another example, a screen reader could provide an audio cue
+   when reading an element with a tooltip, with an associated key to
+   read the last tooltip for which a cue was played.</p>
+
+  </div>
+
+
   <h4>Editing hosts</h4>
 
   <p>The current text editing caret (the one at the <span>caret