W3C home > Mailing lists > Public > public-html-commits@w3.org > July 2010

html5/spec Overview.html,1.4156,1.4157

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Thu, 29 Jul 2010 21:53:44 +0000
To: public-html-commits@w3.org
Message-Id: <E1Oeb2u-0001R5-Um@lionel-hutz.w3.org>
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv5501

Modified Files:
	Overview.html 
Log Message:
Change autofocus='' to only focus the first control seen with the attribute (per document). (whatwg r5222)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.4156
retrieving revision 1.4157
diff -u -d -r1.4156 -r1.4157
--- Overview.html	29 Jul 2010 00:34:13 -0000	1.4156
+++ Overview.html	29 Jul 2010 21:53:41 -0000	1.4157
@@ -33672,31 +33672,40 @@
   describe how the user interacts with the control.</p>
 
   </div><h5 id="autofocusing-a-form-control"><span class="secno">4.10.19.4 </span>Autofocusing a form control</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><!-- v2: Apply this to contentEditable elements --><p>The <dfn id="attr-fe-autofocus" title="attr-fe-autofocus"><code>autofocus</code></dfn>
-  content attribute allows the user to indicate that a control is to
+  content attribute allows the author to indicate that a control is to
   be focused as soon as the page is loaded, allowing the user to just
   start typing without having to manually focus the main control.<p>The <code title="attr-fe-autofocus"><a href="#attr-fe-autofocus">autofocus</a></code> attribute is
   a <a href="#boolean-attribute">boolean attribute</a>.<p>There must not be more than one element in the document with the
   <code title="attr-fe-autofocus"><a href="#attr-fe-autofocus">autofocus</a></code> attribute
   specified.<div class="impl">
 
-  <p>Whenever an element with the <code title="attr-fe-autofocus"><a href="#attr-fe-autofocus">autofocus</a></code> attribute specified is
+  <p>When an element with the <code title="attr-fe-autofocus"><a href="#attr-fe-autofocus">autofocus</a></code> attribute specified is
   <a href="#insert-an-element-into-a-document" title="insert an element into a document">inserted into a
-  document</a> whose <a href="#browsing-context">browsing context</a> did not have the
-  <a href="#sandboxed-automatic-features-browsing-context-flag">sandboxed automatic features browsing context flag</a> set
-  when the <code><a href="#document">Document</a></code> was created, the user agent should
-  <a href="#queue-a-task">queue a task</a> that checks to see if the element is
-  <a href="#focusable">focusable</a>, and if so, runs the <a href="#focusing-steps">focusing
-  steps</a> for that element. User agents may also change the
-  scrolling position of the document, or perform some other action
-  that brings the element to the user's attention. The <a href="#task-source">task
-  source</a> for this task is the <a href="#dom-manipulation-task-source">DOM manipulation task
-  source</a>.</p>
+  document</a>, user agents should run the following steps:</p>~
 
-  <p>User agents may ignore this attribute if the user has indicated
-  (for example, by starting to type in a form control) that he does
-  not wish focus to be changed.</p>
+  <ol><li><p>If the <code><a href="#document">Document</a></code>'s <a href="#browsing-context">browsing context</a>
+   had the <a href="#sandboxed-automatic-features-browsing-context-flag">sandboxed automatic features browsing context
+   flag</a> set when the <code><a href="#document">Document</a></code> was created, abort
+   these steps.</li>
 
-  <p class="note">Focusing the control does not imply that the user
+   <li><p>If the user agent has already reached the last step of this
+   list of steps in response to an element being <a href="#insert-an-element-into-a-document" title="insert
+   an element into a document">inserted</a> into this
+   <code><a href="#document">Document</a></code>, abort these steps.</li>
+
+   <li><p>If the user has indicated (for example, by starting to type
+   in a form control) that he does not wish focus to be changed, then
+   optionally abort these steps.</li>
+
+   <li><p><a href="#queue-a-task">Queue a task</a> that checks to see if the element
+   is <a href="#focusable">focusable</a>, and if so, runs the <a href="#focusing-steps">focusing
+   steps</a> for that element. User agents may also change the
+   scrolling position of the document, or perform some other action
+   that brings the element to the user's attention. The <a href="#task-source">task
+   source</a> for this task is the <a href="#dom-manipulation-task-source">DOM manipulation task
+   source</a>.</li>
+
+  </ol><p class="note">Focusing the control does not imply that the user
   agent must focus the browser window if it has lost focus.</p>
 
   <p>The <dfn id="dom-fe-autofocus" title="dom-fe-autofocus"><code>autofocus</code></dfn>
Received on Thursday, 29 July 2010 21:53:46 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 29 July 2010 21:53:51 GMT