W3C home > Mailing lists > Public > public-html-commits@w3.org > October 2008

html5/spec Overview.html,1.1469,1.1470

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Tue, 07 Oct 2008 23:05:18 +0000
To: public-html-commits@w3.org
Message-Id: <E1KnLcE-0001Nc-7N@lionel-hutz.w3.org>

Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv5283

Modified Files:
	Overview.html 
Log Message:
WF2: <optgroup>. (whatwg r2297)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1469
retrieving revision 1.1470
diff -u -d -r1.1469 -r1.1470
--- Overview.html	7 Oct 2008 22:52:42 -0000	1.1469
+++ Overview.html	7 Oct 2008 23:05:15 -0000	1.1470
@@ -20744,7 +20744,8 @@
   security implications for the user if support for this attribute is
   disabled.<h6 id=the-list-attribute><span class=secno>4.10.4.2.2 </span>The <code title=attr-input-list><a href=#attr-input-list>list</a></code> attribute</h6><p>The <dfn id=attr-input-list title=attr-input-list><code>list</code></dfn>
   attribute is used to identify an element that lists predefined
-  options suggested to the user.<p>The <dfn id=concept-input-list title=concept-input-list>suggestions source
+  options suggested to the user.<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>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
   either a <code><a href=#the-select-element>select</a></code> or <code><a href=#the-datalist-element>datalist</a></code> element. If
@@ -21329,16 +21330,30 @@
    <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>...<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>
+  </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>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>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>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>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>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.<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>
    <dd>None.</dd>
    <dt>Contexts in which this element may be used:</dt>
    <dd>As a child of a <code><a href=#the-select-element>select</a></code> element.</dd>
@@ -22792,7 +22807,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
Received on Tuesday, 7 October 2008 23:05:56 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 9 October 2008 20:33:00 GMT