- From: poot <cvsmail@w3.org>
- Date: Tue, 18 Aug 2009 14:21:57 +0900 (JST)
- To: public-html-diffs@w3.org
hixie: Remove the intro placeholder for the user interaction section.
We'll add examples to individual sections were needed instead. (whatwg
r3656)
http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.2834&r2=1.2835&f=h
http://html5.org/tools/web-apps-tracker?from=3655&to=3656
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2834
retrieving revision 1.2835
diff -u -d -r1.2834 -r1.2835
--- Overview.html 17 Aug 2009 22:43:09 -0000 1.2834
+++ Overview.html 18 Aug 2009 05:21:34 -0000 1.2835
@@ -169,7 +169,7 @@
<h2 class="no-num no-toc" id="a-vocabulary-and-associated-apis-for-html-and-xhtml">A vocabulary and associated APIs for HTML and XHTML</h2>
<!--ZZZ:-->
<!--<h2 class="no-num no-toc">W3C Working Draft 23 April 2009</h2>-->
- <h2 class="no-num no-toc" id="editor-s-draft-date-1-january-1970">Editor's Draft 17 August 2009</h2>
+ <h2 class="no-num no-toc" id="editor-s-draft-date-1-january-1970">Editor's Draft 18 August 2009</h2>
<!--:ZZZ-->
<dl><!-- ZZZ: update the month/day (twice), (un)comment out
<dt>This Version:</dt>
@@ -267,7 +267,7 @@
track.
<!--ZZZ:-->
<!--This specification is the 23 April 2009 Working Draft.-->
- This specification is the 17 August 2009 Editor's Draft.
+ This specification is the 18 August 2009 Editor's Draft.
<!--:ZZZ-->
</p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- relationship to other work (required) --><p>This specification is also being produced by the <a href="http://www.whatwg.org/">WHATWG</a>. The two specifications are
identical from the table of contents onwards.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- context and rationale (required) --><p>This specification is intended to replace (be a new version of)
@@ -888,55 +888,54 @@
<li><a href="#other-link-types"><span class="secno">6.12.3.20 </span>Other link types</a></ol></ol></ol></li>
<li><a href="#editing"><span class="secno">7 </span>User Interaction</a>
<ol>
- <li><a href="#editing-intro"><span class="secno">7.1 </span>Introduction</a></li>
- <li><a href="#the-hidden-attribute"><span class="secno">7.2 </span>The <code>hidden</code> attribute</a></li>
- <li><a href="#activation"><span class="secno">7.3 </span>Activation</a></li>
- <li><a href="#scrolling-elements-into-view"><span class="secno">7.4 </span>Scrolling elements into view</a></li>
- <li><a href="#focus"><span class="secno">7.5 </span>Focus</a>
+ <li><a href="#the-hidden-attribute"><span class="secno">7.1 </span>The <code>hidden</code> attribute</a></li>
+ <li><a href="#activation"><span class="secno">7.2 </span>Activation</a></li>
+ <li><a href="#scrolling-elements-into-view"><span class="secno">7.3 </span>Scrolling elements into view</a></li>
+ <li><a href="#focus"><span class="secno">7.4 </span>Focus</a>
<ol>
- <li><a href="#sequential-focus-navigation"><span class="secno">7.5.1 </span>Sequential focus navigation</a></li>
- <li><a href="#focus-management"><span class="secno">7.5.2 </span>Focus management</a></li>
- <li><a href="#document-level-focus-apis"><span class="secno">7.5.3 </span>Document-level focus APIs</a></li>
- <li><a href="#element-level-focus-apis"><span class="secno">7.5.4 </span>Element-level focus APIs</a></ol></li>
- <li><a href="#the-accesskey-attribute"><span class="secno">7.6 </span>The <code>accesskey</code> attribute</a></li>
- <li><a href="#selection"><span class="secno">7.7 </span>The text selection APIs</a>
+ <li><a href="#sequential-focus-navigation"><span class="secno">7.4.1 </span>Sequential focus navigation</a></li>
+ <li><a href="#focus-management"><span class="secno">7.4.2 </span>Focus management</a></li>
+ <li><a href="#document-level-focus-apis"><span class="secno">7.4.3 </span>Document-level focus APIs</a></li>
+ <li><a href="#element-level-focus-apis"><span class="secno">7.4.4 </span>Element-level focus APIs</a></ol></li>
+ <li><a href="#the-accesskey-attribute"><span class="secno">7.5 </span>The <code>accesskey</code> attribute</a></li>
+ <li><a href="#selection"><span class="secno">7.6 </span>The text selection APIs</a>
<ol>
- <li><a href="#documentSelection"><span class="secno">7.7.1 </span>APIs for the browsing context selection</a></li>
- <li><a href="#textFieldSelection"><span class="secno">7.7.2 </span>APIs for the text field selections</a></ol></li>
- <li><a href="#contenteditable"><span class="secno">7.8 </span>The <code title="attr-contenteditable">contenteditable</code> attribute</a>
+ <li><a href="#documentSelection"><span class="secno">7.6.1 </span>APIs for the browsing context selection</a></li>
+ <li><a href="#textFieldSelection"><span class="secno">7.6.2 </span>APIs for the text field selections</a></ol></li>
+ <li><a href="#contenteditable"><span class="secno">7.7 </span>The <code title="attr-contenteditable">contenteditable</code> attribute</a>
<ol>
- <li><a href="#user-editing-actions"><span class="secno">7.8.1 </span>User editing actions</a></li>
- <li><a href="#making-entire-documents-editable"><span class="secno">7.8.2 </span>Making entire documents editable</a></ol></li>
- <li><a href="#spelling-and-grammar-checking"><span class="secno">7.9 </span>Spelling and grammar checking</a></li>
- <li><a href="#dnd"><span class="secno">7.10 </span>Drag and drop</a>
+ <li><a href="#user-editing-actions"><span class="secno">7.7.1 </span>User editing actions</a></li>
+ <li><a href="#making-entire-documents-editable"><span class="secno">7.7.2 </span>Making entire documents editable</a></ol></li>
+ <li><a href="#spelling-and-grammar-checking"><span class="secno">7.8 </span>Spelling and grammar checking</a></li>
+ <li><a href="#dnd"><span class="secno">7.9 </span>Drag and drop</a>
<ol>
- <li><a href="#introduction-4"><span class="secno">7.10.1 </span>Introduction</a></li>
- <li><a href="#the-dragevent-and-datatransfer-interfaces"><span class="secno">7.10.2 </span>The <code>DragEvent</code> and <code>DataTransfer</code> interfaces</a></li>
- <li><a href="#events-fired-during-a-drag-and-drop-action"><span class="secno">7.10.3 </span>Events fired during a drag-and-drop action</a></li>
- <li><a href="#drag-and-drop-processing-model"><span class="secno">7.10.4 </span>Drag-and-drop processing model</a>
+ <li><a href="#introduction-4"><span class="secno">7.9.1 </span>Introduction</a></li>
+ <li><a href="#the-dragevent-and-datatransfer-interfaces"><span class="secno">7.9.2 </span>The <code>DragEvent</code> and <code>DataTransfer</code> interfaces</a></li>
+ <li><a href="#events-fired-during-a-drag-and-drop-action"><span class="secno">7.9.3 </span>Events fired during a drag-and-drop action</a></li>
+ <li><a href="#drag-and-drop-processing-model"><span class="secno">7.9.4 </span>Drag-and-drop processing model</a>
<ol>
- <li><a href="#when-the-drag-and-drop-operation-starts-or-ends-in-another-document"><span class="secno">7.10.4.1 </span>When the drag-and-drop operation starts or ends in another
+ <li><a href="#when-the-drag-and-drop-operation-starts-or-ends-in-another-document"><span class="secno">7.9.4.1 </span>When the drag-and-drop operation starts or ends in another
document</a></li>
- <li><a href="#when-the-drag-and-drop-operation-starts-or-ends-in-another-application"><span class="secno">7.10.4.2 </span>When the drag-and-drop operation starts or ends in another
+ <li><a href="#when-the-drag-and-drop-operation-starts-or-ends-in-another-application"><span class="secno">7.9.4.2 </span>When the drag-and-drop operation starts or ends in another
application</a></ol></li>
- <li><a href="#the-draggable-attribute"><span class="secno">7.10.5 </span>The <code>draggable</code> attribute</a></li>
- <li><a href="#copy-and-paste"><span class="secno">7.10.6 </span>Copy and paste</a>
+ <li><a href="#the-draggable-attribute"><span class="secno">7.9.5 </span>The <code>draggable</code> attribute</a></li>
+ <li><a href="#copy-and-paste"><span class="secno">7.9.6 </span>Copy and paste</a>
<ol>
- <li><a href="#copy-to-clipboard"><span class="secno">7.10.6.1 </span>Copy to clipboard</a></li>
- <li><a href="#cut-to-clipboard"><span class="secno">7.10.6.2 </span>Cut to clipboard</a></li>
- <li><a href="#paste-from-clipboard"><span class="secno">7.10.6.3 </span>Paste from clipboard</a></li>
- <li><a href="#paste-from-selection"><span class="secno">7.10.6.4 </span>Paste from selection</a></ol></li>
- <li><a href="#security-risks-in-the-drag-and-drop-model"><span class="secno">7.10.7 </span>Security risks in the drag-and-drop model</a></ol></li>
- <li><a href="#undo"><span class="secno">7.11 </span>Undo history</a>
+ <li><a href="#copy-to-clipboard"><span class="secno">7.9.6.1 </span>Copy to clipboard</a></li>
+ <li><a href="#cut-to-clipboard"><span class="secno">7.9.6.2 </span>Cut to clipboard</a></li>
+ <li><a href="#paste-from-clipboard"><span class="secno">7.9.6.3 </span>Paste from clipboard</a></li>
+ <li><a href="#paste-from-selection"><span class="secno">7.9.6.4 </span>Paste from selection</a></ol></li>
+ <li><a href="#security-risks-in-the-drag-and-drop-model"><span class="secno">7.9.7 </span>Security risks in the drag-and-drop model</a></ol></li>
+ <li><a href="#undo"><span class="secno">7.10 </span>Undo history</a>
<ol>
- <li><a href="#introduction-5"><span class="secno">7.11.1 </span>Introduction</a></li>
- <li><a href="#definitions-2"><span class="secno">7.11.2 </span>Definitions</a></li>
- <li><a href="#the-undomanager-interface"><span class="secno">7.11.3 </span>The <code>UndoManager</code> interface</a></li>
- <li><a href="#undo:-moving-back-in-the-undo-transaction-history"><span class="secno">7.11.4 </span>Undo: moving back in the undo transaction history</a></li>
- <li><a href="#redo:-moving-forward-in-the-undo-transaction-history"><span class="secno">7.11.5 </span>Redo: moving forward in the undo transaction history</a></li>
- <li><a href="#the-undomanagerevent-interface-and-the-undo-and-redo-events"><span class="secno">7.11.6 </span>The <code>UndoManagerEvent</code> interface and the <code title="event-undo">undo</code> and <code title="event-redo">redo</code> events</a></li>
- <li><a href="#implementation-notes"><span class="secno">7.11.7 </span>Implementation notes</a></ol></li>
- <li><a href="#editing-apis"><span class="secno">7.12 </span>Editing APIs</a></ol></li>
+ <li><a href="#introduction-5"><span class="secno">7.10.1 </span>Introduction</a></li>
+ <li><a href="#definitions-2"><span class="secno">7.10.2 </span>Definitions</a></li>
+ <li><a href="#the-undomanager-interface"><span class="secno">7.10.3 </span>The <code>UndoManager</code> interface</a></li>
+ <li><a href="#undo:-moving-back-in-the-undo-transaction-history"><span class="secno">7.10.4 </span>Undo: moving back in the undo transaction history</a></li>
+ <li><a href="#redo:-moving-forward-in-the-undo-transaction-history"><span class="secno">7.10.5 </span>Redo: moving forward in the undo transaction history</a></li>
+ <li><a href="#the-undomanagerevent-interface-and-the-undo-and-redo-events"><span class="secno">7.10.6 </span>The <code>UndoManagerEvent</code> interface and the <code title="event-undo">undo</code> and <code title="event-redo">redo</code> events</a></li>
+ <li><a href="#implementation-notes"><span class="secno">7.10.7 </span>Implementation notes</a></ol></li>
+ <li><a href="#editing-apis"><span class="secno">7.11 </span>Editing APIs</a></ol></li>
<li><a href="#comms"><span class="secno">8 </span>Communication</a>
<ol>
<li><a href="#event-definitions"><span class="secno">8.1 </span>Event definitions</a></li>
@@ -48891,8 +48890,7 @@
approved. It is expected that the Wiki will have a community that
addresses this.<h2 id="editing"><span class="secno">7 </span><dfn>User Interaction</dfn></h2><p>This section describes various features that allow authors to
enable users to edit documents and parts of documents
- interactively.<h3 id="editing-intro"><span class="secno">7.1 </span>Introduction</h3><p><i>This section is non-normative.</i><p class="XXX">Would be nice to explain how these features
- work together.<h3 id="the-hidden-attribute"><span class="secno">7.2 </span>The <dfn title="attr-hidden"><code>hidden</code></dfn> attribute</h3><p>All <a href="#html-elements">HTML elements</a> may have the <code title="attr-hidden"><a href="#the-hidden-attribute">hidden</a></code> content attribute set. The <code title="attr-hidden"><a href="#the-hidden-attribute">hidden</a></code> attribute is a <a href="#boolean-attribute">boolean
+ interactively.<h3 id="the-hidden-attribute"><span class="secno">7.1 </span>The <dfn title="attr-hidden"><code>hidden</code></dfn> attribute</h3><p>All <a href="#html-elements">HTML elements</a> may have the <code title="attr-hidden"><a href="#the-hidden-attribute">hidden</a></code> content attribute set. The <code title="attr-hidden"><a href="#the-hidden-attribute">hidden</a></code> attribute is a <a href="#boolean-attribute">boolean
attribute</a>. When specified on an element, it indicates that
the element is not yet, or is no longer, relevant. <span class="impl">User agents should not render elements that have the
<code title="attr-hidden"><a href="#the-hidden-attribute">hidden</a></code> attribute
@@ -48934,7 +48932,7 @@
attribute must <a href="#reflect">reflect</a> the content attribute of the
same name.</p>
- </div><h3 id="activation"><span class="secno">7.3 </span>Activation</h3><!-- v2 idea: HTMLImageElement.click(x, y); or clickPoint(), if
+ </div><h3 id="activation"><span class="secno">7.2 </span>Activation</h3><!-- v2 idea: HTMLImageElement.click(x, y); or clickPoint(), if
click() can't be done in IE; can this be emulated in IE by
posting a synthetic mouse click event with those X and Y
coords? (ack Csaba Gabor)
@@ -48968,7 +48966,7 @@
<li><p>Set the <var title="">click in progress</var> flag on the
element to false.</li>
- </ol></div><h3 id="scrolling-elements-into-view"><span class="secno">7.4 </span>Scrolling elements into view</h3><!-- maybe this should move to [CSSOM] --><dl class="domintro"><dt><var title="">element</var> . <code title="dom-scrollIntoView"><a href="#dom-scrollintoview">scrollIntoView</a></code>( [ <var title="">top</var> ] )</dt>
+ </ol></div><h3 id="scrolling-elements-into-view"><span class="secno">7.3 </span>Scrolling elements into view</h3><!-- maybe this should move to [CSSOM] --><dl class="domintro"><dt><var title="">element</var> . <code title="dom-scrollIntoView"><a href="#dom-scrollintoview">scrollIntoView</a></code>( [ <var title="">top</var> ] )</dt>
<dd>
@@ -49005,7 +49003,7 @@
<p>Non-visual user agents may ignore the argument, or may treat it
in some media-specific manner most useful to the user.</p>
- </div><h3 id="focus"><span class="secno">7.5 </span>Focus</h3><!-- http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C!DOCTYPE%20html%3E%20%0A...%3Cform%3E%3Cinput%20name%3Da%20onfocus%3D%22value%2B%3D1%3Bd.name%3D%27a%27%3Bname%3D%27d%27%3Bb.focus()%22%3E%0A%3Cinput%20name%3Db%20onfocus%3D%22value%2B%3D1%3Bc.focus()%22%3E%0A%3Cinput%20name%3Dc%20onfocus%3D%22value%2B%3D1%3Bd.focus()%22%3E%0A%3Cinput%20name%3Dd%20onfocus%3D%22value%2B%3D1%3Ba.focus()%22%3E --><!-- http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C!DOCTYPE%20html%3E%0A...%3Cform%3E%0A%3Ctextarea%20name%3Dt%20cols%3D100%20rows%3D3%3E%3C%2Ftextarea%3E%3Cp%3E%0A%3Cinput%20name%3Da%20onfocus%3D%22t.value%2B%3D%27af1%20%27%3Bb.focus()%3Balert(document.activeElement.name)%3Bt.value%2B%3D%27af2%20%27%3B%22%20onblur%3D%22t.value%2B%3D%27ab%20%27%3B%22%3E%0A%3Cinput%20name%3Db%20onfocus%3D%22t.value%2B%3D%27bf1%20%27%3Bc.focus()%3Bt.value%2B%3D%27bf2%20%27%3B%22%20onblur%3D%22t.value%2B%3D%27bb%20%27%3B%22%3E%0A%3Cinput%20name%3Dc%2onfocus%3D%22t.value%2B%3D%27cf1%20%27%3Bc.focus()%3Bt.value%2B%3D%27cf2%20%27%3B%22%20onblur%3D%22t.value%2B%3D%27cb%20%27%3B%22%3E%0A --><!-- http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C!DOCTYPE%20html%3E%3Cbody%20onload%3D%22document.forms%5B0%5D.a.focus()%22%3E%0A...%3Cform%3E%0A%3Ctextarea%20name%3Dt%20cols%3D100%20rows%3D3%3E%3C%2Ftextarea%3E%3Cp%3E%0A%3Cinput%20name%3Da%20onblur%3D%22t.value%2B%3D'ab%20'%3B%20b.focus()%3B%22%3E%0A%3Cinput%20name%3Db%20onfocus%3D%22t.value%2B%3D'bf1%20'%3Ba.focus()%3Bt.value%2B%3D'bf2%20'%3B%22%20onblur%3D%22t.value%2B%3D'bb%20'%3B%22%3E --><!-- http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C!DOCTYPE%20html%3E%3Cbody%3E...%3Cform%3E%0A%3Ctextarea%20name%3Dt%20cols%3D100%20rows%3D3%3E%3C%2Ftextarea%3E%3Cp%3E%0A%3Cinput%20name%3Da%20onfocus%3D%22t.value%2B%3D%27af%20%27%3B%22%20onblur%3D%22t.value%2B%3D%27ab1%20%27%3Bb.focus()%3Bt.value%2B%3D%27ab2%20%27%3B%22%3E%0A%3Cinput%20name%3Db%20onfocus%3D%22t.value%2B%3D%27bf1%20%27%3Ba.focus()%3Bt.valu%2B%3D%27bf2%20%27%3B%22%20onblur%3D%22t.value%2B%3D%27bb%20%27%3B%22%3E --><!-- XXX
+ </div><h3 id="focus"><span class="secno">7.4 </span>Focus</h3><!-- http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C!DOCTYPE%20html%3E%20%0A...%3Cform%3E%3Cinput%20name%3Da%20onfocus%3D%22value%2B%3D1%3Bd.name%3D%27a%27%3Bname%3D%27d%27%3Bb.focus()%22%3E%0A%3Cinput%20name%3Db%20onfocus%3D%22value%2B%3D1%3Bc.focus()%22%3E%0A%3Cinput%20name%3Dc%20onfocus%3D%22value%2B%3D1%3Bd.focus()%22%3E%0A%3Cinput%20name%3Dd%20onfocus%3D%22value%2B%3D1%3Ba.focus()%22%3E --><!-- http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C!DOCTYPE%20html%3E%0A...%3Cform%3E%0A%3Ctextarea%20name%3Dt%20cols%3D100%20rows%3D3%3E%3C%2Ftextarea%3E%3Cp%3E%0A%3Cinput%20name%3Da%20onfocus%3D%22t.value%2B%3D%27af1%20%27%3Bb.focus()%3Balert(document.activeElement.name)%3Bt.value%2B%3D%27af2%20%27%3B%22%20onblur%3D%22t.value%2B%3D%27ab%20%27%3B%22%3E%0A%3Cinput%20name%3Db%20onfocus%3D%22t.value%2B%3D%27bf1%20%27%3Bc.focus()%3Bt.value%2B%3D%27bf2%20%27%3B%22%20onblur%3D%22t.value%2B%3D%27bb%20%27%3B%22%3E%0A%3Cinput%20name%3Dc%2onfocus%3D%22t.value%2B%3D%27cf1%20%27%3Bc.focus()%3Bt.value%2B%3D%27cf2%20%27%3B%22%20onblur%3D%22t.value%2B%3D%27cb%20%27%3B%22%3E%0A --><!-- http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C!DOCTYPE%20html%3E%3Cbody%20onload%3D%22document.forms%5B0%5D.a.focus()%22%3E%0A...%3Cform%3E%0A%3Ctextarea%20name%3Dt%20cols%3D100%20rows%3D3%3E%3C%2Ftextarea%3E%3Cp%3E%0A%3Cinput%20name%3Da%20onblur%3D%22t.value%2B%3D'ab%20'%3B%20b.focus()%3B%22%3E%0A%3Cinput%20name%3Db%20onfocus%3D%22t.value%2B%3D'bf1%20'%3Ba.focus()%3Bt.value%2B%3D'bf2%20'%3B%22%20onblur%3D%22t.value%2B%3D'bb%20'%3B%22%3E --><!-- http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C!DOCTYPE%20html%3E%3Cbody%3E...%3Cform%3E%0A%3Ctextarea%20name%3Dt%20cols%3D100%20rows%3D3%3E%3C%2Ftextarea%3E%3Cp%3E%0A%3Cinput%20name%3Da%20onfocus%3D%22t.value%2B%3D%27af%20%27%3B%22%20onblur%3D%22t.value%2B%3D%27ab1%20%27%3Bb.focus()%3Bt.value%2B%3D%27ab2%20%27%3B%22%3E%0A%3Cinput%20name%3Db%20onfocus%3D%22t.value%2B%3D%27bf1%20%27%3Ba.focus()%3Bt.valu%2B%3D%27bf2%20%27%3B%22%20onblur%3D%22t.value%2B%3D%27bb%20%27%3B%22%3E --><!-- XXX
- define onfocus/onblur behaviour for Window
- Other things to look at are IE's focus APIs (HTMLElement.setActive(),
onBeforeActivate, onActivate, onBeforeDeactivate, onDeactivate):
@@ -49034,7 +49032,7 @@
<p class="note">When an element is focused, the element matches the
CSS <code>:focus</code> pseudo-class.</p>
- </div><h4 id="sequential-focus-navigation"><span class="secno">7.5.1 </span>Sequential focus navigation</h4><p>The <dfn id="attr-tabindex" title="attr-tabindex"><code>tabindex</code></dfn>
+ </div><h4 id="sequential-focus-navigation"><span class="secno">7.4.1 </span>Sequential focus navigation</h4><p>The <dfn id="attr-tabindex" title="attr-tabindex"><code>tabindex</code></dfn>
content attribute specifies whether the element is focusable,
whether it can be reached using sequential focus navigation, and the
relative order of the element for the purposes of sequential focus
@@ -49174,7 +49172,7 @@
</div><div class="impl">
- <h4 id="focus-management"><span class="secno">7.5.2 </span>Focus management</h4>
+ <h4 id="focus-management"><span class="secno">7.4.2 </span>Focus management</h4>
<p>The <dfn id="focusing-steps">focusing steps</dfn> are as follows:</p>
@@ -49228,7 +49226,7 @@
element is removed from its <code>Document</code>, or has a <code title="attr-hidden"><a href="#the-hidden-attribute">hidden</a></code> attribute added. It would also
happen to an <code><a href="#the-input-element">input</a></code> element when the element gets <a href="#concept-fe-disabled" title="concept-fe-disabled">disabled</a>.</p>
- </div><h4 id="document-level-focus-apis"><span class="secno">7.5.3 </span>Document-level focus APIs</h4><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-activeElement"><a href="#dom-document-activeelement">activeElement</a></code></dt>
+ </div><h4 id="document-level-focus-apis"><span class="secno">7.4.3 </span>Document-level focus APIs</h4><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-activeElement"><a href="#dom-document-activeelement">activeElement</a></code></dt>
<dd>
@@ -49298,7 +49296,7 @@
system focus, but hostile sites widely abuse this behavior to the
user's detriment.</p>
- </div><h4 id="element-level-focus-apis"><span class="secno">7.5.4 </span>Element-level focus APIs</h4><dl class="domintro"><dt><var title="">element</var> . <code title="dom-focus"><a href="#dom-focus">focus</a></code>()</dt>
+ </div><h4 id="element-level-focus-apis"><span class="secno">7.4.4 </span>Element-level focus APIs</h4><dl class="domintro"><dt><var title="">element</var> . <code title="dom-focus"><a href="#dom-focus">focus</a></code>()</dt>
<dd>
@@ -49339,7 +49337,7 @@
which the method was called instead. User agents may selectively or
uniformly ignore calls to this method for usability reasons.</p>
- </div><h3 id="the-accesskey-attribute"><span class="secno">7.6 </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
+ </div><h3 id="the-accesskey-attribute"><span class="secno">7.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
<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
that activates or focuses the element.<p>If specified, the value must be an <a href="#ordered-set-of-unique-space-separated-tokens">ordered set of unique
@@ -49470,7 +49468,7 @@
string depends on what the <a href="#assigned-access-key">assigned access key</a> is, and
on how the user agent represents that key combination.</p>
- </div><h3 id="selection"><span class="secno">7.7 </span>The text selection APIs</h3><p>Every <a href="#browsing-context">browsing context</a> has <dfn id="the-selection" title="the
+ </div><h3 id="selection"><span class="secno">7.6 </span>The text selection APIs</h3><p>Every <a href="#browsing-context">browsing context</a> has <dfn id="the-selection" title="the
selection">a selection</dfn>. The selection can be empty, and the
selection can have more than one range (a disjointed selection). The
user agent should allow the user to change the selection. User
@@ -49524,7 +49522,7 @@
are presented to the user. The Selectors specification, in
conjunction with CSS, can be used to style text selections using the
<code title="selector-selection">::selection</code>
- pseudo-element. <a href="#refsSELECTORS">[SELECTORS]</a> <a href="#refsCSS">[CSS]</a><h4 id="documentSelection"><span class="secno">7.7.1 </span>APIs for the browsing context selection</h4><dl class="domintro"><dt><var title="">window</var> . <code title="dom-getSelection"><a href="#dom-getselection">getSelection</a></code>()</dt>
+ pseudo-element. <a href="#refsSELECTORS">[SELECTORS]</a> <a href="#refsCSS">[CSS]</a><h4 id="documentSelection"><span class="secno">7.6.1 </span>APIs for the browsing context selection</h4><dl class="domintro"><dt><var title="">window</var> . <code title="dom-getSelection"><a href="#dom-getselection">getSelection</a></code>()</dt>
<dt><var title="">document</var> . <code title="dom-document-getSelection"><a href="#dom-document-getselection">getSelection</a></code>()</dt>
<dd>
@@ -49827,7 +49825,7 @@
</div><!-- v2DATAGRID v2DGS:
<p class="note">The <code>Selection</code> interface has no relation
to the <code>DataGridSelection</code> interface.</p>
- --><h4 id="textFieldSelection"><span class="secno">7.7.2 </span>APIs for the text field selections</h4><!-- v2 idea: DOM Range APIs to expose the textarea/input edited
+ --><h4 id="textFieldSelection"><span class="secno">7.6.2 </span>APIs for the text field selections</h4><!-- v2 idea: DOM Range APIs to expose the textarea/input edited
value (ack martijnw) --><p>The <code><a href="#the-input-element">input</a></code> and <code><a href="#the-textarea-element">textarea</a></code> elements define
the following members in their DOM interfaces for handling their
text selection:<pre class="idl extract"> void <a href="#dom-textarea-input-select" title="dom-textarea/input-select">select</a>();
@@ -49932,7 +49930,7 @@
</div><p>Characters with no visible rendering, such as U+200D ZERO WIDTH
JOINER, still count as characters. Thus, for instance, the selection
can include just an invisible character, and the text insertion
- cursor can be placed to one side or another of such a character.<h3 id="contenteditable"><span class="secno">7.8 </span>The <code title="attr-contenteditable"><a href="#attr-contenteditable">contenteditable</a></code> attribute</h3><p>The <dfn id="attr-contenteditable" title="attr-contenteditable"><code>contenteditable</code></dfn>
+ cursor can be placed to one side or another of such a character.<h3 id="contenteditable"><span class="secno">7.7 </span>The <code title="attr-contenteditable"><a href="#attr-contenteditable">contenteditable</a></code> attribute</h3><p>The <dfn id="attr-contenteditable" title="attr-contenteditable"><code>contenteditable</code></dfn>
attribute is an <a href="#enumerated-attribute">enumerated attribute</a> whose keywords are
the empty string, <code title="">true</code>, and <code title="">false</code>. The empty string and the <code title="">true</code> keyword map to the <i>true</i> state. The <code title="">false</code> keyword maps to the <i>false</i> state. In
addition, there is a third state, the <i>inherit</i> state, which is
@@ -50027,7 +50025,7 @@
</div><div class="impl">
- <h4 id="user-editing-actions"><span class="secno">7.8.1 </span>User editing actions</h4>
+ <h4 id="user-editing-actions"><span class="secno">7.7.1 </span>User editing actions</h4>
<p>There are several actions that the user agent should allow the
user to perform while the user is interacting with an editing
@@ -50209,7 +50207,7 @@
or programmatically (e.g. by <code title="dom-document-execCommand"><a href="#execCommand">execCommand()</a></code> commands),
must fire mutation events as appropriate.</p>
- </div><h4 id="making-entire-documents-editable"><span class="secno">7.8.2 </span>Making entire documents editable</h4><div class="impl">
+ </div><h4 id="making-entire-documents-editable"><span class="secno">7.7.2 </span>Making entire documents editable</h4><div class="impl">
<p>Documents have a <dfn id="designMode" title="dom-document-designMode"><code>designMode</code></dfn>, which
can be either enabled or disabled.</p>
@@ -50243,7 +50241,7 @@
<p>The last state set must persist until the document is destroyed
or the state is changed. Initially, documents must have their <code title="dom-document-designMode"><a href="#designMode">designMode</a></code> disabled.</p>
- </div><h3 id="spelling-and-grammar-checking"><span class="secno">7.9 </span>Spelling and grammar checking</h3><div class="impl">
+ </div><h3 id="spelling-and-grammar-checking"><span class="secno">7.8 </span>Spelling and grammar checking</h3><div class="impl">
<p>User agents can support the checking of spelling and grammar of
editable text, either in form controls (such as the value of
@@ -50422,7 +50420,7 @@
</div>
- </div><h3 id="dnd"><span class="secno">7.10 </span><dfn>Drag and drop</dfn></h3><!-- v2 ideas for drag and drop:
+ </div><h3 id="dnd"><span class="secno">7.9 </span><dfn>Drag and drop</dfn></h3><!-- v2 ideas for drag and drop:
* being able to animate a drop target:
@@ -50481,7 +50479,7 @@
not canceled, there must be at least one element in the middle
step).</p>
- </div><h4 id="introduction-4"><span class="secno">7.10.1 </span>Introduction</h4><p><i>This section is non-normative.</i><p class="XXX">It's also currently non-existent.<h4 id="the-dragevent-and-datatransfer-interfaces"><span class="secno">7.10.2 </span>The <code><a href="#dragevent">DragEvent</a></code> and <code><a href="#datatransfer">DataTransfer</a></code> interfaces</h4><p>The drag-and-drop processing model involves several events. They
+ </div><h4 id="introduction-4"><span class="secno">7.9.1 </span>Introduction</h4><p><i>This section is non-normative.</i><p class="XXX">It's also currently non-existent.<h4 id="the-dragevent-and-datatransfer-interfaces"><span class="secno">7.9.2 </span>The <code><a href="#dragevent">DragEvent</a></code> and <code><a href="#datatransfer">DataTransfer</a></code> interfaces</h4><p>The drag-and-drop processing model involves several events. They
all use the <code><a href="#dragevent">DragEvent</a></code> interface.<pre class="idl">interface <dfn id="dragevent">DragEvent</dfn> : <span>MouseEvent</span> {
readonly attribute <a href="#datatransfer">DataTransfer</a> <a href="#dom-dragevent-datatransfer" title="dom-DragEvent-dataTransfer">dataTransfer</a>;
@@ -50717,7 +50715,7 @@
current rendering of the elements added, whereas the former uses the
exact specified image.</p>
- </div><h4 id="events-fired-during-a-drag-and-drop-action"><span class="secno">7.10.3 </span>Events fired during a drag-and-drop action</h4><p>The following events are involved in the drag-and-drop
+ </div><h4 id="events-fired-during-a-drag-and-drop-action"><span class="secno">7.9.3 </span>Events fired during a drag-and-drop action</h4><p>The following events are involved in the drag-and-drop
model.<div class="impl">
<p>Whenever the processing model described
@@ -50843,7 +50841,7 @@
<td><code title="">copy</code></td>
</table></div><div class="impl">
- <h4 id="drag-and-drop-processing-model"><span class="secno">7.10.4 </span>Drag-and-drop processing model</h4>
+ <h4 id="drag-and-drop-processing-model"><span class="secno">7.9.4 </span>Drag-and-drop processing model</h4>
<p>When the user attempts to begin a drag operation, the user agent
must first determine what is being dragged. If the drag operation
@@ -51311,7 +51309,7 @@
</ol></div><div class="impl">
- <h5 id="when-the-drag-and-drop-operation-starts-or-ends-in-another-document"><span class="secno">7.10.4.1 </span>When the drag-and-drop operation starts or ends in another
+ <h5 id="when-the-drag-and-drop-operation-starts-or-ends-in-another-document"><span class="secno">7.9.4.1 </span>When the drag-and-drop operation starts or ends in another
document</h5>
<p>The model described above is independent of which
@@ -51326,7 +51324,7 @@
</div><div class="impl">
- <h5 id="when-the-drag-and-drop-operation-starts-or-ends-in-another-application"><span class="secno">7.10.4.2 </span>When the drag-and-drop operation starts or ends in another
+ <h5 id="when-the-drag-and-drop-operation-starts-or-ends-in-another-application"><span class="secno">7.9.4.2 </span>When the drag-and-drop operation starts or ends in another
application</h5>
<p>If the drag is initiated in another application, the <a href="#source-node">source
@@ -51349,7 +51347,7 @@
drag-and-drop operation being started or ended in another document
from another domain.</p>
- </div><h4 id="the-draggable-attribute"><span class="secno">7.10.5 </span>The <dfn title="attr-draggable"><code>draggable</code></dfn> attribute</h4><p>All <a href="#html-elements">HTML elements</a> may have the <code title="attr-draggable"><a href="#the-draggable-attribute">draggable</a></code> content attribute set. The
+ </div><h4 id="the-draggable-attribute"><span class="secno">7.9.5 </span>The <dfn title="attr-draggable"><code>draggable</code></dfn> attribute</h4><p>All <a href="#html-elements">HTML elements</a> may have the <code title="attr-draggable"><a href="#the-draggable-attribute">draggable</a></code> content attribute set. The
<code title="attr-draggable"><a href="#the-draggable-attribute">draggable</a></code> attribute is an
<a href="#enumerated-attribute">enumerated attribute</a>. It has three states. The first
state is <i>true</i> and it has the keyword <code title="">true</code>. The second state is <i>false</i> and it has
@@ -51399,14 +51397,14 @@
value true, the <code title="attr-draggable"><a href="#the-draggable-attribute">draggable</a></code>
content attribute must be set to the literal value <code title="">true</code>.</p>
- </div><h4 id="copy-and-paste"><span class="secno">7.10.6 </span>Copy and paste</h4><p>Copy-and-paste is a form of drag-and-drop: the "copy" part is
+ </div><h4 id="copy-and-paste"><span class="secno">7.9.6 </span>Copy and paste</h4><p>Copy-and-paste is a form of drag-and-drop: the "copy" part is
equivalent to dragging content to another application (the
"clipboard"), and the "paste" part is equivalent to dragging content
<em>from</em> another application.<p>Select-and-paste (a model used by mouse operations in the X
Window System) is equivalent to a drag-and-drop operation where the
source is the selection.<div class="impl">
- <h5 id="copy-to-clipboard"><span class="secno">7.10.6.1 </span>Copy to clipboard</h5>
+ <h5 id="copy-to-clipboard"><span class="secno">7.9.6.1 </span>Copy to clipboard</h5>
<p>When the user invokes a copy operation, the user agent must act
as if the user had invoked a drag on the current selection. If the
@@ -51420,14 +51418,14 @@
operations (e.g. updating the clipboard).</p>
- <h5 id="cut-to-clipboard"><span class="secno">7.10.6.2 </span>Cut to clipboard</h5>
+ <h5 id="cut-to-clipboard"><span class="secno">7.9.6.2 </span>Cut to clipboard</h5>
<p>When the user invokes a cut operation, the user agent must act as
if the user had invoked a copy operation (see the previous section),
followed, if the copy was completed successfully, by <a href="#contenteditable-delete">a selection delete operation</a>.</p>
- <h5 id="paste-from-clipboard"><span class="secno">7.10.6.3 </span>Paste from clipboard</h5>
+ <h5 id="paste-from-clipboard"><span class="secno">7.9.6.3 </span>Paste from clipboard</h5>
<p>When the user invokes a clipboard paste operation, the user agent
must act as if the user had invoked a drag on a hypothetical
@@ -51441,7 +51439,7 @@
canceling it.</p>
- <h5 id="paste-from-selection"><span class="secno">7.10.6.4 </span>Paste from selection</h5>
+ <h5 id="paste-from-selection"><span class="secno">7.9.6.4 </span>Paste from selection</h5>
<p>When the user invokes a selection paste operation, the user agent
must act as if the user had invoked a drag on the current selection,
@@ -51451,7 +51449,7 @@
</div><div class="impl">
- <h4 id="security-risks-in-the-drag-and-drop-model"><span class="secno">7.10.7 </span>Security risks in the drag-and-drop model</h4>
+ <h4 id="security-risks-in-the-drag-and-drop-model"><span class="secno">7.9.7 </span>Security risks in the drag-and-drop model</h4>
<p>User agents must not make the data added to the
<code><a href="#datatransfer">DataTransfer</a></code> object during the <code title="event-dragstart"><a href="#event-dragstart">dragstart</a></code> event available to scripts
@@ -51474,9 +51472,9 @@
data to be dragged from sensitive sources and dropped into hostile
documents without the user's consent.</p>
- </div><h3 id="undo"><span class="secno">7.11 </span><dfn>Undo history</dfn></h3><p class="XXX">There has got to be a better way of doing this, surely.<h4 id="introduction-5"><span class="secno">7.11.1 </span>Introduction</h4><p class="XXX">...<div class="impl">
+ </div><h3 id="undo"><span class="secno">7.10 </span><dfn>Undo history</dfn></h3><p class="XXX">There has got to be a better way of doing this, surely.<h4 id="introduction-5"><span class="secno">7.10.1 </span>Introduction</h4><p class="XXX">...<div class="impl">
- <h4 id="definitions-2"><span class="secno">7.11.2 </span>Definitions</h4>
+ <h4 id="definitions-2"><span class="secno">7.10.2 </span>Definitions</h4>
<p>The user agent must associate an <dfn id="undo-transaction-history">undo transaction
history</dfn> with each <code><a href="#htmldocument">HTMLDocument</a></code> object.</p>
@@ -51514,7 +51512,7 @@
interactions with server-side state, or in the implementation of a
drawing tool).</p>
- </div><h4 id="the-undomanager-interface"><span class="secno">7.11.3 </span>The <code><a href="#undomanager">UndoManager</a></code> interface</h4><div class="impl">
+ </div><h4 id="the-undomanager-interface"><span class="secno">7.10.3 </span>The <code><a href="#undomanager">UndoManager</a></code> interface</h4><div class="impl">
<div class="XXX">
@@ -51709,7 +51707,7 @@
</div><div class="impl">
- <h4 id="undo:-moving-back-in-the-undo-transaction-history"><span class="secno">7.11.4 </span><dfn title="do-undo">Undo: moving back in the undo transaction history</dfn></h4>
+ <h4 id="undo:-moving-back-in-the-undo-transaction-history"><span class="secno">7.10.4 </span><dfn title="do-undo">Undo: moving back in the undo transaction history</dfn></h4>
<p>When the user invokes an undo operation, or when the <code title="dom-document-execCommand"><a href="#execCommand">execCommand()</a></code> method is
called with the <code title="command-undo"><a href="#command-undo">undo</a></code> command, the
@@ -51746,7 +51744,7 @@
command to undo his undo.</p>
- <h4 id="redo:-moving-forward-in-the-undo-transaction-history"><span class="secno">7.11.5 </span><dfn title="do-redo">Redo: moving forward in the undo transaction history</dfn></h4>
+ <h4 id="redo:-moving-forward-in-the-undo-transaction-history"><span class="secno">7.10.5 </span><dfn title="do-redo">Redo: moving forward in the undo transaction history</dfn></h4>
<p>When the user invokes a redo operation, or when the <code title="dom-document-execCommand"><a href="#execCommand">execCommand()</a></code> method is
called with the <code title="command-redo"><a href="#command-redo">redo</a></code> command, the
@@ -51780,7 +51778,7 @@
object, using the <a href="#undo-object">undo object</a> entry's associated undo
object as the event's data.</p>
- </div><h4 id="the-undomanagerevent-interface-and-the-undo-and-redo-events"><span class="secno">7.11.6 </span>The <code><a href="#undomanagerevent">UndoManagerEvent</a></code> interface and the <code title="event-undo"><a href="#event-undo">undo</a></code> and <code title="event-redo"><a href="#event-redo">redo</a></code> events</h4><pre class="idl">interface <dfn id="undomanagerevent">UndoManagerEvent</dfn> : Event {
+ </div><h4 id="the-undomanagerevent-interface-and-the-undo-and-redo-events"><span class="secno">7.10.6 </span>The <code><a href="#undomanagerevent">UndoManagerEvent</a></code> interface and the <code title="event-undo"><a href="#event-undo">undo</a></code> and <code title="event-redo"><a href="#event-redo">redo</a></code> events</h4><pre class="idl">interface <dfn id="undomanagerevent">UndoManagerEvent</dfn> : Event {
readonly attribute any <a href="#dom-undomanagerevent-data" title="dom-UndoManagerEvent-data">data</a>;
void <a href="#dom-undomanagerevent-initundomanagerevent" title="dom-UndoManagerEvent-initUndoManagerEvent">initUndoManagerEvent</a>(in DOMString typeArg, in boolean canBubbleArg, in boolean cancelableArg, in any dataArg);
void <span title="dom-UndoManagerEvent-initUndoManagerEventNS">initUndoManagerEventNS</span>(in DOMString namespaceURIArg, in DOMString typeArg, in boolean canBubbleArg, in boolean cancelableArg, in any dataArg);
@@ -51810,7 +51808,7 @@
</div><div class="impl">
- <h4 id="implementation-notes"><span class="secno">7.11.7 </span>Implementation notes</h4>
+ <h4 id="implementation-notes"><span class="secno">7.10.7 </span>Implementation notes</h4>
<p>How user agents present the above conceptual model to the user is
not defined. The undo interface could be a filtered view of the
@@ -51827,7 +51825,7 @@
described in this section, however, such that to a script there is
no detectable difference.</p>
- </div><h3 id="editing-apis"><span class="secno">7.12 </span>Editing APIs</h3><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-execCommand"><a href="#execCommand">execCommand</a></code>(<var title="">commandId</var> [, <var title="">showUI</var> [, <var title="">value</var> ] ] )</dt>
+ </div><h3 id="editing-apis"><span class="secno">7.11 </span>Editing APIs</h3><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-execCommand"><a href="#execCommand">execCommand</a></code>(<var title="">commandId</var> [, <var title="">showUI</var> [, <var title="">value</var> ] ] )</dt>
<dd>
Received on Tuesday, 18 August 2009 05:22:36 UTC