[e] (0) Elaborate on why blur() is bad.

Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=8717 git-svn-id: http://svn.whatwg.org/webapps@4733 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Feb 14, 2010 · 454674b · 454674b
1 parent 48344b0
commit 454674b
Show file tree

Hide file tree

Showing 3 changed files with 58 additions and 6 deletions.
diff --git a/complete.html b/complete.html
@@ -59904,7 +59904,20 @@ <h4 id=element-level-focus-apis><span class=secno>8.4.4 </span>Element-level foc
 
    <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>
 
@@ -59933,8 +59946,12 @@ <h4 id=element-level-focus-apis><span class=secno>8.4.4 </span>Element-level foc
   which the method was called instead. User agents may selectively or
   uniformly ignore calls to this method for usability reasons.</p>
 
-  </div>
+  <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>
 
 
 

diff --git a/index b/index
@@ -59832,7 +59832,20 @@ interface <dfn id=navigatorabilities>NavigatorAbilities</dfn> {
 
    <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>
 
@@ -59861,8 +59874,12 @@ interface <dfn id=navigatorabilities>NavigatorAbilities</dfn> {
   which the method was called instead. User agents may selectively or
   uniformly ignore calls to this method for usability reasons.</p>
 
-  </div>
+  <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>
 
 
 

diff --git a/source b/source
@@ -67744,7 +67744,20 @@ interface <dfn>NavigatorAbilities</dfn> {
 
    <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>
 
@@ -67779,8 +67792,13 @@ interface <dfn>NavigatorAbilities</dfn> {
   which the method was called instead. User agents may selectively or
   uniformly ignore calls to this method for usability reasons.</p>
 
-  </div>
+  <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>