html5/spec Overview.html,1.3780,1.3781

Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv2689

Modified Files:
	Overview.html 
Log Message:
Elaborate on why blur() is bad. (whatwg r4733)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.3780
retrieving revision 1.3781
diff -u -d -r1.3780 -r1.3781
--- Overview.html	14 Feb 2010 10:54:28 -0000	1.3780
+++ Overview.html	14 Feb 2010 11:04:45 -0000	1.3781
@@ -46726,7 +46726,20 @@
 
    <dd>
 
-    <p>Unfocuses the element. Use of this method is discouraged. Focus another element instead.</p>
+    <p>Unfocuses the element. Use of this method is discouraged. Focus
+    another element instead.</p>
+
+    <p>Do not use this method to hide the focus ring if you find the
+    focus ring unsightly. Instead, use a CSS rule to override the
+    'outline' property.</p>
+
+    <div class="example">
+
+     <p>For example, to hide the outline from links, you could use:</p>
+
+     <pre>:link:focus, :visited:focus { outline: none; }</pre>
+
+    </div>
 
    </dd>
 
@@ -46755,6 +46768,11 @@
   which the method was called instead. User agents may selectively or
   uniformly ignore calls to this method for usability reasons.</p>
 
+  <p class="example">For example, if the <code title="dom-blur"><a href="#dom-blur">blur()</a></code> method is unwisely being used to
+  remove the focus ring for aesthetics reasons, the page would become
+  unusable by keyboard users. Ignoring calls to this method would thus
+  allow keyboard users to interact with the page.</p>
+
   </div><h3 id="the-accesskey-attribute"><span class="secno">7.5 </span>The <dfn title="attr-accesskey"><code>accesskey</code></dfn> attribute</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>All <a href="#html-elements">HTML elements</a> may have the <code title="attr-accesskey"><a href="#the-accesskey-attribute">accesskey</a></code> content attribute set. The
   <code title="attr-accesskey"><a href="#the-accesskey-attribute">accesskey</a></code> attribute's value is
   used by the user agent as a guide for creating a keyboard shortcut

Received on Sunday, 14 February 2010 11:04:51 UTC