HTML Standard Tracker

Diff (omit for latest revision)
Filter

Short URL: http://html5.org/r/3555

File a bug

SVNBugCommentTime (UTC)
3555Remove <datagrid> for now. People aren't happy with the current design and we won't have time to address it soon. We'll get back to it in a future version.2009-08-07 20:16
Index: source
===================================================================
--- source	(revision 3554)
+++ source	(revision 3555)
@@ -6397,7 +6397,7 @@
    <li value="20"><dfn><code>ABORT_ERR</code></dfn></li> <!-- actually in XHR for now -->
    <li value="21"><dfn><code>URL_MISMATCH_ERR</code></dfn></li> <!-- actually in workers for now -->
    <li value="22"><dfn><code>QUOTA_EXCEEDED_ERR</code></dfn></li> <!-- actually defined right here for now -->
-   <li value="23"><dfn><code>DATAGRID_MODEL_ERR</code></dfn></li> <!-- actually defined right here for now -->
+<!--v2DATAGRID   <li value="23"><dfn><code>DATAGRID_MODEL_ERR</code></dfn></li> --> <!-- actually defined right here for now -->
    <li value="81"><dfn><code>PARSE_ERR</code></dfn></li> <!-- actually defined in dom3ls -->
    <li value="82"><dfn><code>SERIALISE_ERR</code></dfn></li> <!-- actually defined in dom3ls -->
   </ol>
@@ -8572,7 +8572,7 @@
    <li><code>cite</code></li>
    <li><code>code</code></li>
    <li><code>command</code></li>
-   <li><code>datagrid</code></li>
+<!-- v2DATAGRID   <li><code>datagrid</code></li> -->
    <li><code>datalist</code></li>
    <li><code>del</code></li>
    <li><code>details</code></li>
@@ -8827,7 +8827,7 @@
    <li><code>audio</code> (if the <code title="attr-media-controls">controls</code> attribute is present)</li>
    <li><code>bb</code></li>
    <li><code>button</code></li>
-   <li><code>datagrid</code></li>
+<!-- v2DATAGRID   <li><code>datagrid</code></li> -->
    <li><code>details</code></li>
    <li><code>embed</code></li>
    <li><code>iframe</code></li>
@@ -13697,7 +13697,7 @@
   <ul class="brief category-list">
    <li><code>blockquote</code></li>
    <li><code>body</code></li>
-   <li><code>datagrid</code></li>
+<!-- v2DATAGRID   <li><code>datagrid</code></li> -->
    <li><code>figure</code></li>
    <li><code>td</code></li>
   </ul>
@@ -17058,7 +17058,7 @@
    <li>minimum value &le; optimum point &le; maximum value</li>
   </ul>
 
-  <!-- next two paragraphs are duplicated in the <datagrid> section -->
+  <!-- next two paragraphs are duplicated in the <datagrid> section [v2DATAGRID] -->
 
   <p><strong>UA requirements for regions of the gauge</strong>: If the
   optimum point is equal to the low boundary or the high boundary, or
@@ -38615,10 +38615,11 @@
   <p>The <code>datalist</code> element is hooked up to an
   <code>input</code> element using the <code
   title="attr-input-list">list</code> attribute on the
-  <code>input</code> element. The <code>datalist</code> element can
-  also be used with a <code>datagrid</code> element, as the source of
-  autocompletion hints for <code
-  title="datagrid-type-editable">editable</code> cells.</p>
+  <code>input</code> element. <!-- v2DATAGRID The
+  <code>datalist</code> element can also be used with a
+  <code>datagrid</code> element, as the source of autocompletion hints
+  for <code title="datagrid-type-editable">editable</code>
+  cells. --></p>
 
   <p>Each <code>option</code> element that is a descendant of the
   <code>datalist</code> element, that is not <span
@@ -41863,7 +41864,7 @@
   </div>
 
 
-
+<!-- v2DATAGRID
   <h4 id="datagrid">The <dfn><code>datagrid</code></dfn> element</h4>
 
   <dl class="element">
@@ -41877,20 +41878,20 @@
    <dd><span>Flow content</span>.</dd>
    <dt>Content attributes:</dt>
    <dd><span>Global attributes</span></dd>
-<!--v2DGS:
+<!- -v2DGS:
    <dd><code title="attr-datagrid-multiple">multiple</code></dd>
--->
+- ->
    <dd><code title="attr-datagrid-disabled">disabled</code></dd>
    <dt>DOM interface:</dt>
    <dd>
 <pre class="idl">interface <dfn>HTMLDataGridElement</dfn> : <span>HTMLElement</span> {
-<!--v2DGS:
+<!- -v2DGS:
            attribute boolean <span title="dom-datagrid-multiple">multiple</span>;
--->           attribute boolean <span title="dom-datagrid-disabled">disabled</span>;
+- ->           attribute boolean <span title="dom-datagrid-disabled">disabled</span>;
            attribute <span>DataGridListener</span> <span title="dom-datagrid-listener">listener</span>;
-<!-- v2DGS:
+<!- - v2DGS:
   readonly attribute <span>DataGridSelection</span> <span title="dom-datagrid-selection">selection</span>;
--->
+- ->
   // columns
   void <span title="dom-datagrid-addColumn">addColumn</span>(in <span>Column</span> id, in DOMString label, in DOMString type, [Optional] in HTMLImageElement icon, [Optional] in boolean sortable, [Optional] in boolean hidden);
            attribute DOMString <span title="dom-datagrid-sortColumn">sortColumn</span>;
@@ -41905,12 +41906,12 @@
   void <span title="dom-datagrid-deleteRows">deleteRows</span>(in <span>RowIDList</span> rows);
   void <span title="dom-datagrid-repaint">repaint</span>(in <span>RowID</span> row, in DOMString column);
   void <span title="dom-datagrid-clearRows">clearRows</span>();
-<!--
+<!- -
  v2: opening and closing a row
      moving a row's actual ID
       - imagine new mail moving a thread up; you just want to add the new mail to the thread and move the thread's first mail to the top
       - though actually that should probably just be done using display sorting
--->
+- ->
 };
 
 typedef DOMString <dfn>Column</dfn>;
@@ -41929,18 +41930,22 @@
    </dd>
   </dl>
 
+ <!- - v2:
+   * datagrid: cells that are links (<a href=""></a>)
+  - ->
+
   <p>The <code>datagrid</code> element <span>represents</span> an
   interactive representation of tree, list, or tabular data.</p>
 
   <p>The data being presented is provided by script using the methods
   described in the following sections.</p>
 
-<!--v2DGS:
+<!- -v2DGS:
   <p>The <dfn
   title="attr-datagrid-multiple"><code>multiple</code></dfn> attribute
   is a <span>boolean attribute</span>. When set, it indicates that the
   user can select more than one row at a time.</p>
--->
+- ->
 
   <p>The <dfn
   title="attr-datagrid-disabled"><code>disabled</code></dfn> attribute
@@ -41956,7 +41961,7 @@
 
   <div class="impl">
 
-  <!--vsDGS: multiple -->
+  <!- -vsDGS: multiple - ->
 
   <p>The <dfn
   title="dom-datagrid-disabled"><code>disabled</code></dfn> DOM
@@ -41965,9 +41970,9 @@
 
   </div>
 
-  <!-- v2DGPA: One possible thing to be added is a way to detect when a
+  <!- - v2DGPA: One possible thing to be added is a way to detect when a
   row/selection has been deleted, activated, etc, by the user (delete
-  key, enter key, etc). (v2DGPA = <datagrid> Perform Action) -->
+  key, enter key, etc). (v2DGPA = <datagrid> Perform Action) - ->
 
 
   <h5>Introduction</h5>
@@ -42050,29 +42055,29 @@
   <p>Each cell uses the type given for its column, so all cells in a
   column present the same type of information.</p>
 
-<!--v2DGS:
+<!- -v2DGS:
   <p>Selection of data in a <code>datagrid</code> operates at the row
   level. If the <code title="attr-datagrid-multiple">multiple</code>
   attribute is present, multiple rows can be selected at once,
   otherwise the user can only select one row at a time.</p>
--->
+- ->
 
-  <!-- v2DGDND: selection should draggable to and from datagrids -->
+  <!- - v2DGDND: selection should draggable to and from datagrids - ->
 
 
   <h6>Example: a <code>datagrid</code> backed by a static <code>table</code> element</h6>
 
-  <p class="XXX">...</p>
+  ...
 
 
   <h6>Example: a <code>datagrid</code> backed by nested <code>ol</code> elements</h6>
 
-  <p class="XXX">...</p>
+  ...
 
 
   <h6>Example: a <code>datagrid</code> backed by a server</h6>
 
-  <p class="XXX">...</p>
+  ...
 
 
   <h5>Populating the <code>datagrid</code></h5>
@@ -42105,8 +42110,8 @@
     listener (if any) for any rows or cells that the
     <code>datagrid</code> does not yet have information for.</p>
 
-    <!-- useful, e.g., if there is a server error and the script loses
-    track of what rows it's supposed to be reporting. -->
+    <!- - useful, e.g., if there is a server error and the script loses
+    track of what rows it's supposed to be reporting. - ->
 
    </dd>
 
@@ -42344,8 +42349,8 @@
 
     <p>Throws a <code>DATAGRID_MODEL_ERR</code> exception if the argument
     includes a row the <code>datagrid</code> doesn't know about.</p>
-    <!-- since otherwise behaviour might depend on where the user
-    scrolled! -->
+    <!- - since otherwise behaviour might depend on where the user
+    scrolled! - ->
 
    </dd>
 
@@ -42365,7 +42370,7 @@
    <dd>
 
     <p>Clears the <code>datagrid</code> of all row data, resetting it
-    to empty<!-- v2DGS:, and clears the selection-->.</p>
+    to empty<!- - v2DGS:, and clears the selection- ->.</p>
 
    </dd>
 
@@ -42745,8 +42750,8 @@
 
    </li>
 
-   <!-- v2: queue a task to fire an event, or tell the listener the
-   sort order changed, or something -->
+   <!- - v2: queue a task to fire an event, or tell the listener the
+   sort order changed, or something - ->
 
   </ol>
 
@@ -42890,10 +42895,10 @@
       <p>If the preexisting row is opening, then: increase the
       <span><code>datagrid</code> row count</span> and the row counts
       of any ancestor rows by the number of rows that the preexisting
-      row now has in its row count, then open the row.</p> <!-- we
+      row now has in its row count, then open the row.</p> <!- - we
       should also "update the <span>pending <code>datagrid</code> rows
       list</span> and the <span>pending <code>datagrid</code> cells
-      list</span> accordingly" -->
+      list</span> accordingly" - ->
 
 
      </dd>
@@ -43030,11 +43035,11 @@
       display order position is equal to or greater than the value of
       the <code>Row</code> object's second entry.</p>
 
-     <!--(Not sure how to really say this.)
+     <!- -(Not sure how to really say this.)
       <p>Update the <span>pending <code>datagrid</code> rows
       list</span> and the <span>pending <code>datagrid</code> cells
       list</span> accordingly.</p>
-     -->
+     - ->
 
      </li>
 
@@ -43527,9 +43532,9 @@
   zero, then the user agent must increase the
   <span><code>datagrid</code> row count</span> and the row counts of
   any ancestor rows by the number of rows that the newly opened row
-  has in its row count<!-- we should also "update the <span>pending
+  has in its row count<!- - we should also "update the <span>pending
   <code>datagrid</code> rows list</span> and the <span>pending
-  <code>datagrid</code> cells list</span> accordingly" -->, then must
+  <code>datagrid</code> cells list</span> accordingly" - ->, then must
   mark the row as open, then may fill in the <span>display order
   sparse data tree</span> with any information that the user agent has
   cached about the display order positions of descendants of the newly
@@ -43684,7 +43689,7 @@
     number. Otherwise, the optimum point is the midpoint between the
     minimum value and the maximum value.</p>
 
-    <!-- next two paragraphs copied from <meter>: -->
+    <!- - next two paragraphs copied from <meter>: - ->
 
     <p>If the optimum point is equal to the low boundary or the high
     boundary, or anywhere in between them, then the region between the
@@ -44186,12 +44191,12 @@
 
   void <span title="dom-listener-cellChanged">cellChanged</span>(in <span>RowID</span> row, in <span>Column</span> column, in any newValue, in any prevValue);
   <span>HTMLMenuElement</span> <span title="dom-listener-getRowMenu">getRowMenu</span>(in <span>RowID</span> row);
-<!--vsDGDND
+<!- -vsDGDND
   boolean <span title="dom-listener-canDrop">canDrop</span>(in <span>RowID</span> row, in <span>RowID</span> position, data);
   boolean <span title="dom-listener-dropped">dropped</span>(in <span>RowID</span> row, in <span>RowID</span> position, data);
---><!--v2DGPA
+- -><!- -v2DGPA
   void <span title="dom-listener-performAction">performAction</span>(in <span>RowID</span> row, in DOMString action);
--->};</pre>
+- ->};</pre>
 
   <p>The <code>DataGridListener</code> interface, once implemented by
   an object in a script and hooked up to a <code>datagrid</code> using
@@ -44321,7 +44326,7 @@
    immediately before showing the menu in question, no precautions
    need to be taken if the return value of this method changes.</dd>
 
-   <!--v2DGDND, v2DFPA-->
+   <!- -v2DGDND, v2DFPA- ->
 
   </dl>
 
@@ -44337,7 +44342,7 @@
 
 
 
-<!-- v2DGS: <datagrid> selection (search for the bits marked "..." to see what needs filling in, at a minimum)
+<!- - v2DGS: <datagrid> selection (search for the bits marked "..." to see what needs filling in, at a minimum)
 
   <h5>The selection</h5>
 
@@ -44440,18 +44445,19 @@
   <p class="note">The <code>DataGridSelection</code> interface has no
   relation to the <code>Selection</code> interface.</p>
 
--->
+- ->
 
 
-<!--vsDGDND
+<!- -vsDGDND
   <h5>Drag and drop in <code>datagrid</code>s</h5>
 
   <p><i>This section only applies to interactive user agents.</i></p>
 
   ...define drag and drop in datagrids; selectiondraggable...
+- ->
+
 -->
 
-
   <h4 id="the-command">The <dfn><code>command</code></dfn> element</h4>
 
   <dl class="element">
@@ -64153,7 +64159,7 @@
 
   </div>
 
-  <!-- v2DGS:
+  <!-- v2DATAGRID v2DGS:
   <p>The <code>datagrid</code> and <code>select</code> elements also
   have selections, indicating which items have been picked by the
   user. These are not discussed in this section.</p>
@@ -64528,7 +64534,7 @@
    would be "<code>the Oxford English</code>".</p>
   </div>
 
-  <!-- v2DGS:
+  <!-- v2DATAGRID v2DGS:
   <p class="note">The <code>Selection</code> interface has no relation
   to the <code>DataGridSelection</code> interface.</p>
   -->
@@ -73225,13 +73231,13 @@
   tag</span> may be omitted if the <code>p</code> element is
   immediately followed by an <code>address</code>,
   <code>article</code>, <code>aside</code>, <code>blockquote</code>,
-  <code>datagrid</code>, <code>dialog</code>, <code>dir</code>,
-  <code>div</code>, <code>dl</code>, <code>fieldset</code>,
-  <code>footer</code>, <code>form</code>, <code>h1</code>,
-  <code>h2</code>, <code>h3</code>, <code>h4</code>, <code>h5</code>,
-  <code>h6</code>, <code>header</code>, <code>hgroup</code>,
-  <code>hr</code>, <code>menu</code>, <code>nav</code>,
-  <code>ol</code>, <code>p</code>, <code>pre</code>,
+  <!--v2DATAGRID <code>datagrid</code>,--> <code>dialog</code>,
+  <code>dir</code>, <code>div</code>, <code>dl</code>,
+  <code>fieldset</code>, <code>footer</code>, <code>form</code>,
+  <code>h1</code>, <code>h2</code>, <code>h3</code>, <code>h4</code>,
+  <code>h5</code>, <code>h6</code>, <code>header</code>,
+  <code>hgroup</code>, <code>hr</code>, <code>menu</code>,
+  <code>nav</code>, <code>ol</code>, <code>p</code>, <code>pre</code>,
   <code>section</code>, <code>table</code>, or <code>ul</code>,
   element, or if there is no more content in the parent element and
   the parent element is not an <code>a</code> element.</p>
@@ -74481,27 +74487,27 @@
    <code>basefont</code>, <code>bgsound</code>,
    <code>blockquote</code>, <code>body</code>, <code>br</code>,
    <code>center</code>, <code>col</code>, <code>colgroup</code>,
-   <code>command</code>, <code>datagrid</code>, <code>dd</code>,
-   <code>details</code>, <code>dialog</code>, <code>dir</code>,
-   <code>div</code>, <code>dl</code>, <code>dt</code>,
-   <code>embed</code>, <code>fieldset</code>, <code>figure</code>,
-   <code>footer</code>, <code>form</code>, <code>frame</code>,
-   <code>frameset</code>, <code>h1</code>, <code>h2</code>,
-   <code>h3</code>, <code>h4</code>, <code>h5</code>, <code>h6</code>,
-   <code>head</code>, <code>header</code>, <code>hgroup</code>,
-   <code>hr</code>, <code>iframe</code>, <!-- <code>image</code>,
-   (commented out because this isn't an element that can end up on the
-   stack, so it doesn't matter) --> <code>img</code>,
-   <code>input</code>, <code>isindex</code>, <code>li</code>,
-   <code>link</code>, <code>listing</code>, <code>menu</code>,
-   <code>meta</code>, <code>nav</code>, <code>noembed</code>,
-   <code>noframes</code>, <code>noscript</code>, <code>ol</code>,
-   <code>p</code>, <code>param</code>, <code>plaintext</code>,
-   <code>pre</code>, <code>script</code>, <code>section</code>,
-   <code>select</code>, <code>spacer</code>, <code>style</code>,
-   <code>tbody</code>, <code>textarea</code>, <code>tfoot</code>,
-   <code>thead</code>, <code>title</code>, <code>tr</code>,
-   <code>ul</code>, and <code>wbr</code>.</p></dd>
+   <code>command</code>, <!--v2DDATAGRID--><code>datagrid</code>,
+   <code>dd</code>, <code>details</code>, <code>dialog</code>,
+   <code>dir</code>, <code>div</code>, <code>dl</code>,
+   <code>dt</code>, <code>embed</code>, <code>fieldset</code>,
+   <code>figure</code>, <code>footer</code>, <code>form</code>,
+   <code>frame</code>, <code>frameset</code>, <code>h1</code>,
+   <code>h2</code>, <code>h3</code>, <code>h4</code>, <code>h5</code>,
+   <code>h6</code>, <code>head</code>, <code>header</code>,
+   <code>hgroup</code>, <code>hr</code>, <code>iframe</code>, <!--
+   <code>image</code>, (commented out because this isn't an element
+   that can end up on the stack, so it doesn't matter) -->
+   <code>img</code>, <code>input</code>, <code>isindex</code>,
+   <code>li</code>, <code>link</code>, <code>listing</code>,
+   <code>menu</code>, <code>meta</code>, <code>nav</code>,
+   <code>noembed</code>, <code>noframes</code>, <code>noscript</code>,
+   <code>ol</code>, <code>p</code>, <code>param</code>,
+   <code>plaintext</code>, <code>pre</code>, <code>script</code>,
+   <code>section</code>, <code>select</code>, <code>spacer</code>,
+   <code>style</code>, <code>tbody</code>, <code>textarea</code>,
+   <code>tfoot</code>, <code>thead</code>, <code>title</code>,
+   <code>tr</code>, <code>ul</code>, and <code>wbr</code>.</p></dd>
 
    <dt><dfn>Scoping</dfn></dt>
    <dd><p>The following HTML elements introduce new <span title="has
@@ -77586,9 +77592,10 @@
 
    <!-- the normal ones -->
    <dt>A start tag whose tag name is one of: "address", "article",
-   "aside", "blockquote", "center", "datagrid", "details", "dialog",
-   "dir", "div", "dl", "fieldset", "figure", "footer", "header",
-   "hgroup", "menu", "nav", "ol", "p", "section", "ul"</dt>
+   "aside", "blockquote", "center", <!--v2DATAGRID-->"datagrid",
+   "details", "dialog", "dir", "div", "dl", "fieldset", "figure",
+   "footer", "header", "hgroup", "menu", "nav", "ol", "p", "section",
+   "ul"</dt>
    <dd>
 
     <!-- As of May 2008 this doesn't match any browser exactly, but is
@@ -77797,10 +77804,10 @@
 
    <!-- the normal ones -->
    <dt>An end tag whose tag name is one of: "address", "article",
-   "aside", "blockquote", "center", "datagrid", "details", "dialog",
-   "dir", "div", "dl", "fieldset", "figure", "footer", "header",
-   "hgroup", "listing", "menu", "nav", "ol", "pre", "section",
-   "ul"</dt>
+   "aside", "blockquote", "center", <!--v2DATAGRID-->"datagrid",
+   "details", "dialog", "dir", "div", "dl", "fieldset", "figure",
+   "footer", "header", "hgroup", "listing", "menu", "nav", "ol",
+   "pre", "section", "ul"</dt>
    <dd>
 
     <p>If the <span>stack of open elements</span> does not <span
@@ -82907,16 +82914,16 @@
   contents of the element.</p>
 
 
-
+<!--v2DATAGRID
   <h4>The <code>datagrid</code> element</h4>
 
-  <p class="XXX">This section will probably include details on how to
-  render DATAGRID (including <span id="datagridPseudos">its
-  pseudo-elements</span>), drag-and-drop, etc, in a visual medium, in
-  concert with CSS. Implementation experience is desired before this
-  section is filled in.</p>
+  This section will probably include details on how to render DATAGRID
+  (including <span id="datagridPseudos">its pseudo-elements</span>),
+  drag-and-drop, etc, in a visual medium, in concert with
+  CSS. Implementation experience is desired before this section is
+  filled in.
+-->
 
-
   <h4>The <code>details</code> element</h4>
 
   <pre class="css">@namespace url(http://www.w3.org/1999/xhtml);
@@ -84026,13 +84033,11 @@
 
   <h3>Interaction with CSS</h3>
 
-  <!-- XXX
-
+  <!--
     Extensions to CSS
-      for drag and drop
-      for datagrid
+      for drag and drop (XXX)
+      for datagrid [v2DATAGRID]
       ...
-
   -->
 
   </div>
@@ -86794,7 +86799,6 @@
 
 <!--
 TODO (or delay):
- XXX * datagrid: cells that are links (<a href=""></a>)
  XXX * we should fix The Great Key Problem
  XXX * library of resources:
         var library = new ZipFile("data.zip");

|