[html5] r2297 - [] (0) WF2: <optgroup>.

whatwg at whatwg.org whatwg at whatwg.org
Tue Oct 7 16:05:12 PDT 2008


Author: ianh
Date: 2008-10-07 16:05:11 -0700 (Tue, 07 Oct 2008)
New Revision: 2297

Modified:
   index
   source
Log:
[] (0) WF2: <optgroup>.

Modified: index
===================================================================
--- index	2008-10-07 22:52:37 UTC (rev 2296)
+++ index	2008-10-07 23:05:11 UTC (rev 2297)
@@ -25773,6 +25773,9 @@
   attribute is used to identify an element that lists predefined
   options suggested to the user.</p>
 
+  <p>If present, its value must be the ID of a <code><a href=#the-select-element>select</a></code> or
+  <code><a href=#datagrid>datagrid</a></code> element in the same document.</p>
+
   <p>The <dfn id=concept-input-list title=concept-input-list>suggestions source
   element</dfn> is the first element in the document in <a href=#tree-order>tree
   order</a> to have an ID equal to the value of the <code title=attr-input-list><a href=#attr-input-list>list</a></code> attribute, if that element is
@@ -26581,18 +26584,42 @@
    <dt>Content model:</dt>
    <dd>Zero or more <code><a href=#the-option-element>option</a></code> elements.</dd>
    <dt>Element-specific attributes:</dt>
-   <dd><code title=attr-optgroup-disabled>disabled</code></dd>
-   <dd><code title=attr-optgroup-label>label</code></dd>
+   <dd><code title=attr-optgroup-disabled><a href=#attr-optgroup-disabled>disabled</a></code></dd>
+   <dd><code title=attr-optgroup-label><a href=#attr-optgroup-label>label</a></code></dd>
    <dt>DOM interface:</dt>
    <dd>
 <pre class=idl>interface <dfn id=htmloptgroupelement>HTMLOptGroupElement</dfn> : <a href=#htmlelement>HTMLElement</a> {
-           attribute boolean <span title=dom-optgroup-disabled>disabled</span>;
-           attribute DOMString <span title=dom-optgroup-label>label</span>;
+           attribute boolean <a href=#dom-optgroup-disabled title=dom-optgroup-disabled>disabled</a>;
+           attribute DOMString <a href=#dom-optgroup-label title=dom-optgroup-label>label</a>;
 };</pre>
    </dd> 
-  </dl><p class=XXX>...</p>
+  </dl><p>The <code><a href=#the-optgroup-element>optgroup</a></code> element represents a group of
+  <code><a href=#the-option-element>option</a></code> elements with a common label.</p>
 
+  <p>The element's group of <code><a href=#the-option-element>option</a></code> elements consists of
+  the <code><a href=#the-option-element>option</a></code> elements that are children of the
+  <code><a href=#the-optgroup-element>optgroup</a></code> element.</p>
 
+  <p>When showing <code><a href=#the-option-element>option</a></code> elements in <code><a href=#the-select-element>select</a></code>
+  elements, user agents should show the <code><a href=#the-option-element>option</a></code> elements
+  of such groups as being related to each other and separate from
+  other <code><a href=#the-option-element>option</a></code> elements.</p>
+
+  <p>The <dfn id=attr-optgroup-disabled title=attr-optgroup-disabled><code>disabled</code></dfn> attribute
+  is a <a href=#boolean-attribute>boolean attribute</a> and can be used to <a href=#concept-option-disabled title=concept-option-disabled>disable</a> a group of
+  <code><a href=#the-option-element>option</a></code> elements together.</p>
+
+  <p>The <dfn id=attr-optgroup-label title=attr-optgroup-label><code>label</code></dfn>
+  attribute must be specified. Its value gives the name of the group,
+  for the purposes of the user interface. User agents should use this
+  attribute's value when labelling the group of <code><a href=#the-option-element>option</a></code>
+  elements in a <code><a href=#the-select-element>select</a></code> element.</p>
+
+  <p>The <dfn id=dom-optgroup-disabled title=dom-optgroup-disabled><code>disabled</code></dfn> and <dfn id=dom-optgroup-label title=dom-optgroup-label><code>label</code></dfn> attributes must
+  <a href=#reflect>reflect</a> the respective content attributes of the same
+  name.</p>
+
+
   <h4 id=the-option-element><span class=secno>4.10.9 </span>The <dfn><code>option</code></dfn> element</h4>
 
   <dl class=element><dt>Categories</dt>
@@ -28363,7 +28390,7 @@
      contains the <code title="">open</code> class: <code title=datagrid-row-class-initially-open><a href=#datagrid-row-class-initially-open>initially-open</a></code></li>
 
     </ul><p>The <code title=dom-provider-getCellData><a href=#dom-provider-getcelldata>getCellData(<var title="">row</var>, <var title="">cell</var>)</a></code> method must
-    return the value of the <code title=attr-optgroup-label>label</code> attribute if the <var title="">row</var>'s corresponding element is an
+    return the value of the <code title=attr-optgroup-label><a href=#attr-optgroup-label>label</a></code> attribute if the <var title="">row</var>'s corresponding element is an
     <code><a href=#the-optgroup-element>optgroup</a></code> element, otherwise, if the <var title="">row</var>'s corresponding element is an
     <code><a href=#the-option-element>option</a></code>element, its <code title=attr-option-label>label</code> attribute if it has one,
     otherwise the value of its <code><a href=#textcontent>textContent</a></code> DOM

Modified: source
===================================================================
--- source	2008-10-07 22:52:37 UTC (rev 2296)
+++ source	2008-10-07 23:05:11 UTC (rev 2297)
@@ -28741,6 +28741,9 @@
   attribute is used to identify an element that lists predefined
   options suggested to the user.</p>
 
+  <p>If present, its value must be the ID of a <code>select</code> or
+  <code>datagrid</code> element in the same document.</p>
+
   <p>The <dfn title="concept-input-list">suggestions source
   element</dfn> is the first element in the document in <span>tree
   order</span> to have an ID equal to the value of the <code
@@ -29789,9 +29792,37 @@
    </dd> 
   </dl>
 
-  <p class="XXX">...</p>
+  <p>The <code>optgroup</code> element represents a group of
+  <code>option</code> elements with a common label.</p>
 
+  <p>The element's group of <code>option</code> elements consists of
+  the <code>option</code> elements that are children of the
+  <code>optgroup</code> element.</p>
 
+  <p>When showing <code>option</code> elements in <code>select</code>
+  elements, user agents should show the <code>option</code> elements
+  of such groups as being related to each other and separate from
+  other <code>option</code> elements.</p>
+
+  <p>The <dfn
+  title="attr-optgroup-disabled"><code>disabled</code></dfn> attribute
+  is a <span>boolean attribute</span> and can be used to <span
+  title="concept-option-disabled">disable</span> a group of
+  <code>option</code> elements together.</p>
+
+  <p>The <dfn title="attr-optgroup-label"><code>label</code></dfn>
+  attribute must be specified. Its value gives the name of the group,
+  for the purposes of the user interface. User agents should use this
+  attribute's value when labelling the group of <code>option</code>
+  elements in a <code>select</code> element.</p>
+
+  <p>The <dfn
+  title="dom-optgroup-disabled"><code>disabled</code></dfn> and <dfn
+  title="dom-optgroup-label"><code>label</code></dfn> attributes must
+  <span>reflect</span> the respective content attributes of the same
+  name.</p>
+
+
   <h4>The <dfn><code>option</code></dfn> element</h4>
 
   <dl class="element">




More information about the Commit-Watchers mailing list