[html5] r4733 - [e] (0) Elaborate on why blur() is bad. Fixing http://www.w3.org/Bugs/Public/sho [...]

[whatwg at whatwg.org]

Author: ianh
Date: 2010-02-14 03:04:40 -0800 (Sun, 14 Feb 2010)
New Revision: 4733

Modified:
   complete.html
   index
   source
Log:
[e] (0) Elaborate on why blur() is bad.
Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=8717

Modified: complete.html
===================================================================
--- complete.html	2010-02-14 10:54:23 UTC (rev 4732)
+++ complete.html	2010-02-14 11:04:40 UTC (rev 4733)
@@ -59904,8 +59904,21 @@
 
    <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>
 
   </dl><div class=impl>
@@ -59933,12 +59946,16 @@
   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>8.5 </span>The <dfn title=attr-accesskey><code>accesskey</code></dfn> attribute</h3>
 
   <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

Modified: index
===================================================================
--- index	2010-02-14 10:54:23 UTC (rev 4732)
+++ index	2010-02-14 11:04:40 UTC (rev 4733)
@@ -59832,8 +59832,21 @@
 
    <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>
 
   </dl><div class=impl>
@@ -59861,12 +59874,16 @@
   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>8.5 </span>The <dfn title=attr-accesskey><code>accesskey</code></dfn> attribute</h3>
 
   <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

Modified: source
===================================================================
--- source	2010-02-14 10:54:23 UTC (rev 4732)
+++ source	2010-02-14 11:04:40 UTC (rev 4733)
@@ -67744,8 +67744,21 @@
 
    <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>
 
   </dl>
@@ -67779,12 +67792,17 @@
   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">blur()</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>The <dfn title="attr-accesskey"><code>accesskey</code></dfn> attribute</h3>
 
   <p>All <span>HTML elements</span> may have the <code