[html5] r1367 - /
whatwg at whatwg.org
whatwg at whatwg.org
Sat Mar 8 01:11:17 PST 2008
Author: ianh
Date: 2008-03-08 01:11:16 -0800 (Sat, 08 Mar 2008)
New Revision: 1367
Modified:
index
source
Log:
[] (0) Define insertOrderedList and insertUnorderedList; make note of some commands we'll have to add when we have a presentational story; change the way the command list is marked up.
Modified: index
===================================================================
--- index 2008-03-08 08:37:26 UTC (rev 1366)
+++ index 2008-03-08 09:11:16 UTC (rev 1367)
@@ -35652,11 +35652,11 @@
the value expressed below under "Value" for the given <var
title="">commandId</var>.
- <p>The commands are:
+ <p>The possible values for <var title="">commandId</var>, and their
+ corresponding meanings, are:
<dl>
- <dt>If the <var title="">commandId</var> is <dfn id=undo1
- title=command-undo><code>undo</code></dfn>
+ <dt><dfn id=undo1 title=command-undo><code>undo</code></dfn>
<dd><strong>Action:</strong> The user agent must <a href="#undo-moving0"
title=do-undo>move back one step</a> in its <a
@@ -35677,8 +35677,7 @@
<dd><strong>Value:</strong> Always the string "<code
title="">false</code>".
- <dt>If the <var title="">commandId</var> is <dfn id=redo0
- title=command-redo><code>redo</code></dfn>
+ <dt><dfn id=redo0 title=command-redo><code>redo</code></dfn>
<dd><strong>Action:</strong> The user agent must <a href="#redo-moving0"
title=do-redo>move forward one step</a> in its <a
@@ -35699,7 +35698,7 @@
<dd><strong>Value:</strong> Always the string "<code
title="">false</code>".
- <dt>If the <var title="">commandId</var> is <dfn id=selectall0
+ <dt><dfn id=selectall0
title=command-selectAll><code>selectAll</code></dfn>
<dd><strong>Action:</strong> The user agent must change the selection so
@@ -35716,8 +35715,7 @@
<dd><strong>Value:</strong> Always the string "<code
title="">false</code>".
- <dt>If the <var title="">commandId</var> is <dfn id=unselect
- title=command-unselect><code>unselect</code></dfn>
+ <dt><dfn id=unselect title=command-unselect><code>unselect</code></dfn>
<dd><strong>Action:</strong> The user agent must change the selection so
that nothing is selected.
@@ -35731,7 +35729,7 @@
<dd><strong>Value:</strong> Always the string "<code
title="">false</code>".
- <dt>If the <var title="">commandId</var> is <dfn id=superscript
+ <dt><dfn id=superscript
title=command-superscript><code>superscript</code></dfn>
<dd><strong>Action:</strong> The user agent must act as if the user had
@@ -35753,8 +35751,7 @@
expression given for the "State" above is true, the string "<code
title="">false</code>" otherwise.
- <dt>If the <var title="">commandId</var> is <dfn id=subscript
- title=command-subscript><code>subscript</code></dfn>
+ <dt><dfn id=subscript title=command-subscript><code>subscript</code></dfn>
<dd><strong>Action:</strong> The user agent must act as if the user had
requested that the selection <a href="#contenteditable-wrapSemantic">be
@@ -35775,8 +35772,7 @@
expression given for the "State" above is true, the string "<code
title="">false</code>" otherwise.
- <dt>If the <var title="">commandId</var> is <dfn id=bold
- title=command-bold><code>bold</code></dfn>
+ <dt><dfn id=bold title=command-bold><code>bold</code></dfn>
<dd><strong>Action:</strong> The user agent must act as if the user had
requested that the selection <a href="#contenteditable-wrapSemantic">be
@@ -35797,8 +35793,7 @@
expression given for the "State" above is true, the string "<code
title="">false</code>" otherwise.
- <dt>If the <var title="">commandId</var> is <dfn id=italic
- title=command-italic><code>italic</code></dfn>
+ <dt><dfn id=italic title=command-italic><code>italic</code></dfn>
<dd><strong>Action:</strong> The user agent must act as if the user had
requested that the selection <a href="#contenteditable-wrapSemantic">be
@@ -35819,7 +35814,7 @@
expression given for the "State" above is true, the string "<code
title="">false</code>" otherwise.
- <dt>If the <var title="">commandId</var> is <dfn id=createlink
+ <dt><dfn id=createlink
title=command-createLink><code>createLink</code></dfn>
<dd><strong>Action:</strong> The user agent must act as if the user had
@@ -35844,8 +35839,7 @@
<dd><strong>Value:</strong> Always the string "<code
title="">false</code>".
- <dt>If the <var title="">commandId</var> is <dfn id=unlink
- title=command-unlink><code>unlink</code></dfn>
+ <dt><dfn id=unlink title=command-unlink><code>unlink</code></dfn>
<dd><strong>Action:</strong> The user agent must remove all <code><a
href="#a">a</a></code> elements that have <code
@@ -35862,7 +35856,7 @@
<dd><strong>Value:</strong> Always the string "<code
title="">false</code>".
- <dt>If the <var title="">commandId</var> is <dfn id=formatblock
+ <dt><dfn id=formatblock
title=command-formatBlock><code>formatBlock</code></dfn>
<dd>
@@ -35881,6 +35875,8 @@
<li><code title=""><aside></code>
+ <li><code title=""><div></code>
+
<li><code title=""><h1></code>
<li><code title=""><h2></code>
@@ -35923,8 +35919,7 @@
<dd><strong>Value:</strong> Always the string "<code
title="">false</code>".
- <dt>If the <var title="">commandId</var> is <dfn id=delete
- title=command-delete><code>delete</code></dfn>
+ <dt><dfn id=delete title=command-delete><code>delete</code></dfn>
<dd><strong>Action:</strong> The user agent must act as if the user had
performed <a href="#contenteditable-delete">a backspace operation</a>.
@@ -35939,7 +35934,7 @@
<dd><strong>Value:</strong> Always the string "<code
title="">false</code>".
- <dt>If the <var title="">commandId</var> is <dfn id=forwarddelete
+ <dt><dfn id=forwarddelete
title=command-forwardDelete><code>forwardDelete</code></dfn>
<dd><strong>Action:</strong> The user agent must act as if the user had
@@ -35956,7 +35951,7 @@
<dd><strong>Value:</strong> Always the string "<code
title="">false</code>".
- <dt>If the <var title="">commandId</var> is <dfn id=insertlinebreak
+ <dt><dfn id=insertlinebreak
title=command-insertLineBreak><code>insertLineBreak</code></dfn>
<dd><strong>Action:</strong> The user agent must act as if the user had <a
@@ -35972,7 +35967,7 @@
<dd><strong>Value:</strong> Always the string "<code
title="">false</code>".
- <dt>If the <var title="">commandId</var> is <dfn id=insertparagraph
+ <dt><dfn id=insertparagraph
title=command-insertParagraph><code>insertParagraph</code></dfn>
<dd><strong>Action:</strong> The user agent must act as if the user had
@@ -35989,7 +35984,45 @@
<dd><strong>Value:</strong> Always the string "<code
title="">false</code>".
- <dt>If the <var title="">commandId</var> is <dfn id=inserttext
+ <dt><dfn id=insertorderedlist
+ title=command-insertOrderedList><code>insertOrderedList</code></dfn>
+
+ <dd><strong>Action:</strong> The user agent must act as if the user had
+ requested that the selection <a href="#contenteditable-wrapSemantic">be
+ wrapped in the semantics</a> of the <code><a href="#ol">ol</a></code>
+ element (or unwrapped, or, if there is no selection, have that semantic
+ inserted or removed — the exact behaviour is UA-defined).
+
+ <dd><strong>Enabled When:</strong> The document is <a href="#ready">ready
+ for editing host commands</a>.
+
+ <dd><strong>Indeterminate When:</strong> Never.
+
+ <dd><strong>State:</strong> Always false.
+
+ <dd><strong>Value:</strong> Always the string "<code
+ title="">false</code>".
+
+ <dt><dfn id=insertorderedlist0
+ title=command-insertOrderedList><code>insertOrderedList</code></dfn>
+
+ <dd><strong>Action:</strong> The user agent must act as if the user had
+ requested that the selection <a href="#contenteditable-wrapSemantic">be
+ wrapped in the semantics</a> of the <code><a href="#ul">ul</a></code>
+ element (or unwrapped, or, if there is no selection, have that semantic
+ inserted or removed — the exact behaviour is UA-defined).
+
+ <dd><strong>Enabled When:</strong> The document is <a href="#ready">ready
+ for editing host commands</a>.
+
+ <dd><strong>Indeterminate When:</strong> Never.
+
+ <dd><strong>State:</strong> Always false.
+
+ <dd><strong>Value:</strong> Always the string "<code
+ title="">false</code>".
+
+ <dt><dfn id=inserttext
title=command-insertText><code>insertText</code></dfn>
<dd><strong>Action:</strong> The user agent must act as if the user had <a
@@ -36006,8 +36039,8 @@
<dd><strong>Value:</strong> Always the string "<code
title="">false</code>".
- <dt>If the <var title="">commandId</var> is <code><var
- title="">vendorID</var>-<var title="">customCommandID</var></code>
+ <dt><code><var title="">vendorID</var>-<var
+ title="">customCommandID</var></code>
<dd><strong>Action:</strong> User agents may implement vendor-specific
extensions to this API. Vendor-specific extensions to the list of
@@ -36024,7 +36057,7 @@
<dd><strong>Value:</strong> UA-defined.
- <dt>If the <var title="">commandId</var> is something else
+ <dt>Anything else
<dd><strong>Action:</strong> User agents must do nothing.
@@ -36037,6 +36070,11 @@
<dd><strong>Value:</strong> Always the string "<code
title="">false</code>".
</dl>
+ <!--
+XXX Once we resolve the style="" issue, address these:
+ "forecolor", "hilitecolor", "fontname", "fontsize", "justifyleft",
+ "justifycenter", "justifyright", "justifyfull", "indent", "outdent"
+-->
<h2 id=comms><span class=secno>6. </span>Communication</h2>
Modified: source
===================================================================
--- source 2008-03-08 08:37:26 UTC (rev 1366)
+++ source 2008-03-08 09:11:16 UTC (rev 1367)
@@ -33097,11 +33097,12 @@
return the value expressed below under "Value" for the given <var
title="">commandId</var>.</p>
- <p>The commands are:</p>
+ <p>The possible values for <var title="">commandId</var>, and their
+ corresponding meanings, are:</p>
<dl>
- <dt>If the <var title="">commandId</var> is <dfn title="command-undo"><code>undo</code></dfn></dt>
+ <dt><dfn title="command-undo"><code>undo</code></dfn></dt>
<dd><strong>Action:</strong> The user agent must <span
title="do-undo">move back one step</span> in its <span>undo
@@ -33116,7 +33117,7 @@
<dd><strong>State:</strong> Always false.</dd>
<dd><strong>Value:</strong> Always the string "<code title="">false</code>".</dd>
- <dt>If the <var title="">commandId</var> is <dfn title="command-redo"><code>redo</code></dfn></dt>
+ <dt><dfn title="command-redo"><code>redo</code></dfn></dt>
<dd><strong>Action:</strong> The user agent must <span
title="do-redo">move forward one step</span> in its <span>undo
@@ -33131,7 +33132,7 @@
<dd><strong>State:</strong> Always false.</dd>
<dd><strong>Value:</strong> Always the string "<code title="">false</code>".</dd>
- <dt>If the <var title="">commandId</var> is <dfn title="command-selectAll"><code>selectAll</code></dfn></dt>
+ <dt><dfn title="command-selectAll"><code>selectAll</code></dfn></dt>
<dd><strong>Action:</strong> The user agent must change the
selection so that all the content in the currently focused
@@ -33143,7 +33144,7 @@
<dd><strong>State:</strong> Always false.</dd>
<dd><strong>Value:</strong> Always the string "<code title="">false</code>".</dd>
- <dt>If the <var title="">commandId</var> is <dfn title="command-unselect"><code>unselect</code></dfn></dt>
+ <dt><dfn title="command-unselect"><code>unselect</code></dfn></dt>
<dd><strong>Action:</strong> The user agent must change the
selection so that nothing is selected.</dd>
@@ -33152,7 +33153,7 @@
<dd><strong>State:</strong> Always false.</dd>
<dd><strong>Value:</strong> Always the string "<code title="">false</code>".</dd>
- <dt>If the <var title="">commandId</var> is <dfn title="command-superscript"><code>superscript</code></dfn></dt>
+ <dt><dfn title="command-superscript"><code>superscript</code></dfn></dt>
<dd><strong>Action:</strong> The user agent must act as if the user
had requested that the selection <a
@@ -33170,7 +33171,7 @@
if the expression given for the "State" above is true, the string
"<code title="">false</code>" otherwise.</dd>
- <dt>If the <var title="">commandId</var> is <dfn title="command-subscript"><code>subscript</code></dfn></dt>
+ <dt><dfn title="command-subscript"><code>subscript</code></dfn></dt>
<dd><strong>Action:</strong> The user agent must act as if the user
had requested that the selection <a
@@ -33188,7 +33189,7 @@
if the expression given for the "State" above is true, the string
"<code title="">false</code>" otherwise.</dd>
- <dt>If the <var title="">commandId</var> is <dfn title="command-bold"><code>bold</code></dfn></dt>
+ <dt><dfn title="command-bold"><code>bold</code></dfn></dt>
<dd><strong>Action:</strong> The user agent must act as if the user
had requested that the selection <a
@@ -33206,7 +33207,7 @@
if the expression given for the "State" above is true, the string
"<code title="">false</code>" otherwise.</dd>
- <dt>If the <var title="">commandId</var> is <dfn title="command-italic"><code>italic</code></dfn></dt>
+ <dt><dfn title="command-italic"><code>italic</code></dfn></dt>
<dd><strong>Action:</strong> The user agent must act as if the user
had requested that the selection <a
@@ -33224,7 +33225,7 @@
if the expression given for the "State" above is true, the string
"<code title="">false</code>" otherwise.</dd>
- <dt>If the <var title="">commandId</var> is <dfn title="command-createLink"><code>createLink</code></dfn></dt>
+ <dt><dfn title="command-createLink"><code>createLink</code></dfn></dt>
<dd><strong>Action:</strong> The user agent must act as if the user
had requested that the selection <a
@@ -33243,7 +33244,7 @@
<dd><strong>State:</strong> Always false.</dd>
<dd><strong>Value:</strong> Always the string "<code title="">false</code>".</dd>
- <dt>If the <var title="">commandId</var> is <dfn title="command-unlink"><code>unlink</code></dfn></dt>
+ <dt><dfn title="command-unlink"><code>unlink</code></dfn></dt>
<dd><strong>Action:</strong> The user agent must remove all
<code>a</code> elements that have <code
@@ -33255,7 +33256,7 @@
<dd><strong>State:</strong> Always false.</dd>
<dd><strong>Value:</strong> Always the string "<code title="">false</code>".</dd>
- <dt>If the <var title="">commandId</var> is <dfn title="command-formatBlock"><code>formatBlock</code></dfn></dt>
+ <dt><dfn title="command-formatBlock"><code>formatBlock</code></dfn></dt>
<dd>
@@ -33272,6 +33273,7 @@
<ul class="brief">
<li><code title=""><address></code></li>
<li><code title=""><aside></code></li>
+ <li><code title=""><div></code></li>
<li><code title=""><h1></code></li>
<li><code title=""><h2></code></li>
<li><code title=""><h3></code></li>
@@ -33304,7 +33306,7 @@
<dd><strong>State:</strong> Always false.</dd>
<dd><strong>Value:</strong> Always the string "<code title="">false</code>".</dd>
- <dt>If the <var title="">commandId</var> is <dfn title="command-delete"><code>delete</code></dfn></dt>
+ <dt><dfn title="command-delete"><code>delete</code></dfn></dt>
<dd><strong>Action:</strong> The user agent must act as if the user
had performed <a href="#contenteditable-delete">a backspace
@@ -33315,7 +33317,7 @@
<dd><strong>State:</strong> Always false.</dd>
<dd><strong>Value:</strong> Always the string "<code title="">false</code>".</dd>
- <dt>If the <var title="">commandId</var> is <dfn title="command-forwardDelete"><code>forwardDelete</code></dfn></dt>
+ <dt><dfn title="command-forwardDelete"><code>forwardDelete</code></dfn></dt>
<dd><strong>Action:</strong> The user agent must act as if the user
had performed <a href="#contenteditable-delete">a forward delete
@@ -33326,7 +33328,7 @@
<dd><strong>State:</strong> Always false.</dd>
<dd><strong>Value:</strong> Always the string "<code title="">false</code>".</dd>
- <dt>If the <var title="">commandId</var> is <dfn title="command-insertLineBreak"><code>insertLineBreak</code></dfn></dt>
+ <dt><dfn title="command-insertLineBreak"><code>insertLineBreak</code></dfn></dt>
<dd><strong>Action:</strong> The user agent must act as if the user
had <a href="#contenteditable-br">requested a line
@@ -33337,7 +33339,7 @@
<dd><strong>State:</strong> Always false.</dd>
<dd><strong>Value:</strong> Always the string "<code title="">false</code>".</dd>
- <dt>If the <var title="">commandId</var> is <dfn title="command-insertParagraph"><code>insertParagraph</code></dfn></dt>
+ <dt><dfn title="command-insertParagraph"><code>insertParagraph</code></dfn></dt>
<dd><strong>Action:</strong> The user agent must act as if the user
had performed a <a href="#contenteditable-breakBlock">break
@@ -33348,9 +33350,37 @@
<dd><strong>State:</strong> Always false.</dd>
<dd><strong>Value:</strong> Always the string "<code title="">false</code>".</dd>
- <dt>If the <var title="">commandId</var> is <dfn title="command-insertText"><code>insertText</code></dfn></dt>
+ <dt><dfn title="command-insertOrderedList"><code>insertOrderedList</code></dfn></dt>
<dd><strong>Action:</strong> The user agent must act as if the user
+ had requested that the selection <a
+ href="#contenteditable-wrapSemantic">be wrapped in the
+ semantics</a> of the <code>ol</code> element (or unwrapped, or, if
+ there is no selection, have that semantic inserted or removed
+ — the exact behaviour is UA-defined).</dd>
+ <dd><strong>Enabled When:</strong> The document is <span>ready for
+ editing host commands</span>.</dd>
+ <dd><strong>Indeterminate When:</strong> Never.</dd>
+ <dd><strong>State:</strong> Always false.</dd>
+ <dd><strong>Value:</strong> Always the string "<code title="">false</code>".</dd>
+
+ <dt><dfn title="command-insertOrderedList"><code>insertOrderedList</code></dfn></dt>
+
+ <dd><strong>Action:</strong> The user agent must act as if the user
+ had requested that the selection <a
+ href="#contenteditable-wrapSemantic">be wrapped in the
+ semantics</a> of the <code>ul</code> element (or unwrapped, or, if
+ there is no selection, have that semantic inserted or removed
+ — the exact behaviour is UA-defined).</dd>
+ <dd><strong>Enabled When:</strong> The document is <span>ready for
+ editing host commands</span>.</dd>
+ <dd><strong>Indeterminate When:</strong> Never.</dd>
+ <dd><strong>State:</strong> Always false.</dd>
+ <dd><strong>Value:</strong> Always the string "<code title="">false</code>".</dd>
+
+ <dt><dfn title="command-insertText"><code>insertText</code></dfn></dt>
+
+ <dd><strong>Action:</strong> The user agent must act as if the user
had <a href="#contenteditable-insertText">inserted text</a>
corresponding to the <var title="">value</var> parameter.</dd>
<dd><strong>Enabled When:</strong> The document is <span>ready for
@@ -33359,7 +33389,7 @@
<dd><strong>State:</strong> Always false.</dd>
<dd><strong>Value:</strong> Always the string "<code title="">false</code>".</dd>
- <dt>If the <var title="">commandId</var> is <code><var title="">vendorID</var>-<var title="">customCommandID</var></code></dt>
+ <dt><code><var title="">vendorID</var>-<var title="">customCommandID</var></code></dt>
<dd><strong>Action:</strong> User agents may implement
vendor-specific extensions to this API. Vendor-specific extensions
@@ -33372,7 +33402,7 @@
<dd><strong>State:</strong> UA-defined.</dd>
<dd><strong>Value:</strong> UA-defined.</dd>
- <dt>If the <var title="">commandId</var> is something else</dt>
+ <dt>Anything else</dt>
<dd><strong>Action:</strong> User agents must do nothing.</dd>
<dd><strong>Enabled When:</strong> Never.</dd>
@@ -33382,6 +33412,11 @@
</dl>
+<!--
+XXX Once we resolve the style="" issue, address these:
+ "forecolor", "hilitecolor", "fontname", "fontsize", "justifyleft",
+ "justifycenter", "justifyright", "justifyfull", "indent", "outdent"
+-->
More information about the Commit-Watchers
mailing list