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

spec/Overview.html 1.1470 2297 WF2: <optgroup>. (whatwg r2297)

From: poot <cvsmail@w3.org>
Date: Wed, 8 Oct 2008 08:08:30 +0900 (JST)
To: public-html-diffs@w3.org
Message-Id: <20081007230830.678D62BBEA@toro.w3.mag.keio.ac.jp>

WF2: <optgroup>. (whatwg r2297)

4.10.9 The option element
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1470.html#the-option-element
label
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1470.html#attr-optgroup-label
suggestions source element
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1470.html#concept-input-list
HTMLOptGroupElement
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1470.html#htmloptgroupelement
disabled
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1470.html#dom-optgroup-disabled
off
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1470.html#attr-input-autocomplete-off-state
4.10.4.2.2 The list attribute
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1470.html#the-list-attribute
disabled
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1470.html#attr-optgroup-disabled
4.10.8 The optgroup element
http://people.w3.org/mike/diffs/html5/spec/Overview.1.1470.html#the-optgroup-element

http://people.w3.org/mike/diffs/html5/spec/Overview.diff.html
http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.1469&r2=1.1470&f=h
http://html5.org/tools/web-apps-tracker?from=2296&to=2297

===================================================================
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:09:08 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Saturday, 18 December 2010 06:13:56 GMT