- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 04 Sep 2008 11:23:00 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv27299
Modified Files:
Overview.html
Log Message:
WF2: <option> element summary. (whatwg r2152)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1324
retrieving revision 1.1325
diff -u -d -r1.1324 -r1.1325
--- Overview.html 4 Sep 2008 11:10:26 -0000 1.1324
+++ Overview.html 4 Sep 2008 11:22:58 -0000 1.1325
@@ -1058,22 +1058,19 @@
<li><a href="#the-option"><span class=secno>4.9.9 </span>The
<code>option</code> element</a>
- <li><a href="#constructors"><span class=secno>4.9.10
- </span>Constructors</a>
-
- <li><a href="#the-textarea"><span class=secno>4.9.11 </span>The
+ <li><a href="#the-textarea"><span class=secno>4.9.10 </span>The
<code>textarea</code> element</a>
- <li><a href="#the-output"><span class=secno>4.9.12 </span>The
+ <li><a href="#the-output"><span class=secno>4.9.11 </span>The
<code>output</code> element</a>
- <li><a href="#association"><span class=secno>4.9.13 </span>Association
+ <li><a href="#association"><span class=secno>4.9.12 </span>Association
of controls and forms</a>
- <li><a href="#processing1"><span class=secno>4.9.14 </span>Processing
+ <li><a href="#processing1"><span class=secno>4.9.13 </span>Processing
model</a>
<ul class=toc>
- <li><a href="#form-submission"><span class=secno>4.9.14.1.
+ <li><a href="#form-submission"><span class=secno>4.9.13.1.
</span>Form submission</a>
</ul>
</ul>
@@ -6780,12 +6777,12 @@
<p>The <code><a
href="#htmloptionscollection0">HTMLOptionsCollection</a></code> interface
- represents a list of <code>option</code> elements.
+ represents a list of <code><a href="#option">option</a></code> elements.
<pre
class=idl>interface <dfn id=htmloptionscollection0>HTMLOptionsCollection</dfn> {
attribute unsigned long <a href="#length1" title=dom-HTMLOptionsCollection-length>length</a>;
- [IndexGetter] <span>HTMLOptionElement</span> <a href="#itemindex1" title=dom-HTMLOptionsCollection-item>item</a>(in unsigned long index);
+ [IndexGetter] <a href="#htmloptionelement">HTMLOptionElement</a> <a href="#itemindex1" title=dom-HTMLOptionsCollection-item>item</a>(in unsigned long index);
[NameGetter] Object <a href="#nameditem1" title=dom-HTMLOptionsCollection-namedItem>namedItem</a>(in DOMString name);
};</pre>
@@ -6798,9 +6795,10 @@
greater than, or less than the number of nodes <a
href="#represents">represented by the collection</a> at that time. If the
number is the same, then setting the attribute must do nothing. If the new
- value is greater, then <var title="">n</var> new <code>option</code>
- elements with no attributes and no child nodes must be appended to the
- <code><a href="#select">select</a></code> element on which the <code><a
+ value is greater, then <var title="">n</var> new <code><a
+ href="#option">option</a></code> elements with no attributes and no child
+ nodes must be appended to the <code><a href="#select">select</a></code>
+ element on which the <code><a
href="#htmloptionscollection0">HTMLOptionsCollection</a></code> is rooted,
where <var title="">n</var> is the difference between the two numbers (new
value minus old value). If the new value is lower, then the last <var
@@ -26711,9 +26709,9 @@
attribute DOMString <span title=dom-input-type>type</span>;
attribute DOMString <span title=dom-input-defaultValue>defaultValue</span>;
attribute DOMString <span title=dom-input-value>value</span>;
- attribute DOMTimeStamp <span>valueAsDate</span>;
- attribute float <span>valueAsNumber</span>;
- readonly attribute <span>HTMLOptionElement</span> <span title=dom-input-selectedOption>selectedOption</span>;
+ attribute DOMTimeStamp <span title=dom-input-valueAsDate>valueAsDate</span>;
+ attribute float <span title=dom-input-valueAsNumber>valueAsNumber</span>;
+ readonly attribute <a href="#htmloptionelement">HTMLOptionElement</a> <span title=dom-input-selectedOption>selectedOption</span>;
readonly attribute <a href="#htmlcollection0">HTMLCollection</a> <span title=dom-input-labels>labels</span>;
@@ -26856,7 +26854,7 @@
<dt>Content model:
- <dd>Zero or more <code>option</code> or <code><a
+ <dd>Zero or more <code><a href="#option">option</a></code> or <code><a
href="#optgroup">optgroup</a></code> elements.
<dt>Element-specific attributes:
@@ -26927,7 +26925,9 @@
<dt>Content model:
- <dd><a href="#phrasing0">Phrasing content</a>.
+ <dd>Either: <a href="#phrasing0">phrasing content</a>.
+
+ <dd>Or: Zero or more <code><a href="#option">option</a></code> elements.
<dt>Element-specific attributes:
@@ -26958,7 +26958,7 @@
<dt>Content model:
- <dd>Zero or more <code>option</code> elements.
+ <dd>Zero or more <code><a href="#option">option</a></code> elements.
<dt>Element-specific attributes:
@@ -26971,56 +26971,93 @@
<dd>
<pre
class=idl>interface <dfn id=htmloptgroupelement>HTMLOptGroupElement</dfn> : <a href="#htmlelement">HTMLElement</a> {
- attribute boolean <span title=dom-select-disabled>disabled</span>;
- attribute DOMString <span title=dom-select-label>label</span>;
+ attribute boolean <span title=dom-optgroup-disabled>disabled</span>;
+ attribute DOMString <span title=dom-optgroup-label>label</span>;
};</pre>
</dl>
<p class=big-issue>...
- <h4 id=the-option><span class=secno>4.9.9 </span>The <code>option</code>
- element</h4>
+ <h4 id=the-option><span class=secno>4.9.9 </span>The <dfn
+ id=option><code>option</code></dfn> element</h4>
- <h4 id=constructors><span class=secno>4.9.10 </span>Constructors</h4>
+ <dl class=element>
+ <dt>Categories
- <p>All <code><a href="#window">Window</a></code> objects must provide the
- following constructors:
+ <dd>None.
- <dl>
- <dt><dfn id=option title=dom-option><code>Option()</code></dfn>
+ <dt>Contexts in which this element may be used:
- <dt><dfn id=optionin title=dom-option-n><code>Option(in DOMString <var
- title="">name</var>)</code></dfn>
+ <dd>As a child of a <code><a href="#select">select</a></code> element.
- <dt><dfn id=optionin0 title=dom-option-nv><code>Option(in DOMString <var
- title="">name</var>, in DOMString <var title="">value</var>)</code></dfn>
+ <dd>As a child of a <code><a href="#datalist">datalist</a></code> element.
+
+ <dd>As a child of an <code><a href="#optgroup">optgroup</a></code>
+ element.
+
+ <dt>Content model:
+
+ <dd>Text.
+
+ <dt>Element-specific attributes:
+
+ <dd><code title=attr-option-disabled>disabled</code>
+
+ <dd><code title=attr-option-label>label</code>
+
+ <dd><code title=attr-option-selected>selected</code>
+
+ <dd><code title=attr-option-value>value</code>
+
+ <dt>DOM interface:
<dd>
- <p>When invoked as constructors, these must return a new
- <code>HTMLOptionElement</code> object (a new <code>option</code>
- element). <span class=big-issue>need to define argument
- processing</span>
+ <pre class=idl>[<a href="#option0" title=dom-option>Constructor</a>(),
+ <a href="#option1" title=dom-option-n>Constructor</a>(in DOMString name),
+ <a href="#option2" title=dom-option-nv>Constructor</a>(in DOMString name, in DOMString value)]
+interface <dfn id=htmloptionelement>HTMLOptionElement</dfn> : <a href="#htmlelement">HTMLElement</a> {
+ attribute boolean <span title=dom-option-disabled>disabled</span>;
+ readonly attribute <a href="#htmlformelement">HTMLFormElement</a> <span title=dom-option-form>form</span>;
+ attribute DOMString <span title=dom-option-label>label</span>;
+ attribute boolean <span title=dom-option-defaultSelected>defaultSelected</span>;
+ attribute boolean <span title=dom-option-selected>selected</span>;
+ attribute DOMString <span title=dom-input-value>value</span>;
+
+ readonly attribute DOMString <span title=dom-option-text>text</span>;
+ readonly attribute long <span title=dom-option-index>index</span>;
+};</pre>
</dl>
- <h4 id=the-textarea><span class=secno>4.9.11 </span>The
+ <p class=big-issue>...
+
+ <p class=big-issue> <dfn id=option0
+ title=dom-option><code>Option()</code></dfn> <dfn id=option1
+ title=dom-option-n><code>Option(<var title="">name</var>)</code></dfn>
+ <dfn id=option2 title=dom-option-nv><code>Option(<var title="">name</var>,
+ <var title="">value</var>)</code></dfn> ... must return a new <code><a
+ href="#htmloptionelement">HTMLOptionElement</a></code> object (a new
+ <code><a href="#option">option</a></code> element). ... argument
+ processing ...
+
+ <h4 id=the-textarea><span class=secno>4.9.10 </span>The
<code>textarea</code> element</h4>
- <h4 id=the-output><span class=secno>4.9.12 </span>The <code>output</code>
+ <h4 id=the-output><span class=secno>4.9.11 </span>The <code>output</code>
element</h4>
- <h4 id=association><span class=secno>4.9.13 </span>Association of controls
+ <h4 id=association><span class=secno>4.9.12 </span>Association of controls
and forms</h4>
<p class=big-issue>When an element is <dfn id=associated
title=concept-form-association>associated with a form</dfn>, ...
- <h4 id=processing1><span class=secno>4.9.14 </span>Processing model</h4>
+ <h4 id=processing1><span class=secno>4.9.13 </span>Processing model</h4>
<p class=big-issue>See <a
href="http://www.whatwg.org/specs/web-forms/current-work/#extend-form-controls">WF2</a>
for now
- <h5 id=form-submission><span class=secno>4.9.14.1. </span>Form submission</h5>
+ <h5 id=form-submission><span class=secno>4.9.13.1. </span>Form submission</h5>
<p class=big-issue>See <a
href="http://www.whatwg.org/specs/web-forms/current-work/#form-submission">WF2</a>
@@ -28870,9 +28907,9 @@
href="#datagrid0">datagrid</a></code> element (the <code><a
href="#select">select</a></code> or <code><a
href="#datalist">datalist</a></code> element), that skips all nodes
- other than <code><a href="#optgroup">optgroup</a></code> and
- <code>option</code> elements, as well as any descendents of any
- <code>option</code> elements.</p>
+ other than <code><a href="#optgroup">optgroup</a></code> and <code><a
+ href="#option">option</a></code> elements, as well as any descendents of
+ any <code><a href="#option">option</a></code> elements.</p>
<p>Given a path <var title="">row</var>, the corresponding element is the
one obtained by drilling into the view, taking the child given by the
@@ -28963,8 +29000,8 @@
<code title=attr-optgroup-label>label</code> attribute if the <var
title="">row</var>'s corresponding element is an <code><a
href="#optgroup">optgroup</a></code> element, otherwise, if the <var
- title="">row</var>'s corresponding element is an
- <code>option</code>element, its <code
+ title="">row</var>'s corresponding element is an <code><a
+ href="#option">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
attribute.</p>
@@ -29164,17 +29201,17 @@
<p>If the first element child of a cell's element is a <code><a
href="#select">select</a></code> element that has a no <code
title=attr-select-multiple>multiple</code> attribute and has at least
- one <code>option</code> element descendent, then the cell acts as a
- cyclable cell.</p>
+ one <code><a href="#option">option</a></code> element descendent, then
+ the cell acts as a cyclable cell.</p>
- <p>The "current" <code>option</code> element is the selected
- <code>option</code> element, or the first <code>option</code> element if
- none is selected.</p>
+ <p>The "current" <code><a href="#option">option</a></code> element is the
+ selected <code><a href="#option">option</a></code> element, or the first
+ <code><a href="#option">option</a></code> element if none is selected.</p>
<p>The <code title=dom-provider-getCellData><a
href="#getcelldata">getCellData()</a></code> method must return the
<code><a href="#textcontent">textContent</a></code> of the current
- <code>option</code> element (the <code
+ <code><a href="#option">option</a></code> element (the <code
title=attr-option-label>label</code> attribute is <a href="#ignored"
title=ignore>ignored</a> in this context as the <code><a
href="#optgroup">optgroup</a></code>s are not displayed).</p>
@@ -29183,17 +29220,19 @@
href="#getcellclasses">getCellClasses()</a></code> method must add the
<code title=datagrid-cell-class-cyclable><a
href="#cyclable">cyclable</a></code> class and then all the classes of
- the current <code>option</code> element.</p>
+ the current <code><a href="#option">option</a></code> element.</p>
<p>The <code title=dom-provider-cycleCell><a
href="#cyclecell">cycleCell()</a></code> method must change the
selection of the <code><a href="#select">select</a></code> element such
- that the next <code>option</code> element after the current
- <code>option</code> element is the only one that is selected (in <a
- href="#tree-order">tree order</a>). If the current <code>option</code>
- element is the last <code>option</code> element descendent of the
- <code><a href="#select">select</a></code>, then the first
- <code>option</code> element descendent must be selected instead.</p>
+ that the next <code><a href="#option">option</a></code> element after
+ the current <code><a href="#option">option</a></code> element is the
+ only one that is selected (in <a href="#tree-order">tree order</a>). If
+ the current <code><a href="#option">option</a></code> element is the
+ last <code><a href="#option">option</a></code> element descendent of the
+ <code><a href="#select">select</a></code>, then the first <code><a
+ href="#option">option</a></code> element descendent must be selected
+ instead.</p>
<p>The <code title=dom-provider-setCellCheckedState><a
href="#setcellcheckedstate">setCellCheckedState()</a></code> and <code
@@ -30697,7 +30736,7 @@
<dt>An <code><a href="#hr">hr</a></code> element
- <dt>An <code>option</code> element that has a <code
+ <dt>An <code><a href="#option">option</a></code> element that has a <code
title=attr-option-value>value</code> attribute set to the empty string,
and has a <code title=attr-option-disabled>disabled</code> attribute, and
whose <code><a href="#textcontent">textContent</a></code> consists of a
@@ -30975,8 +31014,9 @@
title=command-facet-Label>Label</a>, or null if the element does not
define a command or does not specify a <a href="#label4"
title=command-facet-Label>Label</a>. This attribute will be shadowed by
- the <code title="">label</code> DOM attribute on <code>option</code> and
- <code><a href="#command0">command</a></code> elements.
+ the <code title="">label</code> DOM attribute on <code><a
+ href="#option">option</a></code> and <code><a
+ href="#command0">command</a></code> elements.
<p>The <dfn id=title7 title=dom-command-ro-title><code>title</code></dfn>
attribute must return the command's <a href="#hint"
@@ -31015,7 +31055,8 @@
define a command, the attribute must return false. This attribute will be
shadowed by the <code title="">disabled</code> attribute on <code><a
href="#button">button</a></code>, <code><a
- href="#input0">input</a></code>, <code>option</code>, and <code><a
+ href="#input0">input</a></code>, <code><a
+ href="#option">option</a></code>, and <code><a
href="#command0">command</a></code> elements.
<p>The <dfn id=checked3
@@ -31212,15 +31253,15 @@
title=option-command>Using the <code>option</code> element to define a
command</dfn></h5>
- <p>An <code>option</code> element with an ancestor <code><a
- href="#select">select</a></code> element and either no <code
+ <p>An <code><a href="#option">option</a></code> element with an ancestor
+ <code><a href="#select">select</a></code> element and either no <code
title=attr-option-value>value</code> attribute or a <code
title=attr-option-value>value</code> attribute that is not the empty
string <a href="#command1" title=concept-command>defines a command</a>.
<p>The <a href="#type19" title=command-facet-Type>Type</a> of the command
- is "radio" if the <code>option</code>'s nearest ancestor <code><a
- href="#select">select</a></code> element has no <code
+ is "radio" if the <code><a href="#option">option</a></code>'s nearest
+ ancestor <code><a href="#select">select</a></code> element has no <code
title=attr-select-multiple>multiple</code> attribute, and "checkbox" if it
does.
@@ -31230,10 +31271,11 @@
command is an <a href="#anonymous">anonymous command</a>.
<p>The <a href="#label4" title=command-facet-Label>Label</a> of the command
- is the value of the <code>option</code> element's <code
- title=attr-option-label>label</code> attribute, if there is one, or the
- value of the <code>option</code> element's <code><a
- href="#textcontent">textContent</a></code> DOM attribute if it doesn't.
+ is the value of the <code><a href="#option">option</a></code> element's
+ <code title=attr-option-label>label</code> attribute, if there is one, or
+ the value of the <code><a href="#option">option</a></code> element's
+ <code><a href="#textcontent">textContent</a></code> DOM attribute if it
+ doesn't.
<p>The <a href="#hint" title=command-facet-Hint>Hint</a> of the command is
the string given by the element's <code title=attr-title><a
@@ -31261,14 +31303,14 @@
command depends on its <a href="#type19"
title=command-facet-Type>Type</a>. If the command is of <a href="#type19"
title=command-facet-Type>Type</a> "radio" then this must set the <code
- title=dom-option-selected>selected</code> DOM attribute of the
- <code>option</code> element to true, otherwise it must toggle the state of
- the <code title=dom-option-selected>selected</code> DOM attribute (set it
- to true if it is false and vice versa). Then <a href="#firing0"
- title="fire a change event">a <code title="">change</code> event must be
- fired</a> on the <code>option</code> element's nearest ancestor <code><a
- href="#select">select</a></code> element (if there is one), as if the
- selection had been changed directly.
+ title=dom-option-selected>selected</code> DOM attribute of the <code><a
+ href="#option">option</a></code> element to true, otherwise it must toggle
+ the state of the <code title=dom-option-selected>selected</code> DOM
+ attribute (set it to true if it is false and vice versa). Then <a
+ href="#firing0" title="fire a change event">a <code title="">change</code>
+ event must be fired</a> on the <code><a href="#option">option</a></code>
+ element's nearest ancestor <code><a href="#select">select</a></code>
+ element (if there is one), as if the selection had been changed directly.
<h5 id=using3><span class=secno>4.11.6.5. </span>Using the <dfn id=command3
title=command-element><code>command</code></dfn> element to define a
@@ -41638,7 +41680,7 @@
title=dom-input-defaultValue>defaultValue</code> DOM attribute as well
as the <code title=dom-input-value>value</code> DOM attribute; for
<code><a href="#select">select</a></code> elements it means updating the
- <code>option</code> elements' <code
+ <code><a href="#option">option</a></code> elements' <code
title=dom-option-defaultSelected>defaultSelected</code> DOM attribute as
well as the <code title=dom-option-selected>selected</code> DOM
attribute; for <code>textarea</code> elements this means updating the
@@ -46381,9 +46423,10 @@
-->
<!-- </option> -->
- <p>An <code>option</code> element's <span title=syntax-end-tag>end
- tag</span> may be omitted if the <code>option</code> element is
- immediately followed by another <code>option</code> element, or if it is
+ <p>An <code><a href="#option">option</a></code> element's <span
+ title=syntax-end-tag>end tag</span> may be omitted if the <code><a
+ href="#option">option</a></code> element is immediately followed by
+ another <code><a href="#option">option</a></code> element, or if it is
immediately followed by an <code><a href="#optgroup">optgroup</a></code>
element, or if there is no more content in the parent element.</p>
<!-- <colgroup> -->
@@ -50103,7 +50146,7 @@
end tags</dfn>, then, while the <a href="#current5">current node</a> is a
<code><a href="#dd">dd</a></code> element, a <code><a
href="#dt">dt</a></code> element, an <code><a href="#li">li</a></code>
- element, an <code>option</code> element, an <code><a
+ element, an <code><a href="#option">option</a></code> element, an <code><a
href="#optgroup">optgroup</a></code> element, a <code><a
href="#p">p</a></code> element, an <code><a href="#rp">rp</a></code>
element, or an <code><a href="#rt">rt</a></code> element, the UA must pop
@@ -52912,16 +52955,18 @@
<dt>A start tag whose tag name is "option"
<dd>
- <p>If the <a href="#current5">current node</a> is an <code>option</code>
- element, act as if an end tag with the tag name "option" had been seen.</p>
+ <p>If the <a href="#current5">current node</a> is an <code><a
+ href="#option">option</a></code> element, act as if an end tag with the
+ tag name "option" had been seen.</p>
<p><a href="#insert0">Insert an HTML element</a> for the token.</p>
<dt>A start tag whose tag name is "optgroup"
<dd>
- <p>If the <a href="#current5">current node</a> is an <code>option</code>
- element, act as if an end tag with the tag name "option" had been seen.</p>
+ <p>If the <a href="#current5">current node</a> is an <code><a
+ href="#option">option</a></code> element, act as if an end tag with the
+ tag name "option" had been seen.</p>
<p>If the <a href="#current5">current node</a> is an <code><a
href="#optgroup">optgroup</a></code> element, act as if an end tag with
@@ -52932,11 +52977,11 @@
<dt>An end tag whose tag name is "optgroup"
<dd>
- <p>First, if the <a href="#current5">current node</a> is an
- <code>option</code> element, and the node immediately before it in the
- <a href="#stack">stack of open elements</a> is an <code><a
- href="#optgroup">optgroup</a></code> element, then act as if an end tag
- with the tag name "option" had been seen.</p>
+ <p>First, if the <a href="#current5">current node</a> is an <code><a
+ href="#option">option</a></code> element, and the node immediately
+ before it in the <a href="#stack">stack of open elements</a> is an
+ <code><a href="#optgroup">optgroup</a></code> element, then act as if an
+ end tag with the tag name "option" had been seen.</p>
<p>If the <a href="#current5">current node</a> is an <code><a
href="#optgroup">optgroup</a></code> element, then pop that node from
@@ -52946,10 +52991,10 @@
<dt>An end tag whose tag name is "option"
<dd>
- <p>If the <a href="#current5">current node</a> is an <code>option</code>
- element, then pop that node from the <a href="#stack">stack of open
- elements</a>. Otherwise, this is a <a href="#parse2">parse error</a>;
- ignore the token.</p>
+ <p>If the <a href="#current5">current node</a> is an <code><a
+ href="#option">option</a></code> element, then pop that node from the <a
+ href="#stack">stack of open elements</a>. Otherwise, this is a <a
+ href="#parse2">parse error</a>; ignore the token.</p>
<dt>An end tag whose tag name is "select"
Received on Thursday, 4 September 2008 11:23:35 UTC