- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 04 Sep 2008 10:50:48 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv20623
Modified Files:
Overview.html
Log Message:
WF2: <select> element summary. (whatwg r2148)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1320
retrieving revision 1.1321
diff -u -d -r1.1320 -r1.1321
--- Overview.html 3 Sep 2008 20:46:28 -0000 1.1320
+++ Overview.html 4 Sep 2008 10:50:46 -0000 1.1321
@@ -27,7 +27,7 @@
for HTML and XHTML</h2>
<h2 class="no-num no-toc" id=editors0><!-- "W3C Working Draft" -->
- Editor's Draft <!--ZZZ--> 3 September 2008</h2>
+ Editor's Draft <!--ZZZ--> 4 September 2008</h2>
<dl><!-- ZZZ: update the month/day
<dt>This Version:</dt>
@@ -199,7 +199,7 @@
<p>The W3C <a href="http://www.w3.org/html/wg/">HTML Working Group</a> is
the W3C working group responsible for this specification's progress along
- the W3C Recommendation track. <!--ZZZ:--> This specification is the 3
+ the W3C Recommendation track. <!--ZZZ:--> This specification is the 4
September 2008 <!--ZZZ "Working Draft"-->Editor's Draft. <!--:ZZZ--></p>
<!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST -->
<!-- relationship to other work (required) -->
@@ -6800,7 +6800,7 @@
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>select</code> element on which the <code><a
+ <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
@@ -7543,10 +7543,10 @@
href="#input0">input</a></code>, <code><a href="#map">map</a></code>,
<code><a href="#meta0">meta</a></code>, <code><a
href="#object">object</a></code>,<!-- param?
- XXX--> <code>select</code>,
- and <code>textarea</code> elements in that document that have a <code
- title="">name</code> attribute whose value is equal to the <var
- title="">name</var> argument (in a <a
+ XXX--> <code><a
+ href="#select">select</a></code>, and <code>textarea</code> elements in
+ that document that have a <code title="">name</code> attribute whose value
+ is equal to the <var title="">name</var> argument (in a <a
href="#case-sensitive">case-sensitive</a> manner), in <a
href="#tree-order">tree order</a>.
@@ -26786,7 +26786,6 @@
readonly attribute HTMLFormElement <span title=dom-button-form>form</span>;
attribute DOMString <span title=dom-button-method>method</span>;
attribute DOMString <span title=dom-button-name>name</span>;
- attribute boolean <span title=dom-button-required>required</span>;
attribute DOMString <span title=dom-button-target>target</span>;
attribute DOMString <span title=dom-button-type>type</span>;
attribute DOMString <span title=dom-button-value>value</span>;
@@ -26840,8 +26839,77 @@
<p class=big-issue>...
- <h4 id=the-select><span class=secno>4.9.6 </span>The <code>select</code>
- element</h4>
+ <h4 id=the-select><span class=secno>4.9.6 </span>The <dfn
+ id=select><code>select</code></dfn> element</h4>
+
+ <dl class=element>
+ <dt>Categories
+
+ <dd><a href="#phrasing0">Phrasing content</a>.
+
+ <dd><a href="#interactive1">Interactive content</a>.
+
+ <dt>Contexts in which this element may be used:
+
+ <dd>Where <a href="#phrasing0">phrasing content</a> is expected.
+
+ <dt>Content model:
+
+ <dd>Zero or more <code>option</code> or <code>optgroup</code> elements.
+
+ <dt>Element-specific attributes:
+
+ <dd><code title=attr-select-autofocus>autofocus</code>
+
+ <dd><code title=attr-select-disabled>disabled</code>
+
+ <dd><code title=attr-select-form>form</code>
+
+ <dd><code title=attr-select-multiple>multiple</code>
+
+ <dd><code title=attr-select-name>name</code>
+
+ <dd><code title=attr-select-size>size</code>
+
+ <dt>DOM interface:
+
+ <dd>
+ <pre
+ class=idl>interface <dfn id=htmlselectelement>HTMLSelectElement</dfn> : <a href="#htmlelement">HTMLElement</a> {
+ attribute boolean <span title=dom-select-autofocus>autofocus</span>;
+ attribute boolean <span title=dom-select-disabled>disabled</span>;
+ readonly attribute HTMLFormElement <span title=dom-select-form>form</span>;
+ attribute boolean <span title=dom-select-multiple>multiple</span>;
+ attribute DOMString <span title=dom-select-name>name</span>;
+ attribute boolean <span title=dom-select-size>size</span>;
+
+ readonly attribute DOMString <span title=dom-select-type>type</span>;
+
+ readonly attribute HTMLOptionsCollection <span title=dom-select-options>options</span>;
+ attribute unsigned long <span title=dom-select-length>length</span>;
+ [IndexGetter] <a href="#htmlelement">HTMLElement</a> <span title=dom-select-XXX9>XXX9</span>(in unsigned long index);
+
+ readonly attribute HTMLCollection <span title=dom-select-selectedOptions>selectedOptions</span>;
+ attribute long <span title=dom-select-selectedIndex>selectedIndex</span>;
+ attribute DOMString <span title=dom-select-value>value</span>;
+
+ readonly attribute HTMLCollection <span title=dom-select-labels>labels</span>;
+
+ void <span title=dom-select-add>add</span>(in HTMLElement element, in HTMLElement before);
+ void <span title=dom-select-remove>remove</span>(in long index);
+
+ readonly attribute boolean <span title=dom-select-willValidate>willValidate</span>;
+ readonly attribute <span>ValidityState</span> <span title=dom-select-validity>validity</span>;
+ readonly attribute DOMString <span title=dom-select-validationMessage>validationMessage</span>;
+ boolean <span title=dom-select-checkValidatity>checkValidity</span>();
+ void <span title=dom-select-setCustomValidity>setCustomValidity</span>(in DOMString error);
+
+ void <span title=dom-select-dispatchChange>dispatchChange</span>();
+ void <span title=dom-select-dispatchFormChange>dispatchFormChange</span>();
+};</pre>
+ </dl>
+
+ <p class=big-issue>...
<h4 id=the-datalist><span class=secno>4.9.7 </span>The
<code>datalist</code> element</h4>
@@ -27881,12 +27949,12 @@
<dd>Or: <a href="#flow-content0">Flow content</a>, but where the first
element child node, if any, is not a <code><a
- href="#table">table</a></code>, <code>select</code>, or
- <code>datalist</code> element.
+ href="#table">table</a></code>, <code><a
+ href="#select">select</a></code>, or <code>datalist</code> element.
<dd>Or: A single <code><a href="#table">table</a></code> element.
- <dd>Or: A single <code>select</code> element.
+ <dd>Or: A single <code><a href="#select">select</a></code> element.
<dd>Or: A single <code>datalist</code> element.
@@ -28087,7 +28155,7 @@
selection of the <code><a href="#datagrid0">datagrid</a></code> element
when it is first loaded. The data provider could also use this method
call to register a <code title=event-select><a
- href="#select">select</a></code> event handler on the <code><a
+ href="#select0">select</a></code> event handler on the <code><a
href="#datagrid0">datagrid</a></code> in order to monitor selection
changes.
@@ -28726,8 +28794,8 @@
href="#updateeverything">updateEverything()</a></code> if the change did
affect the sort order.</p>
- <dt>While the first element child is a <code>select</code> or
- <code>datalist</code> element
+ <dt>While the first element child is a <code><a
+ href="#select">select</a></code> or <code>datalist</code> element
<dd>
<p>The default data provider must return 1 for the column count, the
@@ -28736,10 +28804,11 @@
<p>For the rows, assume the existence of a node filter view of the
descendants of the first element child of the <code><a
- href="#datagrid0">datagrid</a></code> element (the <code>select</code>
- or <code>datalist</code> element), that skips all nodes other than
- <code>optgroup</code> and <code>option</code> elements, as well as any
- descendents of any <code>option</code> elements.</p>
+ href="#datagrid0">datagrid</a></code> element (the <code><a
+ href="#select">select</a></code> or <code>datalist</code> element), that
+ skips all nodes other than <code>optgroup</code> and <code>option</code>
+ elements, as well as any descendents of any <code>option</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
@@ -28780,14 +28849,16 @@
drill through the view to find the element corresponding to the method's
argument, and return the number of child nodes in the filtered view that
the corresponding element has. (If the <var title="">row</var> is empty,
- the corresponding element is the <code>select</code> element at the root
- of the filtered view.)</p>
+ the corresponding element is the <code><a
+ href="#select">select</a></code> element at the root of the filtered
+ view.)</p>
<p><code title=dom-provider-getChildAtPosition><a
href="#getchildatposition">getChildAtPosition(<var title="">row</var>,
<var title="">position</var>)</a></code> must return <var
- title="">position</var>. (The <code>select</code>/<code>datalist</code>
- default data provider does not support sorting the data grid.)</p>
+ title="">position</var>. (The <code><a
+ href="#select">select</a></code>/<code>datalist</code> default data
+ provider does not support sorting the data grid.)</p>
<p><code title=dom-provider-getRowImage><a
href="#getrowimage">getRowImage(<var title="">i</var>)</a></code> must
@@ -29014,18 +29085,18 @@
</span>Common default data provider method definitions for cells</h6>
<p>These definitions are used for the cell-specific methods of the default
- data providers (other than in the
- <code>select</code>/<code>datalist</code> case). How they behave is based
- on the contents of an element that represents the cell given by their
- first two arguments. Which element that is is defined in the previous
- section.
+ data providers (other than in the <code><a
+ href="#select">select</a></code>/<code>datalist</code> case). How they
+ behave is based on the contents of an element that represents the cell
+ given by their first two arguments. Which element that is is defined in
+ the previous section.
<dl>
<dt>Cyclable cells
<dd>
- <p>If the first element child of a cell's element is a
- <code>select</code> element that has a no <code
+ <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>
@@ -29050,13 +29121,13 @@
<p>The <code title=dom-provider-cycleCell><a
href="#cyclecell">cycleCell()</a></code> method must change the
- selection of the <code>select</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>select</code>, then
- the first <code>option</code> element descendent must be selected
- instead.</p>
+ 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>
<p>The <code title=dom-provider-setCellCheckedState><a
href="#setcellcheckedstate">setCellCheckedState()</a></code> and <code
@@ -29671,7 +29742,7 @@
<p>Any effects the update methods have on the <code><a
href="#datagrid0">datagrid</a></code>'s selection is not considered a
change to the selection, and must therefore not fire the <code
- title=event-select><a href="#select">select</a></code> event.
+ title=event-select><a href="#select0">select</a></code> event.
<p>These update methods should be called only by the data provider, or code
acting on behalf of the data provider. In particular, calling the <code
@@ -29858,7 +29929,7 @@
href="#datagrid0">datagrid</a></code> changes, whether due to the user
interacting with the element, or as a result of calls to methods of the
<code title=dom-datagrid-selection><a
- href="#selection0">selection</a></code> object, a <dfn id=select
+ href="#selection0">selection</a></code> object, a <dfn id=select0
title=event-select><code>select</code></dfn><!-- XXX check if we
really should be DFNing this here. It's a DOM3 Core event. What's
our story going to be regarding events and defining them? -->
@@ -29866,7 +29937,7 @@
href="#datagrid0">datagrid</a></code> element. If changes are made to the
selection via calls to the object's methods during the execution of a
script<!-- XXX should xref to a better explanation -->, then the <code
- title=event-select><a href="#select">select</a></code> events must be
+ title=event-select><a href="#select0">select</a></code> events must be
coalesced into one, which must then be fired<!--XXX xref again--> when the
script execution has completed<!-- XXX xref -->.
@@ -30576,11 +30647,11 @@
<dt>A <code><a href="#menu">menu</a></code> element with no <code
title=attr-menu-label><a href="#label2">label</a></code> attribute
- <dt>A <code>select</code> element
+ <dt>A <code><a href="#select">select</a></code> element
<dd>Append a separator to the menu, then iterate over the children of the
- <code><a href="#menu">menu</a></code> or <code>select</code> element,
- then append another separator.
+ <code><a href="#menu">menu</a></code> or <code><a
+ href="#select">select</a></code> element, then append another separator.
<dt>A <code><a href="#menu">menu</a></code> element with a <code
title=attr-menu-label><a href="#label2">label</a></code> attribute
@@ -30603,8 +30674,8 @@
href="#input0">input</a></code> elements in <code><a
href="#label">label</a></code> elements. Also, <code>optgroup</code>
elements without labels should be ignored (maybe? or at least should say
- they have no label so that they are dropped below), and
- <code>select</code> elements inside <code><a
+ they have no label so that they are dropped below), and <code><a
+ href="#select">select</a></code> elements inside <code><a
href="#label">label</a></code> elements may need special processing.
<p>Once all the nodes have been processed as described above, the user
@@ -31074,15 +31145,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>select</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>An <code>option</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>select</code> element has no <code
+ is "radio" if the <code>option</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.
@@ -31128,9 +31199,9 @@
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>select</code> element (if there is one), as if the selection had
- been changed directly.
+ 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.
<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
@@ -33992,8 +34063,8 @@
<dd>
<p>Must be invoked whenever a <code title=event-select><a
- href="#select">select</a></code> event is targeted at or bubbles through
- the element.
+ href="#select0">select</a></code> event is targeted at or bubbles
+ through the element.
</dd>
<!-- XXX should define when it fires -->
<!--XXX
@@ -35150,7 +35221,7 @@
<p>Multiple application caches can contain the same resource, e.g. if their
manifests all reference that resource. If the user agent is to <dfn
- id=select0 title=concept-appcache-selection>select an application
+ id=select1 title=concept-appcache-selection>select an application
cache</dfn> from a list of caches that contain a resource, that the user
agent must use the application cache that the user most likely wants to
see the resource from, taking into account the following:
@@ -37173,7 +37244,7 @@
href="#foreign" title=concept-appcache-foreign>foreign</a>), and that
already contain their manifest, categorized as a <a href="#the-manifest"
title=concept-appcache-manifest>manifest</a>. If so, then the user agent
- must then get the resource from the <a href="#select0"
+ must then get the resource from the <a href="#select1"
title=concept-appcache-selection>most appropriate application cache</a>
of those that match.</p>
@@ -37227,7 +37298,7 @@
title=concept-appcache-fallback>fallback resource</a> specified for
the opportunistic caching namespace in question. If multiple
application caches match, the user agent must use the fallback of the
- <a href="#select0" title=concept-appcache-selection>most appropriate
+ <a href="#select1" title=concept-appcache-selection>most appropriate
application cache</a> of those that match.</p>
<p>If <var title="">candidate</var> is not marked as <a href="#foreign"
@@ -40928,9 +40999,10 @@
<p>User agents may also allow the user to create selections that are not
exposed to the API.
- <p>The <code><a href="#datagrid0">datagrid</a></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>The <code><a href="#datagrid0">datagrid</a></code> and <code><a
+ href="#select">select</a></code> elements also have selections, indicating
+ which items have been picked by the user. These are not discussed in this
+ section.
<p class=note>This specification does not specify how selections are
presented to the user. The Selectors specification, in conjunction with
@@ -41151,7 +41223,7 @@
text selection:
<pre
- class=idl> void <a href="#select1" title="dom-textarea/input-select">select</a>();
+ class=idl> void <a href="#select2" title="dom-textarea/input-select">select</a>();
attribute unsigned long <a href="#selectionstart" title="dom-textarea/input-selectionStart">selectionStart</a>;
attribute unsigned long <a href="#selectionend" title="dom-textarea/input-selectionEnd">selectionEnd</a>;
void <a href="#setselectionrange" title="dom-textarea/input-setSelectionRange">setSelectionRange</a>(in unsigned long start, in unsigned long end);</pre>
@@ -41161,7 +41233,7 @@
<code><a href="#input0">input</a></code> and <code>textarea</code> text
fields.
- <p>The <dfn id=select1
+ <p>The <dfn id=select2
title="dom-textarea/input-select"><code>select()</code></dfn> method must
cause the contents of the text field to be fully selected.
@@ -41498,15 +41570,15 @@
this means updating the <code
title=dom-input-defaultValue>defaultValue</code> DOM attribute as well
as the <code title=dom-input-value>value</code> DOM attribute; for
- <code>select</code> elements it means updating the <code>option</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 <code
- title=dom-textarea-defaultValue>defaultValue</code> DOM attribute as
- well as the <code title=dom-textarea-value>value</code> DOM attribute.
- (Updating the <code title="">default*</code> DOM attributes causes
- content attributes to be updated as well.)
+ <code><a href="#select">select</a></code> elements it means updating the
+ <code>option</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
+ <code title=dom-textarea-defaultValue>defaultValue</code> DOM attribute
+ as well as the <code title=dom-textarea-value>value</code> DOM
+ attribute. (Updating the <code title="">default*</code> DOM attributes
+ causes content attributes to be updated as well.)
</dd>
<!-- XXX something about not supporting resizing? -->
</dl>
@@ -47399,10 +47471,11 @@
title="">node</var> to the <var title="">context</var> element. (<a
href="#fragment">fragment case</a>)
- <li>If <var title="">node</var> is a <code>select</code> element, then
- switch the <span>insertion mode</span> to "<a href="#in-select"
- title="insertion mode: in select">in select</a>" and abort these steps.
- (<a href="#fragment">fragment case</a>)
+ <li>If <var title="">node</var> is a <code><a
+ href="#select">select</a></code> element, then switch the <span>insertion
+ mode</span> to "<a href="#in-select" title="insertion mode: in select">in
+ select</a>" and abort these steps. (<a href="#fragment">fragment
+ case</a>)
<li>If <var title="">node</var> is a <code><a href="#td">td</a></code> or
<code><a href="#th">th</a></code> element and <var title="">last</var> is
@@ -47580,8 +47653,9 @@
<code><a href="#p">p</a></code>, <code><a
href="#param">param</a></code>, <code>plaintext</code>, <code><a
href="#pre">pre</a></code>, <code><a href="#script1">script</a></code>,
- <code><a href="#section">section</a></code>, <code>select</code>,
- <code>spacer</code>, <code><a href="#style1">style</a></code>, <code><a
+ <code><a href="#section">section</a></code>, <code><a
+ href="#select">select</a></code>, <code>spacer</code>, <code><a
+ href="#style1">style</a></code>, <code><a
href="#tbody">tbody</a></code>, <code>textarea</code>, <code><a
href="#tfoot0">tfoot</a></code>, <code><a
href="#thead0">thead</a></code>, <code><a
@@ -51796,10 +51870,10 @@
<p>If the <a href="#form-element"><code title="">form</code> element
pointer</a> is not null, then <a href="#associated"
- title=concept-form-association>associate</a> the <code>select</code>
- element with the <code><a href="#form">form</a></code> element pointed
- to by the <a href="#form-element"><code title="">form</code> element
- pointer</a>.</p>
+ title=concept-form-association>associate</a> the <code><a
+ href="#select">select</a></code> element with the <code><a
+ href="#form">form</a></code> element pointed to by the <a
+ href="#form-element"><code title="">form</code> element pointer</a>.</p>
<p>If the <span>insertion mode</span> is one of <a href="#in-table"
title="insertion mode: in table">in table</a>", "<a href="#in-caption"
@@ -52818,7 +52892,8 @@
<p>Otherwise:</p>
<p>Pop elements from the <a href="#stack">stack of open elements</a>
- until a <code>select</code> element has been popped from the stack.</p>
+ until a <code><a href="#select">select</a></code> element has been
+ popped from the stack.</p>
<p><a href="#reset">Reset the insertion mode appropriately</a>.</p>
Received on Thursday, 4 September 2008 10:51:24 UTC