[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