[html5] r7558 - [e] (0) Cleanup wrapping for next checkin. Affected topics: DOM APIs, HTML
whatwg at whatwg.org
whatwg at whatwg.org
Sat Dec 1 14:39:53 PST 2012
Author: ianh
Date: 2012-12-01 14:39:52 -0800 (Sat, 01 Dec 2012)
New Revision: 7558
Modified:
complete.html
index
source
Log:
[e] (0) Cleanup wrapping for next checkin.
Affected topics: DOM APIs, HTML
Modified: complete.html
===================================================================
--- complete.html 2012-12-01 22:30:58 UTC (rev 7557)
+++ complete.html 2012-12-01 22:39:52 UTC (rev 7558)
@@ -51765,178 +51765,128 @@
http://developers.slashdot.org/comments.pl?sid=426306&cid=22142072
<Philip`> http://www.ipiao.com.cn/ does <select size="1" name="to"><script>City_Default="PEK"</script><SCRIPT language=javascript
src="/js/flightcity.js"></SCRIPT></select> which is the kind of thing that could be much simpler with <select value="PEK">
- --><p>The <code><a href=#the-select-element>select</a></code> element represents a control for
- selecting amongst a set of options.</p>
+ --><p>The <code><a href=#the-select-element>select</a></code> element represents a control for selecting amongst a set of
+ options.</p>
- <p>The <dfn id=attr-select-multiple title=attr-select-multiple><code>multiple</code></dfn>
- attribute is a <a href=#boolean-attribute>boolean attribute</a>. If the attribute is
- present, then the <code><a href=#the-select-element>select</a></code> element
- <a href=#represents>represents</a> a control for selecting zero or more options
- from the <a href=#concept-select-option-list title=concept-select-option-list>list of
- options</a>. If the attribute is absent, then the
- <code><a href=#the-select-element>select</a></code> element <a href=#represents>represents</a> a control for
- selecting a single option from the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>.</p>
+ <p>The <dfn id=attr-select-multiple title=attr-select-multiple><code>multiple</code></dfn> attribute is a <a href=#boolean-attribute>boolean
+ attribute</a>. If the attribute is present, then the <code><a href=#the-select-element>select</a></code> element
+ <a href=#represents>represents</a> a control for selecting zero or more options from the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>. If the attribute is absent, then the
+ <code><a href=#the-select-element>select</a></code> element <a href=#represents>represents</a> a control for selecting a single option from
+ the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>.</p>
- <p>The <dfn id=attr-select-size title=attr-select-size><code>size</code></dfn>
- attribute gives the number of options to show to the user. The <code title=attr-select-size><a href=#attr-select-size>size</a></code> attribute, if specified, must
- have a value that is a <a href=#valid-non-negative-integer>valid non-negative integer</a>
- greater than zero.</p>
+ <p>The <dfn id=attr-select-size title=attr-select-size><code>size</code></dfn> attribute gives the number of options
+ to show to the user. The <code title=attr-select-size><a href=#attr-select-size>size</a></code> attribute, if specified, must
+ have a value that is a <a href=#valid-non-negative-integer>valid non-negative integer</a> greater than zero.</p>
<div class=impl>
- <p>The <dfn id=concept-select-size title=concept-select-size>display size</dfn> of a
- <code><a href=#the-select-element>select</a></code> element is the result of applying the
- <a href=#rules-for-parsing-non-negative-integers>rules for parsing non-negative integers</a> to the value of
- element's <code title=attr-select-size><a href=#attr-select-size>size</a></code> attribute, if
- it has one and parsing it is successful. If applying those rules to
- the attribute's value is not successful, or if the <code title=attr-select-size><a href=#attr-select-size>size</a></code> attribute is absent, then the
- element's <a href=#concept-select-size title=concept-select-size>display size</a> is 4
- if the element's <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code>
- content attribute is present, and 1 otherwise.</p>
+ <p>The <dfn id=concept-select-size title=concept-select-size>display size</dfn> of a <code><a href=#the-select-element>select</a></code> element is the
+ result of applying the <a href=#rules-for-parsing-non-negative-integers>rules for parsing non-negative integers</a> to the value of
+ element's <code title=attr-select-size><a href=#attr-select-size>size</a></code> attribute, if it has one and parsing it is
+ successful. If applying those rules to the attribute's value is not successful, or if the <code title=attr-select-size><a href=#attr-select-size>size</a></code> attribute is absent, then the element's <a href=#concept-select-size title=concept-select-size>display size</a> is 4 if the element's <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> content attribute is present, and 1 otherwise.</p>
</div>
- <p>The <dfn id=concept-select-option-list title=concept-select-option-list>list of options</dfn>
- for a <code><a href=#the-select-element>select</a></code> element consists of all the
- <code><a href=#the-option-element>option</a></code> element children of the <code><a href=#the-select-element>select</a></code>
- element, and all the <code><a href=#the-option-element>option</a></code> element children of all the
- <code><a href=#the-optgroup-element>optgroup</a></code> element children of the <code><a href=#the-select-element>select</a></code>
- element, in <a href=#tree-order>tree order</a>.</p>
+ <p>The <dfn id=concept-select-option-list title=concept-select-option-list>list of options</dfn> for a <code><a href=#the-select-element>select</a></code>
+ element consists of all the <code><a href=#the-option-element>option</a></code> element children of the <code><a href=#the-select-element>select</a></code>
+ element, and all the <code><a href=#the-option-element>option</a></code> element children of all the <code><a href=#the-optgroup-element>optgroup</a></code> element
+ children of the <code><a href=#the-select-element>select</a></code> element, in <a href=#tree-order>tree order</a>.</p>
- <p>The <dfn id=attr-select-required title=attr-select-required><code>required</code></dfn>
- attribute is a <a href=#boolean-attribute>boolean attribute</a>. When specified, the
- user will be required to select a value before submitting the
- form.</p>
+ <p>The <dfn id=attr-select-required title=attr-select-required><code>required</code></dfn> attribute is a <a href=#boolean-attribute>boolean
+ attribute</a>. When specified, the user will be required to select a value before submitting
+ the form.</p>
- <p>If a <code><a href=#the-select-element>select</a></code> element has a <code title=attr-select-required><a href=#attr-select-required>required</a></code> attribute specified,
- does not have a <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code>
- attribute specified, and has a <a href=#concept-select-size title=concept-select-size>display size</a> of 1;
- and if the <a href=#concept-option-value title=concept-option-value>value</a> of the
- first <code><a href=#the-option-element>option</a></code> element in the <code><a href=#the-select-element>select</a></code>
- element's <a href=#concept-select-option-list title=concept-select-option-list>list of
- options</a> (if any) is the empty string, and that
- <code><a href=#the-option-element>option</a></code> element's parent node is the <code><a href=#the-select-element>select</a></code>
- element (and not an <code><a href=#the-optgroup-element>optgroup</a></code> element), then that
- <code><a href=#the-option-element>option</a></code> is the <code><a href=#the-select-element>select</a></code> element's
- <dfn id=placeholder-label-option>placeholder label option</dfn>.</p>
+ <p>If a <code><a href=#the-select-element>select</a></code> element has a <code title=attr-select-required><a href=#attr-select-required>required</a></code>
+ attribute specified, does not have a <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute
+ specified, and has a <a href=#concept-select-size title=concept-select-size>display size</a> of 1; and if the <a href=#concept-option-value title=concept-option-value>value</a> of the first <code><a href=#the-option-element>option</a></code> element in the
+ <code><a href=#the-select-element>select</a></code> element's <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> (if
+ any) is the empty string, and that <code><a href=#the-option-element>option</a></code> element's parent node is the
+ <code><a href=#the-select-element>select</a></code> element (and not an <code><a href=#the-optgroup-element>optgroup</a></code> element), then that
+ <code><a href=#the-option-element>option</a></code> is the <code><a href=#the-select-element>select</a></code> element's <dfn id=placeholder-label-option>placeholder label option</dfn>.</p>
- <p>If a <code><a href=#the-select-element>select</a></code> element has a <code title=attr-select-required><a href=#attr-select-required>required</a></code> attribute specified,
- does not have a <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code>
- attribute specified, and has a <a href=#concept-select-size title=concept-select-size>display size</a> of 1,
- then the <code><a href=#the-select-element>select</a></code> element must have a <a href=#placeholder-label-option>placeholder
- label option</a>.</p>
+ <p>If a <code><a href=#the-select-element>select</a></code> element has a <code title=attr-select-required><a href=#attr-select-required>required</a></code>
+ attribute specified, does not have a <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute
+ specified, and has a <a href=#concept-select-size title=concept-select-size>display size</a> of 1, then the
+ <code><a href=#the-select-element>select</a></code> element must have a <a href=#placeholder-label-option>placeholder label option</a>.</p>
<div class=impl>
- <p><strong>Constraint validation</strong>: If the element has its
- <code title=attr-select-required><a href=#attr-select-required>required</a></code> attribute
- specified, and either none of the <code><a href=#the-option-element>option</a></code> elements in
- the <code><a href=#the-select-element>select</a></code> element's <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> have their
- <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to
- true, or the only <code><a href=#the-option-element>option</a></code> element in the
- <code><a href=#the-select-element>select</a></code> element's <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> with its
- <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to
- true is the <a href=#placeholder-label-option>placeholder label option</a>, then the element
- is <a href=#suffering-from-being-missing>suffering from being missing</a>.</p>
+ <p><strong>Constraint validation</strong>: If the element has its <code title=attr-select-required><a href=#attr-select-required>required</a></code> attribute specified, and either none of the
+ <code><a href=#the-option-element>option</a></code> elements in the <code><a href=#the-select-element>select</a></code> element's <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> have their <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to true, or the only
+ <code><a href=#the-option-element>option</a></code> element in the <code><a href=#the-select-element>select</a></code> element's <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> with its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to true is the <a href=#placeholder-label-option>placeholder label
+ option</a>, then the element is <a href=#suffering-from-being-missing>suffering from being missing</a>.</p>
</div>
<div class=impl>
- <p>If the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code>
- attribute is absent, and the element is not <a href=#concept-fe-disabled title=concept-fe-disabled>disabled</a>, then the user agent
- should allow the user to pick an <code><a href=#the-option-element>option</a></code> element in its
- <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> that
- is itself not <a href=#concept-option-disabled title=concept-option-disabled>disabled</a>.
- Upon this <code><a href=#the-option-element>option</a></code> element being <dfn id=concept-select-pick title=concept-select-pick>picked</dfn> (either through a click, or
- through unfocusing the element after changing its value, or through
- a <a href=#using-the-option-element-to-define-a-command title=option-command>menu command</a>, or through any
- other mechanism), and before the relevant user interaction event
- <!-- interaction event spec point --> is queued (e.g. before the
- <code title=event-click><a href=#event-click>click</a></code> event), the user agent must
- set the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of the
- picked <code><a href=#the-option-element>option</a></code> element to true and then <a href=#queue-a-task>queue a
- task</a> to <a href=#fire-a-simple-event>fire a simple event</a> that bubbles named
- <code title=event-change>change</code> at the <code><a href=#the-select-element>select</a></code>
- element, using the <a href=#user-interaction-task-source>user interaction task source</a> as the
- task source.</p>
+ <p>If the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute is absent, and the element
+ is not <a href=#concept-fe-disabled title=concept-fe-disabled>disabled</a>, then the user agent should allow the
+ user to pick an <code><a href=#the-option-element>option</a></code> element in its <a href=#concept-select-option-list title=concept-select-option-list>list
+ of options</a> that is itself not <a href=#concept-option-disabled title=concept-option-disabled>disabled</a>. Upon
+ this <code><a href=#the-option-element>option</a></code> element being <dfn id=concept-select-pick title=concept-select-pick>picked</dfn> (either
+ through a click, or through unfocusing the element after changing its value, or through a <a href=#using-the-option-element-to-define-a-command title=option-command>menu command</a>, or through any other mechanism), and before the
+ relevant user interaction event <!-- interaction event spec point --> is queued (e.g. before the
+ <code title=event-click><a href=#event-click>click</a></code> event), the user agent must set the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of the picked <code><a href=#the-option-element>option</a></code> element
+ to true and then <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple event</a> that bubbles named
+ <code title=event-change>change</code> at the <code><a href=#the-select-element>select</a></code> element, using the <a href=#user-interaction-task-source>user
+ interaction task source</a> as the task source.</p>
- <p>If the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code>
- attribute is absent, whenever an <code><a href=#the-option-element>option</a></code> element in the
- <code><a href=#the-select-element>select</a></code> element's <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> has its
- <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to
- true, and whenever an <code><a href=#the-option-element>option</a></code> element with its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to true
- is added to the <code><a href=#the-select-element>select</a></code> element's <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>, the user
- agent must set the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of all the
- other <code><a href=#the-option-element>option</a></code> element in its <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> to
- false.</p>
+ <p>If the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute is absent, whenever an
+ <code><a href=#the-option-element>option</a></code> element in the <code><a href=#the-select-element>select</a></code> element's <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> has its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to true, and whenever an
+ <code><a href=#the-option-element>option</a></code> element with its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a>
+ set to true is added to the <code><a href=#the-select-element>select</a></code> element's <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>, the user agent must set the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of all the other <code><a href=#the-option-element>option</a></code>
+ element in its <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> to false.</p>
- <p>If the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code>
- attribute is absent and the element's <a href=#concept-select-size title=concept-select-size>display size</a> is greater than 1,
- then the user agent should also allow the user to request that the
- <code><a href=#the-option-element>option</a></code> whose <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> is true, if
- any, be unselected. Upon this request being conveyed to the user
- agent, and before the relevant user interaction event <!--
- interaction event spec point --> is queued (e.g. before the <code title=event-click><a href=#event-click>click</a></code> event), the user agent must set the
- <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of
- that <code><a href=#the-option-element>option</a></code> element to false and then <a href=#queue-a-task>queue a
- task</a> to <a href=#fire-a-simple-event>fire a simple event</a> that bubbles named
- <code title=event-change>change</code> at the <code><a href=#the-select-element>select</a></code>
- element, using the <a href=#user-interaction-task-source>user interaction task source</a> as the
- task source.</p>
+ <p>If the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute is absent and the element's
+ <a href=#concept-select-size title=concept-select-size>display size</a> is greater than 1, then the user agent
+ should also allow the user to request that the <code><a href=#the-option-element>option</a></code> whose <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> is true, if any, be unselected. Upon this
+ request being conveyed to the user agent, and before the relevant user interaction event <!--
+ interaction event spec point --> is queued (e.g. before the <code title=event-click><a href=#event-click>click</a></code>
+ event), the user agent must set the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a>
+ of that <code><a href=#the-option-element>option</a></code> element to false and then <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a
+ simple event</a> that bubbles named <code title=event-change>change</code> at the
+ <code><a href=#the-select-element>select</a></code> element, using the <a href=#user-interaction-task-source>user interaction task source</a> as the task
+ source.</p>
- <p>If the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code>
- attribute is absent and the element's <a href=#concept-select-size title=concept-select-size>display size</a> is 1, then whenever
- there are no <code><a href=#the-option-element>option</a></code> elements in the <code><a href=#the-select-element>select</a></code>
- element's <a href=#concept-select-option-list title=concept-select-option-list>list of
- options</a> that have their <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to true,
- the user agent must set the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of the first
- <code><a href=#the-option-element>option</a></code> element in the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> in
- <a href=#tree-order>tree order</a> that is not <a href=#concept-option-disabled title=concept-option-disabled>disabled</a>, if any, to
+ <p>If the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute is absent and the element's
+ <a href=#concept-select-size title=concept-select-size>display size</a> is 1, then whenever there are no
+ <code><a href=#the-option-element>option</a></code> elements in the <code><a href=#the-select-element>select</a></code> element's <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> that have their <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to true, the user agent must set the
+ <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of the first <code><a href=#the-option-element>option</a></code>
+ element in the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> in <a href=#tree-order>tree
+ order</a> that is not <a href=#concept-option-disabled title=concept-option-disabled>disabled</a>, if any, to
true.</p>
- <p>If the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code>
- attribute is present, and the element is not <a href=#concept-fe-disabled title=concept-fe-disabled>disabled</a>, then the user agent
- should allow the user to <dfn id=concept-select-toggle title=concept-select-toggle>toggle</dfn> the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of the
- <code><a href=#the-option-element>option</a></code> elements in its <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> that are
- themselves not <a href=#concept-option-disabled title=concept-option-disabled>disabled</a>
- (either through a click, or through a <a href=#using-the-option-element-to-define-a-command title=option-command>menu command</a>, or any other mechanism).
- Upon the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of one or
- more <code><a href=#the-option-element>option</a></code> elements being changed by the user, and
- before the relevant user interaction event <!-- interaction event
- spec point --> is queued (e.g. before a related <code title=event-click><a href=#event-click>click</a></code> event), the user agent must
- <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple event</a> that
- bubbles named <code title=event-change>change</code> at the
- <code><a href=#the-select-element>select</a></code> element, using the <a href=#user-interaction-task-source>user interaction task
- source</a> as the task source.</p>
+ <p>If the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute is present, and the element
+ is not <a href=#concept-fe-disabled title=concept-fe-disabled>disabled</a>, then the user agent should allow the
+ user to <dfn id=concept-select-toggle title=concept-select-toggle>toggle</dfn> the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of the <code><a href=#the-option-element>option</a></code> elements in its
+ <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> that are themselves not <a href=#concept-option-disabled title=concept-option-disabled>disabled</a> (either through a click, or through a <a href=#using-the-option-element-to-define-a-command title=option-command>menu command</a>, or any other mechanism). Upon the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of one or more <code><a href=#the-option-element>option</a></code>
+ elements being changed by the user, and before the relevant user interaction event <!--
+ interaction event spec point --> is queued (e.g. before a related <code title=event-click><a href=#event-click>click</a></code> event), the user agent must <a href=#queue-a-task>queue a task</a> to
+ <a href=#fire-a-simple-event>fire a simple event</a> that bubbles named <code title=event-change>change</code> at
+ the <code><a href=#the-select-element>select</a></code> element, using the <a href=#user-interaction-task-source>user interaction task source</a> as the task
+ source.</p>
- <p>The <a href=#concept-form-reset-control title=concept-form-reset-control>reset
- algorithm</a> for <code><a href=#the-select-element>select</a></code> elements is to go through
- all the <code><a href=#the-option-element>option</a></code> elements in the element's <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>, and set
- their <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a>
- to true if the <code><a href=#the-option-element>option</a></code> element has a <code title=attr-option-selected><a href=#attr-option-selected>selected</a></code> attribute, and false
- otherwise.</p>
+ <p>The <a href=#concept-form-reset-control title=concept-form-reset-control>reset algorithm</a> for <code><a href=#the-select-element>select</a></code>
+ elements is to go through all the <code><a href=#the-option-element>option</a></code> elements in the element's <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>, and set their <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> to true if the <code><a href=#the-option-element>option</a></code> element
+ has a <code title=attr-option-selected><a href=#attr-option-selected>selected</a></code> attribute, and false otherwise.</p>
</div>
- <p>The <code title=attr-fae-form><a href=#attr-fae-form>form</a></code> attribute is used to
- explicitly associate the <code><a href=#the-select-element>select</a></code> element with its
- <a href=#form-owner>form owner</a>. The <code title=attr-fe-name><a href=#attr-fe-name>name</a></code>
- attribute represents the element's name. The <code title=attr-fe-disabled><a href=#attr-fe-disabled>disabled</a></code> attribute is used to make
- the control non-interactive and to prevent its value from being
- submitted. The <code title=attr-fe-autofocus><a href=#attr-fe-autofocus>autofocus</a></code>
+ <p>The <code title=attr-fae-form><a href=#attr-fae-form>form</a></code> attribute is used to explicitly associate the
+ <code><a href=#the-select-element>select</a></code> element with its <a href=#form-owner>form owner</a>. The <code title=attr-fe-name><a href=#attr-fe-name>name</a></code> attribute represents the element's name. The <code title=attr-fe-disabled><a href=#attr-fe-disabled>disabled</a></code> attribute is used to make the control non-interactive and
+ to prevent its value from being submitted. The <code title=attr-fe-autofocus><a href=#attr-fe-autofocus>autofocus</a></code>
attribute controls focus.</p>
- <p>A <code><a href=#the-select-element>select</a></code> element that is not <a href=#concept-fe-disabled title=concept-fe-disabled>disabled</a> is <i title=concept-fe-mutable><a href=#concept-fe-mutable>mutable</a></i>.</p>
+ <p>A <code><a href=#the-select-element>select</a></code> element that is not <a href=#concept-fe-disabled title=concept-fe-disabled>disabled</a> is
+ <i title=concept-fe-mutable><a href=#concept-fe-mutable>mutable</a></i>.</p>
<!--TOPIC:DOM APIs-->
<dl class=domintro><dt><var title="">select</var> . <code title=dom-select-type><a href=#dom-select-type>type</a></code></dt>
<dd>
- <p>Returns "<code title="">select-multiple</code>" if the element
- has a <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code>
- attribute, and "<code title="">select-one</code>"
+ <p>Returns "<code title="">select-multiple</code>" if the element has a <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute, and "<code title="">select-one</code>"
otherwise.</p>
</dd>
@@ -51951,46 +51901,59 @@
<dt><var title="">select</var> . <code title=dom-select-length><a href=#dom-select-length>length</a></code> [ = <var title="">value</var> ]</dt>
<dd>
- <p>Returns the number of elements in the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>.</p>
- <p>When set to a smaller number, truncates the number of <code><a href=#the-option-element>option</a></code> elements in the <code><a href=#the-select-element>select</a></code>.</p>
- <p>When set to a greater number, adds new blank <code><a href=#the-option-element>option</a></code> elements to the <code><a href=#the-select-element>select</a></code>.</p>
+
+ <p>Returns the number of elements in the <a href=#concept-select-option-list title=concept-select-option-list>list of
+ options</a>.</p>
+
+ <p>When set to a smaller number, truncates the number of <code><a href=#the-option-element>option</a></code> elements in the
+ <code><a href=#the-select-element>select</a></code>.</p>
+
+ <p>When set to a greater number, adds new blank <code><a href=#the-option-element>option</a></code> elements to the
+ <code><a href=#the-select-element>select</a></code>.</p>
+
</dd>
<dt><var title="">element</var> = <var title="">select</var> . <code title=dom-select-item><a href=#dom-select-item>item</a></code>(<var title="">index</var>)</dt>
<dt><var title="">select</var>[<var title="">index</var>]</dt>
<dd>
- <p>Returns the item with index <var title="">index</var> from the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>. The items are sorted in <a href=#tree-order>tree order</a>.</p>
+
+ <p>Returns the item with index <var title="">index</var> from the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>. The items are sorted in <a href=#tree-order>tree
+ order</a>.</p>
+
</dd>
<dt><var title="">element</var> = <var title="">select</var> . <code title=dom-select-item><a href=#dom-select-item>namedItem</a></code>(<var title="">name</var>)</dt>
<dd>
+
<p>Returns the item with <a href=#concept-id title=concept-id>ID</a> or <code title=attr-option-name><a href=#attr-option-name>name</a></code> <var title="">name</var> from the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>.</p>
- <p>If there are multiple matching items, then a <code><a href=#nodelist>NodeList</a></code> object containing all those elements is returned.</p>
+
+ <p>If there are multiple matching items, then a <code><a href=#nodelist>NodeList</a></code> object containing all
+ those elements is returned.</p>
+
<p>Returns null if no element with that <a href=#concept-id title=concept-id>ID</a> could be found.</p>
+
</dd>
<dt><var title="">select</var> . <code title=dom-select-add><a href=#dom-select-add>add</a></code>(<var title="">element</var> [, <var title="">before</var> ])</dt>
<dd>
+
<p>Inserts <var title="">element</var> before the node given by <var title="">before</var>.</p>
- <p>The <var title="">before</var> argument can be a number, in
- which case <var title="">element</var> is inserted before the item
- with that number, or an element from the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>, in
- which case <var title="">element</var> is inserted before that
- element.</p>
- <p>If <var title="">before</var> is omitted, null, or a number out
- of range, then <var title="">element</var> will be added at the
- end of the list.</p>
- <p>This method will throw a <code><a href=#hierarchyrequesterror>HierarchyRequestError</a></code>
- exception if <var title="">element</var> is an ancestor of the
- element into which it is to be inserted.</p>
+
+ <p>The <var title="">before</var> argument can be a number, in which case <var title="">element</var> is inserted before the item with that number, or an element from the
+ <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>, in which case <var title="">element</var> is inserted before that element.</p>
+
+ <p>If <var title="">before</var> is omitted, null, or a number out of range, then <var title="">element</var> will be added at the end of the list.</p>
+
+ <p>This method will throw a <code><a href=#hierarchyrequesterror>HierarchyRequestError</a></code> exception if <var title="">element</var> is an ancestor of the element into which it is to be inserted.</p>
+
</dd>
<dt><var title="">select</var> . <code title=dom-select-selectedOptions><a href=#dom-select-selectedoptions>selectedOptions</a></code></dt>
<dd>
- <p>Returns an <code><a href=#htmlcollection>HTMLCollection</a></code> of the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> that are
- selected.</p>
+ <p>Returns an <code><a href=#htmlcollection>HTMLCollection</a></code> of the <a href=#concept-select-option-list title=concept-select-option-list>list
+ of options</a> that are selected.</p>
</dd>
@@ -51998,8 +51961,8 @@
<dd>
- <p>Returns the index of the first selected item, if any, or
- −1 if there is no selected item.</p>
+ <p>Returns the index of the first selected item, if any, or −1 if there is no selected
+ item.</p>
<p>Can be set, to change the selection.</p>
@@ -52009,9 +51972,8 @@
<dd>
- <p>Returns the <a href=#concept-fe-value title=concept-fe-value>value</a> of the
- first selected item, if any, or the empty string if there is no
- selected item.</p>
+ <p>Returns the <a href=#concept-fe-value title=concept-fe-value>value</a> of the first selected item, if any,
+ or the empty string if there is no selected item.</p>
<p>Can be set, to change the selection.</p>
@@ -52019,110 +51981,89 @@
</dl><div class=impl>
- <p>The <dfn id=dom-select-type title=dom-select-type><code>type</code></dfn> IDL
- attribute, on getting, must return the string "<code title="">select-one</code>" if the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute is absent,
- and the string "<code title="">select-multiple</code>" if the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute is
- present.</p>
+ <p>The <dfn id=dom-select-type title=dom-select-type><code>type</code></dfn> IDL attribute, on getting, must return
+ the string "<code title="">select-one</code>" if the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute is absent, and the string "<code title="">select-multiple</code>" if the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code>
+ attribute is present.</p>
- <p>The <dfn id=dom-select-options title=dom-select-options><code>options</code></dfn>
- IDL attribute must return an <code><a href=#htmloptionscollection>HTMLOptionsCollection</a></code>
- rooted at the <code><a href=#the-select-element>select</a></code> node, whose filter matches the
- elements in the <a href=#concept-select-option-list title=concept-select-option-list>list of
- options</a>.</p>
+ <p>The <dfn id=dom-select-options title=dom-select-options><code>options</code></dfn> IDL attribute must return an
+ <code><a href=#htmloptionscollection>HTMLOptionsCollection</a></code> rooted at the <code><a href=#the-select-element>select</a></code> node, whose filter matches
+ the elements in the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>.</p>
- <p>The <code title=dom-select-options><a href=#dom-select-options>options</a></code> collection is
- also mirrored on the <code><a href=#htmlselectelement>HTMLSelectElement</a></code> object. The
- <a href=#supported-property-indices>supported property indices</a> at any instant are the
- indices supported by the object returned by the <code title=dom-select-options><a href=#dom-select-options>options</a></code> attribute at that
- instant.</p>
+ <p>The <code title=dom-select-options><a href=#dom-select-options>options</a></code> collection is also mirrored on the
+ <code><a href=#htmlselectelement>HTMLSelectElement</a></code> object. The <a href=#supported-property-indices>supported property indices</a> at any instant
+ are the indices supported by the object returned by the <code title=dom-select-options><a href=#dom-select-options>options</a></code> attribute at that instant.</p>
- <p>The <dfn id=dom-select-length title=dom-select-length><code>length</code></dfn> IDL
- attribute must return the number of nodes <a href=#represented-by-the-collection title="represented
- by the collection">represented</a> by the <code title=dom-select-options><a href=#dom-select-options>options</a></code> collection. On setting, it
- must act like the attribute of the same name on the <code title=dom-select-options><a href=#dom-select-options>options</a></code> collection.</p>
+ <p>The <dfn id=dom-select-length title=dom-select-length><code>length</code></dfn> IDL attribute must return the
+ number of nodes <a href=#represented-by-the-collection title="represented by the collection">represented</a> by the <code title=dom-select-options><a href=#dom-select-options>options</a></code> collection. On setting, it must act like the attribute
+ of the same name on the <code title=dom-select-options><a href=#dom-select-options>options</a></code> collection.</p>
- <p>The <dfn id=dom-select-item title=dom-select-item><code>item(<var title="">index</var>)</code></dfn> method must return the value
- returned by the method of the same name on the <code title=dom-select-options><a href=#dom-select-options>options</a></code> collection, when invoked
- with the same argument.</p>
+ <p>The <dfn id=dom-select-item title=dom-select-item><code>item(<var title="">index</var>)</code></dfn> method must
+ return the value returned by the method of the same name on the <code title=dom-select-options><a href=#dom-select-options>options</a></code> collection, when invoked with the same argument.</p>
- <p>The <dfn id=dom-select-nameditem title=dom-select-namedItem><code>namedItem(<var title="">name</var>)</code></dfn> method must return the value
- returned by the method of the same name on the <code title=dom-select-options><a href=#dom-select-options>options</a></code> collection, when invoked
- with the same argument.</p>
+ <p>The <dfn id=dom-select-nameditem title=dom-select-namedItem><code>namedItem(<var title="">name</var>)</code></dfn>
+ method must return the value returned by the method of the same name on the <code title=dom-select-options><a href=#dom-select-options>options</a></code> collection, when invoked with the same argument.</p>
- <p>When the user agent is to <dfn id=dom-htmlselectelement-setter title=dom-HTMLSelectElement-setter>set the value of a new indexed
- property</dfn> for a given property index <var title="">index</var>
- to a new value <var title="">value</var>, it must instead <a href=#dom-htmloptionscollection-setter title=dom-HTMLOptionsCollection-setter>set the value of a new
- indexed property</a> with the given property index <var title="">index</var> to the new value <var title="">value</var> on the
- <code title=dom-select-options><a href=#dom-select-options>options</a></code> collection.</p>
+ <p>When the user agent is to <dfn id=dom-htmlselectelement-setter title=dom-HTMLSelectElement-setter>set the value of a new
+ indexed property</dfn> for a given property index <var title="">index</var> to a new value <var title="">value</var>, it must instead <a href=#dom-htmloptionscollection-setter title=dom-HTMLOptionsCollection-setter>set the value
+ of a new indexed property</a> with the given property index <var title="">index</var> to the
+ new value <var title="">value</var> on the <code title=dom-select-options><a href=#dom-select-options>options</a></code>
+ collection.</p>
- <p>Similarly, the <dfn id=dom-select-add title=dom-select-add><code>add()</code></dfn> and <dfn id=dom-select-remove title=dom-select-remove><code>remove()</code></dfn> methods must
- act like their namesake methods on that same <code title=dom-select-options><a href=#dom-select-options>options</a></code> collection.</p>
+ <p>Similarly, the <dfn id=dom-select-add title=dom-select-add><code>add()</code></dfn> and <dfn id=dom-select-remove title=dom-select-remove><code>remove()</code></dfn> methods must act like their namesake methods
+ on that same <code title=dom-select-options><a href=#dom-select-options>options</a></code> collection.</p>
- <p>The <dfn id=dom-select-selectedoptions title=dom-select-selectedOptions><code>selectedOptions</code></dfn>
- IDL attribute must return an <code><a href=#htmlcollection>HTMLCollection</a></code> rooted at
- the <code><a href=#the-select-element>select</a></code> node, whose filter matches the elements in
- the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>
- that have their <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to
- true.</p>
+ <p>The <dfn id=dom-select-selectedoptions title=dom-select-selectedOptions><code>selectedOptions</code></dfn> IDL attribute
+ must return an <code><a href=#htmlcollection>HTMLCollection</a></code> rooted at the <code><a href=#the-select-element>select</a></code> node, whose filter
+ matches the elements in the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> that
+ have their <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to true.</p>
- <p>The <dfn id=dom-select-selectedindex title=dom-select-selectedIndex><code>selectedIndex</code></dfn>
- IDL attribute, on getting, must return the <a href=#concept-option-index title=concept-option-index>index</a> of the first
- <code><a href=#the-option-element>option</a></code> element in the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> in
- <a href=#tree-order>tree order</a> that has its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to true,
- if any. If there isn't one, then it must return −1.</p>
+ <p>The <dfn id=dom-select-selectedindex title=dom-select-selectedIndex><code>selectedIndex</code></dfn> IDL attribute, on
+ getting, must return the <a href=#concept-option-index title=concept-option-index>index</a> of the first
+ <code><a href=#the-option-element>option</a></code> element in the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>
+ in <a href=#tree-order>tree order</a> that has its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to true, if any. If there isn't one,
+ then it must return −1.</p>
- <p>On setting, the <code title=dom-select-selectedIndex><a href=#dom-select-selectedindex>selectedIndex</a></code> attribute must
- set the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of all the
- <code><a href=#the-option-element>option</a></code> elements in the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> to false,
- and then the <code><a href=#the-option-element>option</a></code> element in the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> whose
- <a href=#concept-option-index title=concept-option-index>index</a> is the given new
- value, if any, must have its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to
- true.</p>
+ <p>On setting, the <code title=dom-select-selectedIndex><a href=#dom-select-selectedindex>selectedIndex</a></code> attribute must set
+ the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of all the <code><a href=#the-option-element>option</a></code>
+ elements in the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> to false, and then
+ the <code><a href=#the-option-element>option</a></code> element in the <a href=#concept-select-option-list title=concept-select-option-list>list of
+ options</a> whose <a href=#concept-option-index title=concept-option-index>index</a> is the given new value, if
+ any, must have its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to true.</p>
- <p>The <dfn id=dom-select-value title=dom-select-value><code>value</code></dfn> IDL
- attribute, on getting, must return the <a href=#concept-option-value title=concept-option-value>value</a> of the first
- <code><a href=#the-option-element>option</a></code> element in the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> in
- <a href=#tree-order>tree order</a> that has its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to true,
- if any. If there isn't one, then it must return the empty
- string.</p>
+ <p>The <dfn id=dom-select-value title=dom-select-value><code>value</code></dfn> IDL attribute, on getting, must
+ return the <a href=#concept-option-value title=concept-option-value>value</a> of the first <code><a href=#the-option-element>option</a></code>
+ element in the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> in <a href=#tree-order>tree
+ order</a> that has its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to
+ true, if any. If there isn't one, then it must return the empty string.</p>
- <p>On setting, the <code title=dom-select-value><a href=#dom-select-value>value</a></code>
- attribute must set the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of all the
- <code><a href=#the-option-element>option</a></code> elements in the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> to false,
- and then the first <code><a href=#the-option-element>option</a></code> element in the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>, in
- <a href=#tree-order>tree order</a>, whose <a href=#concept-option-value title=concept-option-value>value</a> is equal to the given new
- value, if any, must have its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to
- true.</p>
+ <p>On setting, the <code title=dom-select-value><a href=#dom-select-value>value</a></code> attribute must set the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of all the <code><a href=#the-option-element>option</a></code> elements in
+ the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> to false, and then the first
+ <code><a href=#the-option-element>option</a></code> element in the <a href=#concept-select-option-list title=concept-select-option-list>list of
+ options</a>, in <a href=#tree-order>tree order</a>, whose <a href=#concept-option-value title=concept-option-value>value</a>
+ is equal to the given new value, if any, must have its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to true.</p>
- <p>The <dfn id=dom-select-multiple title=dom-select-multiple><code>multiple</code></dfn>,
- <dfn id=dom-select-required title=dom-select-required><code>required</code></dfn>, and
- <dfn id=dom-select-size title=dom-select-size><code>size</code></dfn> IDL attributes
- must <a href=#reflect>reflect</a> the respective content attributes of the
- same name. The <code title=dom-select-size><a href=#dom-select-size>size</a></code> IDL
- attribute has a default value of zero.</p> <!-- see bug 12288 for
- compat reasons why .size allows zero (it's not limited to values
- greater than zero) even though that value really makes no sense -->
+ <p>The <dfn id=dom-select-multiple title=dom-select-multiple><code>multiple</code></dfn>, <dfn id=dom-select-required title=dom-select-required><code>required</code></dfn>, and <dfn id=dom-select-size title=dom-select-size><code>size</code></dfn> IDL attributes must <a href=#reflect>reflect</a> the
+ respective content attributes of the same name. The <code title=dom-select-size><a href=#dom-select-size>size</a></code> IDL
+ attribute has a default value of zero.</p> <!-- see bug 12288 for compat reasons why .size allows
+ zero (it's not limited to values greater than zero) even though that value really makes no sense
+ -->
- <p class=note>For historical reasons, the default value of the
- <code title=dom-select-size><a href=#dom-select-size>size</a></code> IDL attribute does not
- return the actual size used, which, in the absence of the <code title=attr-select-size><a href=#attr-select-size>size</a></code> content attribute, is either 1
- or 4 depending on the presence of the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute.</p>
+ <p class=note>For historical reasons, the default value of the <code title=dom-select-size><a href=#dom-select-size>size</a></code> IDL attribute does not return the actual size used, which, in
+ the absence of the <code title=attr-select-size><a href=#attr-select-size>size</a></code> content attribute, is either 1 or 4
+ depending on the presence of the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute.</p>
- <p>The <code title=dom-cva-willValidate><a href=#dom-cva-willvalidate>willValidate</a></code>, <code title=dom-cva-validity><a href=#dom-cva-validity>validity</a></code>, and <code title=dom-cva-validationMessage><a href=#dom-cva-validationmessage>validationMessage</a></code> IDL
- attributes, and the <code title=dom-cva-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code> and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code>
- methods, are part of the <a href=#the-constraint-validation-api>constraint validation API</a>. The
- <code title=dom-lfe-labels><a href=#dom-lfe-labels>labels</a></code> IDL attribute provides a
- list of the element's <code><a href=#the-label-element>label</a></code>s. The <code title=dom-fe-autofocus><a href=#dom-fe-autofocus>autofocus</a></code>, <code title=dom-fe-disabled><a href=#dom-fe-disabled>disabled</a></code>, <code title=dom-fae-form><a href=#dom-fae-form>form</a></code>, and <code title=dom-fe-name><a href=#dom-fe-name>name</a></code> IDL attributes are part of the
- element's forms API.</p>
+ <p>The <code title=dom-cva-willValidate><a href=#dom-cva-willvalidate>willValidate</a></code>, <code title=dom-cva-validity><a href=#dom-cva-validity>validity</a></code>, and <code title=dom-cva-validationMessage><a href=#dom-cva-validationmessage>validationMessage</a></code> IDL attributes, and the <code title=dom-cva-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code> and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code> methods, are part of the
+ <a href=#the-constraint-validation-api>constraint validation API</a>. The <code title=dom-lfe-labels><a href=#dom-lfe-labels>labels</a></code> IDL
+ attribute provides a list of the element's <code><a href=#the-label-element>label</a></code>s. The <code title=dom-fe-autofocus><a href=#dom-fe-autofocus>autofocus</a></code>, <code title=dom-fe-disabled><a href=#dom-fe-disabled>disabled</a></code>, <code title=dom-fae-form><a href=#dom-fae-form>form</a></code>, and <code title=dom-fe-name><a href=#dom-fe-name>name</a></code> IDL attributes are
+ part of the element's forms API.</p>
</div>
<!--TOPIC:HTML-->
<div class=example>
- <p>The following example shows how a <code><a href=#the-select-element>select</a></code> element
- can be used to offer the user with a set of options from which the
- user can select a single option. The default option is
+ <p>The following example shows how a <code><a href=#the-select-element>select</a></code> element can be used to offer the user
+ with a set of options from which the user can select a single option. The default option is
preselected.</p>
<pre><p>
@@ -52136,8 +52077,7 @@
</select>
</p></pre>
- <p>When there is no default option, a placeholder can be used
- instead:</p>
+ <p>When there is no default option, a placeholder can be used instead:</p>
<pre><select name="unittype" <strong>required</strong>>
<strong><option value=""> Select unit type </option></strong>
@@ -52152,8 +52092,8 @@
<div class=example>
- <p>Here, the user is offered a set of options from which he can
- select any number. By default, all five options are selected.</p>
+ <p>Here, the user is offered a set of options from which he can select any number. By default,
+ all five options are selected.</p>
<pre><p>
<label for="allowedunits">Select unit types to enable on this map:</label>
@@ -52170,8 +52110,7 @@
<div class=example>
- <p>Sometimes, a user has to select one or more items. This example
- shows such an interface.</p>
+ <p>Sometimes, a user has to select one or more items. This example shows such an interface.</p>
<pre><p>Select the songs from that you would like on your Act II Mix Tape:</p>
<select multiple required name="act2">
Modified: index
===================================================================
--- index 2012-12-01 22:30:58 UTC (rev 7557)
+++ index 2012-12-01 22:39:52 UTC (rev 7558)
@@ -51765,178 +51765,128 @@
http://developers.slashdot.org/comments.pl?sid=426306&cid=22142072
<Philip`> http://www.ipiao.com.cn/ does <select size="1" name="to"><script>City_Default="PEK"</script><SCRIPT language=javascript
src="/js/flightcity.js"></SCRIPT></select> which is the kind of thing that could be much simpler with <select value="PEK">
- --><p>The <code><a href=#the-select-element>select</a></code> element represents a control for
- selecting amongst a set of options.</p>
+ --><p>The <code><a href=#the-select-element>select</a></code> element represents a control for selecting amongst a set of
+ options.</p>
- <p>The <dfn id=attr-select-multiple title=attr-select-multiple><code>multiple</code></dfn>
- attribute is a <a href=#boolean-attribute>boolean attribute</a>. If the attribute is
- present, then the <code><a href=#the-select-element>select</a></code> element
- <a href=#represents>represents</a> a control for selecting zero or more options
- from the <a href=#concept-select-option-list title=concept-select-option-list>list of
- options</a>. If the attribute is absent, then the
- <code><a href=#the-select-element>select</a></code> element <a href=#represents>represents</a> a control for
- selecting a single option from the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>.</p>
+ <p>The <dfn id=attr-select-multiple title=attr-select-multiple><code>multiple</code></dfn> attribute is a <a href=#boolean-attribute>boolean
+ attribute</a>. If the attribute is present, then the <code><a href=#the-select-element>select</a></code> element
+ <a href=#represents>represents</a> a control for selecting zero or more options from the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>. If the attribute is absent, then the
+ <code><a href=#the-select-element>select</a></code> element <a href=#represents>represents</a> a control for selecting a single option from
+ the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>.</p>
- <p>The <dfn id=attr-select-size title=attr-select-size><code>size</code></dfn>
- attribute gives the number of options to show to the user. The <code title=attr-select-size><a href=#attr-select-size>size</a></code> attribute, if specified, must
- have a value that is a <a href=#valid-non-negative-integer>valid non-negative integer</a>
- greater than zero.</p>
+ <p>The <dfn id=attr-select-size title=attr-select-size><code>size</code></dfn> attribute gives the number of options
+ to show to the user. The <code title=attr-select-size><a href=#attr-select-size>size</a></code> attribute, if specified, must
+ have a value that is a <a href=#valid-non-negative-integer>valid non-negative integer</a> greater than zero.</p>
<div class=impl>
- <p>The <dfn id=concept-select-size title=concept-select-size>display size</dfn> of a
- <code><a href=#the-select-element>select</a></code> element is the result of applying the
- <a href=#rules-for-parsing-non-negative-integers>rules for parsing non-negative integers</a> to the value of
- element's <code title=attr-select-size><a href=#attr-select-size>size</a></code> attribute, if
- it has one and parsing it is successful. If applying those rules to
- the attribute's value is not successful, or if the <code title=attr-select-size><a href=#attr-select-size>size</a></code> attribute is absent, then the
- element's <a href=#concept-select-size title=concept-select-size>display size</a> is 4
- if the element's <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code>
- content attribute is present, and 1 otherwise.</p>
+ <p>The <dfn id=concept-select-size title=concept-select-size>display size</dfn> of a <code><a href=#the-select-element>select</a></code> element is the
+ result of applying the <a href=#rules-for-parsing-non-negative-integers>rules for parsing non-negative integers</a> to the value of
+ element's <code title=attr-select-size><a href=#attr-select-size>size</a></code> attribute, if it has one and parsing it is
+ successful. If applying those rules to the attribute's value is not successful, or if the <code title=attr-select-size><a href=#attr-select-size>size</a></code> attribute is absent, then the element's <a href=#concept-select-size title=concept-select-size>display size</a> is 4 if the element's <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> content attribute is present, and 1 otherwise.</p>
</div>
- <p>The <dfn id=concept-select-option-list title=concept-select-option-list>list of options</dfn>
- for a <code><a href=#the-select-element>select</a></code> element consists of all the
- <code><a href=#the-option-element>option</a></code> element children of the <code><a href=#the-select-element>select</a></code>
- element, and all the <code><a href=#the-option-element>option</a></code> element children of all the
- <code><a href=#the-optgroup-element>optgroup</a></code> element children of the <code><a href=#the-select-element>select</a></code>
- element, in <a href=#tree-order>tree order</a>.</p>
+ <p>The <dfn id=concept-select-option-list title=concept-select-option-list>list of options</dfn> for a <code><a href=#the-select-element>select</a></code>
+ element consists of all the <code><a href=#the-option-element>option</a></code> element children of the <code><a href=#the-select-element>select</a></code>
+ element, and all the <code><a href=#the-option-element>option</a></code> element children of all the <code><a href=#the-optgroup-element>optgroup</a></code> element
+ children of the <code><a href=#the-select-element>select</a></code> element, in <a href=#tree-order>tree order</a>.</p>
- <p>The <dfn id=attr-select-required title=attr-select-required><code>required</code></dfn>
- attribute is a <a href=#boolean-attribute>boolean attribute</a>. When specified, the
- user will be required to select a value before submitting the
- form.</p>
+ <p>The <dfn id=attr-select-required title=attr-select-required><code>required</code></dfn> attribute is a <a href=#boolean-attribute>boolean
+ attribute</a>. When specified, the user will be required to select a value before submitting
+ the form.</p>
- <p>If a <code><a href=#the-select-element>select</a></code> element has a <code title=attr-select-required><a href=#attr-select-required>required</a></code> attribute specified,
- does not have a <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code>
- attribute specified, and has a <a href=#concept-select-size title=concept-select-size>display size</a> of 1;
- and if the <a href=#concept-option-value title=concept-option-value>value</a> of the
- first <code><a href=#the-option-element>option</a></code> element in the <code><a href=#the-select-element>select</a></code>
- element's <a href=#concept-select-option-list title=concept-select-option-list>list of
- options</a> (if any) is the empty string, and that
- <code><a href=#the-option-element>option</a></code> element's parent node is the <code><a href=#the-select-element>select</a></code>
- element (and not an <code><a href=#the-optgroup-element>optgroup</a></code> element), then that
- <code><a href=#the-option-element>option</a></code> is the <code><a href=#the-select-element>select</a></code> element's
- <dfn id=placeholder-label-option>placeholder label option</dfn>.</p>
+ <p>If a <code><a href=#the-select-element>select</a></code> element has a <code title=attr-select-required><a href=#attr-select-required>required</a></code>
+ attribute specified, does not have a <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute
+ specified, and has a <a href=#concept-select-size title=concept-select-size>display size</a> of 1; and if the <a href=#concept-option-value title=concept-option-value>value</a> of the first <code><a href=#the-option-element>option</a></code> element in the
+ <code><a href=#the-select-element>select</a></code> element's <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> (if
+ any) is the empty string, and that <code><a href=#the-option-element>option</a></code> element's parent node is the
+ <code><a href=#the-select-element>select</a></code> element (and not an <code><a href=#the-optgroup-element>optgroup</a></code> element), then that
+ <code><a href=#the-option-element>option</a></code> is the <code><a href=#the-select-element>select</a></code> element's <dfn id=placeholder-label-option>placeholder label option</dfn>.</p>
- <p>If a <code><a href=#the-select-element>select</a></code> element has a <code title=attr-select-required><a href=#attr-select-required>required</a></code> attribute specified,
- does not have a <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code>
- attribute specified, and has a <a href=#concept-select-size title=concept-select-size>display size</a> of 1,
- then the <code><a href=#the-select-element>select</a></code> element must have a <a href=#placeholder-label-option>placeholder
- label option</a>.</p>
+ <p>If a <code><a href=#the-select-element>select</a></code> element has a <code title=attr-select-required><a href=#attr-select-required>required</a></code>
+ attribute specified, does not have a <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute
+ specified, and has a <a href=#concept-select-size title=concept-select-size>display size</a> of 1, then the
+ <code><a href=#the-select-element>select</a></code> element must have a <a href=#placeholder-label-option>placeholder label option</a>.</p>
<div class=impl>
- <p><strong>Constraint validation</strong>: If the element has its
- <code title=attr-select-required><a href=#attr-select-required>required</a></code> attribute
- specified, and either none of the <code><a href=#the-option-element>option</a></code> elements in
- the <code><a href=#the-select-element>select</a></code> element's <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> have their
- <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to
- true, or the only <code><a href=#the-option-element>option</a></code> element in the
- <code><a href=#the-select-element>select</a></code> element's <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> with its
- <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to
- true is the <a href=#placeholder-label-option>placeholder label option</a>, then the element
- is <a href=#suffering-from-being-missing>suffering from being missing</a>.</p>
+ <p><strong>Constraint validation</strong>: If the element has its <code title=attr-select-required><a href=#attr-select-required>required</a></code> attribute specified, and either none of the
+ <code><a href=#the-option-element>option</a></code> elements in the <code><a href=#the-select-element>select</a></code> element's <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> have their <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to true, or the only
+ <code><a href=#the-option-element>option</a></code> element in the <code><a href=#the-select-element>select</a></code> element's <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> with its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to true is the <a href=#placeholder-label-option>placeholder label
+ option</a>, then the element is <a href=#suffering-from-being-missing>suffering from being missing</a>.</p>
</div>
<div class=impl>
- <p>If the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code>
- attribute is absent, and the element is not <a href=#concept-fe-disabled title=concept-fe-disabled>disabled</a>, then the user agent
- should allow the user to pick an <code><a href=#the-option-element>option</a></code> element in its
- <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> that
- is itself not <a href=#concept-option-disabled title=concept-option-disabled>disabled</a>.
- Upon this <code><a href=#the-option-element>option</a></code> element being <dfn id=concept-select-pick title=concept-select-pick>picked</dfn> (either through a click, or
- through unfocusing the element after changing its value, or through
- a <a href=#using-the-option-element-to-define-a-command title=option-command>menu command</a>, or through any
- other mechanism), and before the relevant user interaction event
- <!-- interaction event spec point --> is queued (e.g. before the
- <code title=event-click><a href=#event-click>click</a></code> event), the user agent must
- set the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of the
- picked <code><a href=#the-option-element>option</a></code> element to true and then <a href=#queue-a-task>queue a
- task</a> to <a href=#fire-a-simple-event>fire a simple event</a> that bubbles named
- <code title=event-change>change</code> at the <code><a href=#the-select-element>select</a></code>
- element, using the <a href=#user-interaction-task-source>user interaction task source</a> as the
- task source.</p>
+ <p>If the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute is absent, and the element
+ is not <a href=#concept-fe-disabled title=concept-fe-disabled>disabled</a>, then the user agent should allow the
+ user to pick an <code><a href=#the-option-element>option</a></code> element in its <a href=#concept-select-option-list title=concept-select-option-list>list
+ of options</a> that is itself not <a href=#concept-option-disabled title=concept-option-disabled>disabled</a>. Upon
+ this <code><a href=#the-option-element>option</a></code> element being <dfn id=concept-select-pick title=concept-select-pick>picked</dfn> (either
+ through a click, or through unfocusing the element after changing its value, or through a <a href=#using-the-option-element-to-define-a-command title=option-command>menu command</a>, or through any other mechanism), and before the
+ relevant user interaction event <!-- interaction event spec point --> is queued (e.g. before the
+ <code title=event-click><a href=#event-click>click</a></code> event), the user agent must set the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of the picked <code><a href=#the-option-element>option</a></code> element
+ to true and then <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple event</a> that bubbles named
+ <code title=event-change>change</code> at the <code><a href=#the-select-element>select</a></code> element, using the <a href=#user-interaction-task-source>user
+ interaction task source</a> as the task source.</p>
- <p>If the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code>
- attribute is absent, whenever an <code><a href=#the-option-element>option</a></code> element in the
- <code><a href=#the-select-element>select</a></code> element's <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> has its
- <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to
- true, and whenever an <code><a href=#the-option-element>option</a></code> element with its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to true
- is added to the <code><a href=#the-select-element>select</a></code> element's <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>, the user
- agent must set the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of all the
- other <code><a href=#the-option-element>option</a></code> element in its <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> to
- false.</p>
+ <p>If the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute is absent, whenever an
+ <code><a href=#the-option-element>option</a></code> element in the <code><a href=#the-select-element>select</a></code> element's <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> has its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to true, and whenever an
+ <code><a href=#the-option-element>option</a></code> element with its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a>
+ set to true is added to the <code><a href=#the-select-element>select</a></code> element's <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>, the user agent must set the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of all the other <code><a href=#the-option-element>option</a></code>
+ element in its <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> to false.</p>
- <p>If the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code>
- attribute is absent and the element's <a href=#concept-select-size title=concept-select-size>display size</a> is greater than 1,
- then the user agent should also allow the user to request that the
- <code><a href=#the-option-element>option</a></code> whose <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> is true, if
- any, be unselected. Upon this request being conveyed to the user
- agent, and before the relevant user interaction event <!--
- interaction event spec point --> is queued (e.g. before the <code title=event-click><a href=#event-click>click</a></code> event), the user agent must set the
- <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of
- that <code><a href=#the-option-element>option</a></code> element to false and then <a href=#queue-a-task>queue a
- task</a> to <a href=#fire-a-simple-event>fire a simple event</a> that bubbles named
- <code title=event-change>change</code> at the <code><a href=#the-select-element>select</a></code>
- element, using the <a href=#user-interaction-task-source>user interaction task source</a> as the
- task source.</p>
+ <p>If the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute is absent and the element's
+ <a href=#concept-select-size title=concept-select-size>display size</a> is greater than 1, then the user agent
+ should also allow the user to request that the <code><a href=#the-option-element>option</a></code> whose <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> is true, if any, be unselected. Upon this
+ request being conveyed to the user agent, and before the relevant user interaction event <!--
+ interaction event spec point --> is queued (e.g. before the <code title=event-click><a href=#event-click>click</a></code>
+ event), the user agent must set the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a>
+ of that <code><a href=#the-option-element>option</a></code> element to false and then <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a
+ simple event</a> that bubbles named <code title=event-change>change</code> at the
+ <code><a href=#the-select-element>select</a></code> element, using the <a href=#user-interaction-task-source>user interaction task source</a> as the task
+ source.</p>
- <p>If the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code>
- attribute is absent and the element's <a href=#concept-select-size title=concept-select-size>display size</a> is 1, then whenever
- there are no <code><a href=#the-option-element>option</a></code> elements in the <code><a href=#the-select-element>select</a></code>
- element's <a href=#concept-select-option-list title=concept-select-option-list>list of
- options</a> that have their <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to true,
- the user agent must set the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of the first
- <code><a href=#the-option-element>option</a></code> element in the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> in
- <a href=#tree-order>tree order</a> that is not <a href=#concept-option-disabled title=concept-option-disabled>disabled</a>, if any, to
+ <p>If the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute is absent and the element's
+ <a href=#concept-select-size title=concept-select-size>display size</a> is 1, then whenever there are no
+ <code><a href=#the-option-element>option</a></code> elements in the <code><a href=#the-select-element>select</a></code> element's <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> that have their <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to true, the user agent must set the
+ <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of the first <code><a href=#the-option-element>option</a></code>
+ element in the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> in <a href=#tree-order>tree
+ order</a> that is not <a href=#concept-option-disabled title=concept-option-disabled>disabled</a>, if any, to
true.</p>
- <p>If the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code>
- attribute is present, and the element is not <a href=#concept-fe-disabled title=concept-fe-disabled>disabled</a>, then the user agent
- should allow the user to <dfn id=concept-select-toggle title=concept-select-toggle>toggle</dfn> the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of the
- <code><a href=#the-option-element>option</a></code> elements in its <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> that are
- themselves not <a href=#concept-option-disabled title=concept-option-disabled>disabled</a>
- (either through a click, or through a <a href=#using-the-option-element-to-define-a-command title=option-command>menu command</a>, or any other mechanism).
- Upon the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of one or
- more <code><a href=#the-option-element>option</a></code> elements being changed by the user, and
- before the relevant user interaction event <!-- interaction event
- spec point --> is queued (e.g. before a related <code title=event-click><a href=#event-click>click</a></code> event), the user agent must
- <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple event</a> that
- bubbles named <code title=event-change>change</code> at the
- <code><a href=#the-select-element>select</a></code> element, using the <a href=#user-interaction-task-source>user interaction task
- source</a> as the task source.</p>
+ <p>If the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute is present, and the element
+ is not <a href=#concept-fe-disabled title=concept-fe-disabled>disabled</a>, then the user agent should allow the
+ user to <dfn id=concept-select-toggle title=concept-select-toggle>toggle</dfn> the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of the <code><a href=#the-option-element>option</a></code> elements in its
+ <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> that are themselves not <a href=#concept-option-disabled title=concept-option-disabled>disabled</a> (either through a click, or through a <a href=#using-the-option-element-to-define-a-command title=option-command>menu command</a>, or any other mechanism). Upon the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of one or more <code><a href=#the-option-element>option</a></code>
+ elements being changed by the user, and before the relevant user interaction event <!--
+ interaction event spec point --> is queued (e.g. before a related <code title=event-click><a href=#event-click>click</a></code> event), the user agent must <a href=#queue-a-task>queue a task</a> to
+ <a href=#fire-a-simple-event>fire a simple event</a> that bubbles named <code title=event-change>change</code> at
+ the <code><a href=#the-select-element>select</a></code> element, using the <a href=#user-interaction-task-source>user interaction task source</a> as the task
+ source.</p>
- <p>The <a href=#concept-form-reset-control title=concept-form-reset-control>reset
- algorithm</a> for <code><a href=#the-select-element>select</a></code> elements is to go through
- all the <code><a href=#the-option-element>option</a></code> elements in the element's <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>, and set
- their <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a>
- to true if the <code><a href=#the-option-element>option</a></code> element has a <code title=attr-option-selected><a href=#attr-option-selected>selected</a></code> attribute, and false
- otherwise.</p>
+ <p>The <a href=#concept-form-reset-control title=concept-form-reset-control>reset algorithm</a> for <code><a href=#the-select-element>select</a></code>
+ elements is to go through all the <code><a href=#the-option-element>option</a></code> elements in the element's <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>, and set their <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> to true if the <code><a href=#the-option-element>option</a></code> element
+ has a <code title=attr-option-selected><a href=#attr-option-selected>selected</a></code> attribute, and false otherwise.</p>
</div>
- <p>The <code title=attr-fae-form><a href=#attr-fae-form>form</a></code> attribute is used to
- explicitly associate the <code><a href=#the-select-element>select</a></code> element with its
- <a href=#form-owner>form owner</a>. The <code title=attr-fe-name><a href=#attr-fe-name>name</a></code>
- attribute represents the element's name. The <code title=attr-fe-disabled><a href=#attr-fe-disabled>disabled</a></code> attribute is used to make
- the control non-interactive and to prevent its value from being
- submitted. The <code title=attr-fe-autofocus><a href=#attr-fe-autofocus>autofocus</a></code>
+ <p>The <code title=attr-fae-form><a href=#attr-fae-form>form</a></code> attribute is used to explicitly associate the
+ <code><a href=#the-select-element>select</a></code> element with its <a href=#form-owner>form owner</a>. The <code title=attr-fe-name><a href=#attr-fe-name>name</a></code> attribute represents the element's name. The <code title=attr-fe-disabled><a href=#attr-fe-disabled>disabled</a></code> attribute is used to make the control non-interactive and
+ to prevent its value from being submitted. The <code title=attr-fe-autofocus><a href=#attr-fe-autofocus>autofocus</a></code>
attribute controls focus.</p>
- <p>A <code><a href=#the-select-element>select</a></code> element that is not <a href=#concept-fe-disabled title=concept-fe-disabled>disabled</a> is <i title=concept-fe-mutable><a href=#concept-fe-mutable>mutable</a></i>.</p>
+ <p>A <code><a href=#the-select-element>select</a></code> element that is not <a href=#concept-fe-disabled title=concept-fe-disabled>disabled</a> is
+ <i title=concept-fe-mutable><a href=#concept-fe-mutable>mutable</a></i>.</p>
<!--TOPIC:DOM APIs-->
<dl class=domintro><dt><var title="">select</var> . <code title=dom-select-type><a href=#dom-select-type>type</a></code></dt>
<dd>
- <p>Returns "<code title="">select-multiple</code>" if the element
- has a <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code>
- attribute, and "<code title="">select-one</code>"
+ <p>Returns "<code title="">select-multiple</code>" if the element has a <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute, and "<code title="">select-one</code>"
otherwise.</p>
</dd>
@@ -51951,46 +51901,59 @@
<dt><var title="">select</var> . <code title=dom-select-length><a href=#dom-select-length>length</a></code> [ = <var title="">value</var> ]</dt>
<dd>
- <p>Returns the number of elements in the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>.</p>
- <p>When set to a smaller number, truncates the number of <code><a href=#the-option-element>option</a></code> elements in the <code><a href=#the-select-element>select</a></code>.</p>
- <p>When set to a greater number, adds new blank <code><a href=#the-option-element>option</a></code> elements to the <code><a href=#the-select-element>select</a></code>.</p>
+
+ <p>Returns the number of elements in the <a href=#concept-select-option-list title=concept-select-option-list>list of
+ options</a>.</p>
+
+ <p>When set to a smaller number, truncates the number of <code><a href=#the-option-element>option</a></code> elements in the
+ <code><a href=#the-select-element>select</a></code>.</p>
+
+ <p>When set to a greater number, adds new blank <code><a href=#the-option-element>option</a></code> elements to the
+ <code><a href=#the-select-element>select</a></code>.</p>
+
</dd>
<dt><var title="">element</var> = <var title="">select</var> . <code title=dom-select-item><a href=#dom-select-item>item</a></code>(<var title="">index</var>)</dt>
<dt><var title="">select</var>[<var title="">index</var>]</dt>
<dd>
- <p>Returns the item with index <var title="">index</var> from the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>. The items are sorted in <a href=#tree-order>tree order</a>.</p>
+
+ <p>Returns the item with index <var title="">index</var> from the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>. The items are sorted in <a href=#tree-order>tree
+ order</a>.</p>
+
</dd>
<dt><var title="">element</var> = <var title="">select</var> . <code title=dom-select-item><a href=#dom-select-item>namedItem</a></code>(<var title="">name</var>)</dt>
<dd>
+
<p>Returns the item with <a href=#concept-id title=concept-id>ID</a> or <code title=attr-option-name><a href=#attr-option-name>name</a></code> <var title="">name</var> from the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>.</p>
- <p>If there are multiple matching items, then a <code><a href=#nodelist>NodeList</a></code> object containing all those elements is returned.</p>
+
+ <p>If there are multiple matching items, then a <code><a href=#nodelist>NodeList</a></code> object containing all
+ those elements is returned.</p>
+
<p>Returns null if no element with that <a href=#concept-id title=concept-id>ID</a> could be found.</p>
+
</dd>
<dt><var title="">select</var> . <code title=dom-select-add><a href=#dom-select-add>add</a></code>(<var title="">element</var> [, <var title="">before</var> ])</dt>
<dd>
+
<p>Inserts <var title="">element</var> before the node given by <var title="">before</var>.</p>
- <p>The <var title="">before</var> argument can be a number, in
- which case <var title="">element</var> is inserted before the item
- with that number, or an element from the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>, in
- which case <var title="">element</var> is inserted before that
- element.</p>
- <p>If <var title="">before</var> is omitted, null, or a number out
- of range, then <var title="">element</var> will be added at the
- end of the list.</p>
- <p>This method will throw a <code><a href=#hierarchyrequesterror>HierarchyRequestError</a></code>
- exception if <var title="">element</var> is an ancestor of the
- element into which it is to be inserted.</p>
+
+ <p>The <var title="">before</var> argument can be a number, in which case <var title="">element</var> is inserted before the item with that number, or an element from the
+ <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>, in which case <var title="">element</var> is inserted before that element.</p>
+
+ <p>If <var title="">before</var> is omitted, null, or a number out of range, then <var title="">element</var> will be added at the end of the list.</p>
+
+ <p>This method will throw a <code><a href=#hierarchyrequesterror>HierarchyRequestError</a></code> exception if <var title="">element</var> is an ancestor of the element into which it is to be inserted.</p>
+
</dd>
<dt><var title="">select</var> . <code title=dom-select-selectedOptions><a href=#dom-select-selectedoptions>selectedOptions</a></code></dt>
<dd>
- <p>Returns an <code><a href=#htmlcollection>HTMLCollection</a></code> of the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> that are
- selected.</p>
+ <p>Returns an <code><a href=#htmlcollection>HTMLCollection</a></code> of the <a href=#concept-select-option-list title=concept-select-option-list>list
+ of options</a> that are selected.</p>
</dd>
@@ -51998,8 +51961,8 @@
<dd>
- <p>Returns the index of the first selected item, if any, or
- −1 if there is no selected item.</p>
+ <p>Returns the index of the first selected item, if any, or −1 if there is no selected
+ item.</p>
<p>Can be set, to change the selection.</p>
@@ -52009,9 +51972,8 @@
<dd>
- <p>Returns the <a href=#concept-fe-value title=concept-fe-value>value</a> of the
- first selected item, if any, or the empty string if there is no
- selected item.</p>
+ <p>Returns the <a href=#concept-fe-value title=concept-fe-value>value</a> of the first selected item, if any,
+ or the empty string if there is no selected item.</p>
<p>Can be set, to change the selection.</p>
@@ -52019,110 +51981,89 @@
</dl><div class=impl>
- <p>The <dfn id=dom-select-type title=dom-select-type><code>type</code></dfn> IDL
- attribute, on getting, must return the string "<code title="">select-one</code>" if the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute is absent,
- and the string "<code title="">select-multiple</code>" if the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute is
- present.</p>
+ <p>The <dfn id=dom-select-type title=dom-select-type><code>type</code></dfn> IDL attribute, on getting, must return
+ the string "<code title="">select-one</code>" if the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute is absent, and the string "<code title="">select-multiple</code>" if the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code>
+ attribute is present.</p>
- <p>The <dfn id=dom-select-options title=dom-select-options><code>options</code></dfn>
- IDL attribute must return an <code><a href=#htmloptionscollection>HTMLOptionsCollection</a></code>
- rooted at the <code><a href=#the-select-element>select</a></code> node, whose filter matches the
- elements in the <a href=#concept-select-option-list title=concept-select-option-list>list of
- options</a>.</p>
+ <p>The <dfn id=dom-select-options title=dom-select-options><code>options</code></dfn> IDL attribute must return an
+ <code><a href=#htmloptionscollection>HTMLOptionsCollection</a></code> rooted at the <code><a href=#the-select-element>select</a></code> node, whose filter matches
+ the elements in the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>.</p>
- <p>The <code title=dom-select-options><a href=#dom-select-options>options</a></code> collection is
- also mirrored on the <code><a href=#htmlselectelement>HTMLSelectElement</a></code> object. The
- <a href=#supported-property-indices>supported property indices</a> at any instant are the
- indices supported by the object returned by the <code title=dom-select-options><a href=#dom-select-options>options</a></code> attribute at that
- instant.</p>
+ <p>The <code title=dom-select-options><a href=#dom-select-options>options</a></code> collection is also mirrored on the
+ <code><a href=#htmlselectelement>HTMLSelectElement</a></code> object. The <a href=#supported-property-indices>supported property indices</a> at any instant
+ are the indices supported by the object returned by the <code title=dom-select-options><a href=#dom-select-options>options</a></code> attribute at that instant.</p>
- <p>The <dfn id=dom-select-length title=dom-select-length><code>length</code></dfn> IDL
- attribute must return the number of nodes <a href=#represented-by-the-collection title="represented
- by the collection">represented</a> by the <code title=dom-select-options><a href=#dom-select-options>options</a></code> collection. On setting, it
- must act like the attribute of the same name on the <code title=dom-select-options><a href=#dom-select-options>options</a></code> collection.</p>
+ <p>The <dfn id=dom-select-length title=dom-select-length><code>length</code></dfn> IDL attribute must return the
+ number of nodes <a href=#represented-by-the-collection title="represented by the collection">represented</a> by the <code title=dom-select-options><a href=#dom-select-options>options</a></code> collection. On setting, it must act like the attribute
+ of the same name on the <code title=dom-select-options><a href=#dom-select-options>options</a></code> collection.</p>
- <p>The <dfn id=dom-select-item title=dom-select-item><code>item(<var title="">index</var>)</code></dfn> method must return the value
- returned by the method of the same name on the <code title=dom-select-options><a href=#dom-select-options>options</a></code> collection, when invoked
- with the same argument.</p>
+ <p>The <dfn id=dom-select-item title=dom-select-item><code>item(<var title="">index</var>)</code></dfn> method must
+ return the value returned by the method of the same name on the <code title=dom-select-options><a href=#dom-select-options>options</a></code> collection, when invoked with the same argument.</p>
- <p>The <dfn id=dom-select-nameditem title=dom-select-namedItem><code>namedItem(<var title="">name</var>)</code></dfn> method must return the value
- returned by the method of the same name on the <code title=dom-select-options><a href=#dom-select-options>options</a></code> collection, when invoked
- with the same argument.</p>
+ <p>The <dfn id=dom-select-nameditem title=dom-select-namedItem><code>namedItem(<var title="">name</var>)</code></dfn>
+ method must return the value returned by the method of the same name on the <code title=dom-select-options><a href=#dom-select-options>options</a></code> collection, when invoked with the same argument.</p>
- <p>When the user agent is to <dfn id=dom-htmlselectelement-setter title=dom-HTMLSelectElement-setter>set the value of a new indexed
- property</dfn> for a given property index <var title="">index</var>
- to a new value <var title="">value</var>, it must instead <a href=#dom-htmloptionscollection-setter title=dom-HTMLOptionsCollection-setter>set the value of a new
- indexed property</a> with the given property index <var title="">index</var> to the new value <var title="">value</var> on the
- <code title=dom-select-options><a href=#dom-select-options>options</a></code> collection.</p>
+ <p>When the user agent is to <dfn id=dom-htmlselectelement-setter title=dom-HTMLSelectElement-setter>set the value of a new
+ indexed property</dfn> for a given property index <var title="">index</var> to a new value <var title="">value</var>, it must instead <a href=#dom-htmloptionscollection-setter title=dom-HTMLOptionsCollection-setter>set the value
+ of a new indexed property</a> with the given property index <var title="">index</var> to the
+ new value <var title="">value</var> on the <code title=dom-select-options><a href=#dom-select-options>options</a></code>
+ collection.</p>
- <p>Similarly, the <dfn id=dom-select-add title=dom-select-add><code>add()</code></dfn> and <dfn id=dom-select-remove title=dom-select-remove><code>remove()</code></dfn> methods must
- act like their namesake methods on that same <code title=dom-select-options><a href=#dom-select-options>options</a></code> collection.</p>
+ <p>Similarly, the <dfn id=dom-select-add title=dom-select-add><code>add()</code></dfn> and <dfn id=dom-select-remove title=dom-select-remove><code>remove()</code></dfn> methods must act like their namesake methods
+ on that same <code title=dom-select-options><a href=#dom-select-options>options</a></code> collection.</p>
- <p>The <dfn id=dom-select-selectedoptions title=dom-select-selectedOptions><code>selectedOptions</code></dfn>
- IDL attribute must return an <code><a href=#htmlcollection>HTMLCollection</a></code> rooted at
- the <code><a href=#the-select-element>select</a></code> node, whose filter matches the elements in
- the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>
- that have their <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to
- true.</p>
+ <p>The <dfn id=dom-select-selectedoptions title=dom-select-selectedOptions><code>selectedOptions</code></dfn> IDL attribute
+ must return an <code><a href=#htmlcollection>HTMLCollection</a></code> rooted at the <code><a href=#the-select-element>select</a></code> node, whose filter
+ matches the elements in the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> that
+ have their <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to true.</p>
- <p>The <dfn id=dom-select-selectedindex title=dom-select-selectedIndex><code>selectedIndex</code></dfn>
- IDL attribute, on getting, must return the <a href=#concept-option-index title=concept-option-index>index</a> of the first
- <code><a href=#the-option-element>option</a></code> element in the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> in
- <a href=#tree-order>tree order</a> that has its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to true,
- if any. If there isn't one, then it must return −1.</p>
+ <p>The <dfn id=dom-select-selectedindex title=dom-select-selectedIndex><code>selectedIndex</code></dfn> IDL attribute, on
+ getting, must return the <a href=#concept-option-index title=concept-option-index>index</a> of the first
+ <code><a href=#the-option-element>option</a></code> element in the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>
+ in <a href=#tree-order>tree order</a> that has its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to true, if any. If there isn't one,
+ then it must return −1.</p>
- <p>On setting, the <code title=dom-select-selectedIndex><a href=#dom-select-selectedindex>selectedIndex</a></code> attribute must
- set the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of all the
- <code><a href=#the-option-element>option</a></code> elements in the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> to false,
- and then the <code><a href=#the-option-element>option</a></code> element in the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> whose
- <a href=#concept-option-index title=concept-option-index>index</a> is the given new
- value, if any, must have its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to
- true.</p>
+ <p>On setting, the <code title=dom-select-selectedIndex><a href=#dom-select-selectedindex>selectedIndex</a></code> attribute must set
+ the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of all the <code><a href=#the-option-element>option</a></code>
+ elements in the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> to false, and then
+ the <code><a href=#the-option-element>option</a></code> element in the <a href=#concept-select-option-list title=concept-select-option-list>list of
+ options</a> whose <a href=#concept-option-index title=concept-option-index>index</a> is the given new value, if
+ any, must have its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to true.</p>
- <p>The <dfn id=dom-select-value title=dom-select-value><code>value</code></dfn> IDL
- attribute, on getting, must return the <a href=#concept-option-value title=concept-option-value>value</a> of the first
- <code><a href=#the-option-element>option</a></code> element in the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> in
- <a href=#tree-order>tree order</a> that has its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to true,
- if any. If there isn't one, then it must return the empty
- string.</p>
+ <p>The <dfn id=dom-select-value title=dom-select-value><code>value</code></dfn> IDL attribute, on getting, must
+ return the <a href=#concept-option-value title=concept-option-value>value</a> of the first <code><a href=#the-option-element>option</a></code>
+ element in the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> in <a href=#tree-order>tree
+ order</a> that has its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to
+ true, if any. If there isn't one, then it must return the empty string.</p>
- <p>On setting, the <code title=dom-select-value><a href=#dom-select-value>value</a></code>
- attribute must set the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of all the
- <code><a href=#the-option-element>option</a></code> elements in the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> to false,
- and then the first <code><a href=#the-option-element>option</a></code> element in the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a>, in
- <a href=#tree-order>tree order</a>, whose <a href=#concept-option-value title=concept-option-value>value</a> is equal to the given new
- value, if any, must have its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to
- true.</p>
+ <p>On setting, the <code title=dom-select-value><a href=#dom-select-value>value</a></code> attribute must set the <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> of all the <code><a href=#the-option-element>option</a></code> elements in
+ the <a href=#concept-select-option-list title=concept-select-option-list>list of options</a> to false, and then the first
+ <code><a href=#the-option-element>option</a></code> element in the <a href=#concept-select-option-list title=concept-select-option-list>list of
+ options</a>, in <a href=#tree-order>tree order</a>, whose <a href=#concept-option-value title=concept-option-value>value</a>
+ is equal to the given new value, if any, must have its <a href=#concept-option-selectedness title=concept-option-selectedness>selectedness</a> set to true.</p>
- <p>The <dfn id=dom-select-multiple title=dom-select-multiple><code>multiple</code></dfn>,
- <dfn id=dom-select-required title=dom-select-required><code>required</code></dfn>, and
- <dfn id=dom-select-size title=dom-select-size><code>size</code></dfn> IDL attributes
- must <a href=#reflect>reflect</a> the respective content attributes of the
- same name. The <code title=dom-select-size><a href=#dom-select-size>size</a></code> IDL
- attribute has a default value of zero.</p> <!-- see bug 12288 for
- compat reasons why .size allows zero (it's not limited to values
- greater than zero) even though that value really makes no sense -->
+ <p>The <dfn id=dom-select-multiple title=dom-select-multiple><code>multiple</code></dfn>, <dfn id=dom-select-required title=dom-select-required><code>required</code></dfn>, and <dfn id=dom-select-size title=dom-select-size><code>size</code></dfn> IDL attributes must <a href=#reflect>reflect</a> the
+ respective content attributes of the same name. The <code title=dom-select-size><a href=#dom-select-size>size</a></code> IDL
+ attribute has a default value of zero.</p> <!-- see bug 12288 for compat reasons why .size allows
+ zero (it's not limited to values greater than zero) even though that value really makes no sense
+ -->
- <p class=note>For historical reasons, the default value of the
- <code title=dom-select-size><a href=#dom-select-size>size</a></code> IDL attribute does not
- return the actual size used, which, in the absence of the <code title=attr-select-size><a href=#attr-select-size>size</a></code> content attribute, is either 1
- or 4 depending on the presence of the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute.</p>
+ <p class=note>For historical reasons, the default value of the <code title=dom-select-size><a href=#dom-select-size>size</a></code> IDL attribute does not return the actual size used, which, in
+ the absence of the <code title=attr-select-size><a href=#attr-select-size>size</a></code> content attribute, is either 1 or 4
+ depending on the presence of the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute.</p>
- <p>The <code title=dom-cva-willValidate><a href=#dom-cva-willvalidate>willValidate</a></code>, <code title=dom-cva-validity><a href=#dom-cva-validity>validity</a></code>, and <code title=dom-cva-validationMessage><a href=#dom-cva-validationmessage>validationMessage</a></code> IDL
- attributes, and the <code title=dom-cva-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code> and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code>
- methods, are part of the <a href=#the-constraint-validation-api>constraint validation API</a>. The
- <code title=dom-lfe-labels><a href=#dom-lfe-labels>labels</a></code> IDL attribute provides a
- list of the element's <code><a href=#the-label-element>label</a></code>s. The <code title=dom-fe-autofocus><a href=#dom-fe-autofocus>autofocus</a></code>, <code title=dom-fe-disabled><a href=#dom-fe-disabled>disabled</a></code>, <code title=dom-fae-form><a href=#dom-fae-form>form</a></code>, and <code title=dom-fe-name><a href=#dom-fe-name>name</a></code> IDL attributes are part of the
- element's forms API.</p>
+ <p>The <code title=dom-cva-willValidate><a href=#dom-cva-willvalidate>willValidate</a></code>, <code title=dom-cva-validity><a href=#dom-cva-validity>validity</a></code>, and <code title=dom-cva-validationMessage><a href=#dom-cva-validationmessage>validationMessage</a></code> IDL attributes, and the <code title=dom-cva-checkValidity><a href=#dom-cva-checkvalidity>checkValidity()</a></code> and <code title=dom-cva-setCustomValidity><a href=#dom-cva-setcustomvalidity>setCustomValidity()</a></code> methods, are part of the
+ <a href=#the-constraint-validation-api>constraint validation API</a>. The <code title=dom-lfe-labels><a href=#dom-lfe-labels>labels</a></code> IDL
+ attribute provides a list of the element's <code><a href=#the-label-element>label</a></code>s. The <code title=dom-fe-autofocus><a href=#dom-fe-autofocus>autofocus</a></code>, <code title=dom-fe-disabled><a href=#dom-fe-disabled>disabled</a></code>, <code title=dom-fae-form><a href=#dom-fae-form>form</a></code>, and <code title=dom-fe-name><a href=#dom-fe-name>name</a></code> IDL attributes are
+ part of the element's forms API.</p>
</div>
<!--TOPIC:HTML-->
<div class=example>
- <p>The following example shows how a <code><a href=#the-select-element>select</a></code> element
- can be used to offer the user with a set of options from which the
- user can select a single option. The default option is
+ <p>The following example shows how a <code><a href=#the-select-element>select</a></code> element can be used to offer the user
+ with a set of options from which the user can select a single option. The default option is
preselected.</p>
<pre><p>
@@ -52136,8 +52077,7 @@
</select>
</p></pre>
- <p>When there is no default option, a placeholder can be used
- instead:</p>
+ <p>When there is no default option, a placeholder can be used instead:</p>
<pre><select name="unittype" <strong>required</strong>>
<strong><option value=""> Select unit type </option></strong>
@@ -52152,8 +52092,8 @@
<div class=example>
- <p>Here, the user is offered a set of options from which he can
- select any number. By default, all five options are selected.</p>
+ <p>Here, the user is offered a set of options from which he can select any number. By default,
+ all five options are selected.</p>
<pre><p>
<label for="allowedunits">Select unit types to enable on this map:</label>
@@ -52170,8 +52110,7 @@
<div class=example>
- <p>Sometimes, a user has to select one or more items. This example
- shows such an interface.</p>
+ <p>Sometimes, a user has to select one or more items. This example shows such an interface.</p>
<pre><p>Select the songs from that you would like on your Act II Mix Tape:</p>
<select multiple required name="act2">
Modified: source
===================================================================
--- source 2012-12-01 22:30:58 UTC (rev 7557)
+++ source 2012-12-01 22:39:52 UTC (rev 7558)
@@ -60404,206 +60404,149 @@
src="/js/flightcity.js"></SCRIPT></select> which is the kind of thing that could be much simpler with <select value="PEK">
-->
- <p>The <code>select</code> element represents a control for
- selecting amongst a set of options.</p>
+ <p>The <code>select</code> element represents a control for selecting amongst a set of
+ options.</p>
- <p>The <dfn title="attr-select-multiple"><code>multiple</code></dfn>
- attribute is a <span>boolean attribute</span>. If the attribute is
- present, then the <code>select</code> element
- <span>represents</span> a control for selecting zero or more options
- from the <span title="concept-select-option-list">list of
- options</span>. If the attribute is absent, then the
- <code>select</code> element <span>represents</span> a control for
- selecting a single option from the <span
- title="concept-select-option-list">list of options</span>.</p>
+ <p>The <dfn title="attr-select-multiple"><code>multiple</code></dfn> attribute is a <span>boolean
+ attribute</span>. If the attribute is present, then the <code>select</code> element
+ <span>represents</span> a control for selecting zero or more options from the <span
+ title="concept-select-option-list">list of options</span>. If the attribute is absent, then the
+ <code>select</code> element <span>represents</span> a control for selecting a single option from
+ the <span title="concept-select-option-list">list of options</span>.</p>
- <p>The <dfn title="attr-select-size"><code>size</code></dfn>
- attribute gives the number of options to show to the user. The <code
- title="attr-select-size">size</code> attribute, if specified, must
- have a value that is a <span>valid non-negative integer</span>
- greater than zero.</p>
+ <p>The <dfn title="attr-select-size"><code>size</code></dfn> attribute gives the number of options
+ to show to the user. The <code title="attr-select-size">size</code> attribute, if specified, must
+ have a value that is a <span>valid non-negative integer</span> greater than zero.</p>
<div class="impl">
- <p>The <dfn title="concept-select-size">display size</dfn> of a
- <code>select</code> element is the result of applying the
- <span>rules for parsing non-negative integers</span> to the value of
- element's <code title="attr-select-size">size</code> attribute, if
- it has one and parsing it is successful. If applying those rules to
- the attribute's value is not successful, or if the <code
- title="attr-select-size">size</code> attribute is absent, then the
- element's <span title="concept-select-size">display size</span> is 4
- if the element's <code title="attr-select-multiple">multiple</code>
- content attribute is present, and 1 otherwise.</p>
+ <p>The <dfn title="concept-select-size">display size</dfn> of a <code>select</code> element is the
+ result of applying the <span>rules for parsing non-negative integers</span> to the value of
+ element's <code title="attr-select-size">size</code> attribute, if it has one and parsing it is
+ successful. If applying those rules to the attribute's value is not successful, or if the <code
+ title="attr-select-size">size</code> attribute is absent, then the element's <span
+ title="concept-select-size">display size</span> is 4 if the element's <code
+ title="attr-select-multiple">multiple</code> content attribute is present, and 1 otherwise.</p>
</div>
- <p>The <dfn title="concept-select-option-list">list of options</dfn>
- for a <code>select</code> element consists of all the
- <code>option</code> element children of the <code>select</code>
- element, and all the <code>option</code> element children of all the
- <code>optgroup</code> element children of the <code>select</code>
- element, in <span>tree order</span>.</p>
+ <p>The <dfn title="concept-select-option-list">list of options</dfn> for a <code>select</code>
+ element consists of all the <code>option</code> element children of the <code>select</code>
+ element, and all the <code>option</code> element children of all the <code>optgroup</code> element
+ children of the <code>select</code> element, in <span>tree order</span>.</p>
- <p>The <dfn title="attr-select-required"><code>required</code></dfn>
- attribute is a <span>boolean attribute</span>. When specified, the
- user will be required to select a value before submitting the
- form.</p>
+ <p>The <dfn title="attr-select-required"><code>required</code></dfn> attribute is a <span>boolean
+ attribute</span>. When specified, the user will be required to select a value before submitting
+ the form.</p>
- <p>If a <code>select</code> element has a <code
- title="attr-select-required">required</code> attribute specified,
- does not have a <code title="attr-select-multiple">multiple</code>
- attribute specified, and has a <span
- title="concept-select-size">display size</span> of 1;
- and if the <span title="concept-option-value">value</span> of the
- first <code>option</code> element in the <code>select</code>
- element's <span title="concept-select-option-list">list of
- options</span> (if any) is the empty string, and that
- <code>option</code> element's parent node is the <code>select</code>
- element (and not an <code>optgroup</code> element), then that
- <code>option</code> is the <code>select</code> element's
- <dfn>placeholder label option</dfn>.</p>
+ <p>If a <code>select</code> element has a <code title="attr-select-required">required</code>
+ attribute specified, does not have a <code title="attr-select-multiple">multiple</code> attribute
+ specified, and has a <span title="concept-select-size">display size</span> of 1; and if the <span
+ title="concept-option-value">value</span> of the first <code>option</code> element in the
+ <code>select</code> element's <span title="concept-select-option-list">list of options</span> (if
+ any) is the empty string, and that <code>option</code> element's parent node is the
+ <code>select</code> element (and not an <code>optgroup</code> element), then that
+ <code>option</code> is the <code>select</code> element's <dfn>placeholder label option</dfn>.</p>
- <p>If a <code>select</code> element has a <code
- title="attr-select-required">required</code> attribute specified,
- does not have a <code title="attr-select-multiple">multiple</code>
- attribute specified, and has a <span
- title="concept-select-size">display size</span> of 1,
- then the <code>select</code> element must have a <span>placeholder
- label option</span>.</p>
+ <p>If a <code>select</code> element has a <code title="attr-select-required">required</code>
+ attribute specified, does not have a <code title="attr-select-multiple">multiple</code> attribute
+ specified, and has a <span title="concept-select-size">display size</span> of 1, then the
+ <code>select</code> element must have a <span>placeholder label option</span>.</p>
<div class="impl">
- <p><strong>Constraint validation</strong>: If the element has its
- <code title="attr-select-required">required</code> attribute
- specified, and either none of the <code>option</code> elements in
- the <code>select</code> element's <span
- title="concept-select-option-list">list of options</span> have their
- <span title="concept-option-selectedness">selectedness</span> set to
- true, or the only <code>option</code> element in the
- <code>select</code> element's <span
- title="concept-select-option-list">list of options</span> with its
- <span title="concept-option-selectedness">selectedness</span> set to
- true is the <span>placeholder label option</span>, then the element
- is <span>suffering from being missing</span>.</p>
+ <p><strong>Constraint validation</strong>: If the element has its <code
+ title="attr-select-required">required</code> attribute specified, and either none of the
+ <code>option</code> elements in the <code>select</code> element's <span
+ title="concept-select-option-list">list of options</span> have their <span
+ title="concept-option-selectedness">selectedness</span> set to true, or the only
+ <code>option</code> element in the <code>select</code> element's <span
+ title="concept-select-option-list">list of options</span> with its <span
+ title="concept-option-selectedness">selectedness</span> set to true is the <span>placeholder label
+ option</span>, then the element is <span>suffering from being missing</span>.</p>
</div>
<div class="impl">
- <p>If the <code title="attr-select-multiple">multiple</code>
- attribute is absent, and the element is not <span
- title="concept-fe-disabled">disabled</span>, then the user agent
- should allow the user to pick an <code>option</code> element in its
- <span title="concept-select-option-list">list of options</span> that
- is itself not <span title="concept-option-disabled">disabled</span>.
- Upon this <code>option</code> element being <dfn
- title="concept-select-pick">picked</dfn> (either through a click, or
- through unfocusing the element after changing its value, or through
- a <span title="option-command">menu command</span>, or through any
- other mechanism), and before the relevant user interaction event
- <!-- interaction event spec point --> is queued (e.g. before the
- <code title="event-click">click</code> event), the user agent must
- set the <span
- title="concept-option-selectedness">selectedness</span> of the
- picked <code>option</code> element to true and then <span>queue a
- task</span> to <span>fire a simple event</span> that bubbles named
- <code title="event-change">change</code> at the <code>select</code>
- element, using the <span>user interaction task source</span> as the
- task source.</p>
+ <p>If the <code title="attr-select-multiple">multiple</code> attribute is absent, and the element
+ is not <span title="concept-fe-disabled">disabled</span>, then the user agent should allow the
+ user to pick an <code>option</code> element in its <span title="concept-select-option-list">list
+ of options</span> that is itself not <span title="concept-option-disabled">disabled</span>. Upon
+ this <code>option</code> element being <dfn title="concept-select-pick">picked</dfn> (either
+ through a click, or through unfocusing the element after changing its value, or through a <span
+ title="option-command">menu command</span>, or through any other mechanism), and before the
+ relevant user interaction event <!-- interaction event spec point --> is queued (e.g. before the
+ <code title="event-click">click</code> event), the user agent must set the <span
+ title="concept-option-selectedness">selectedness</span> of the picked <code>option</code> element
+ to true and then <span>queue a task</span> to <span>fire a simple event</span> that bubbles named
+ <code title="event-change">change</code> at the <code>select</code> element, using the <span>user
+ interaction task source</span> as the task source.</p>
- <p>If the <code title="attr-select-multiple">multiple</code>
- attribute is absent, whenever an <code>option</code> element in the
- <code>select</code> element's <span
- title="concept-select-option-list">list of options</span> has its
- <span title="concept-option-selectedness">selectedness</span> set to
- true, and whenever an <code>option</code> element with its <span
- title="concept-option-selectedness">selectedness</span> set to true
- is added to the <code>select</code> element's <span
- title="concept-select-option-list">list of options</span>, the user
- agent must set the <span
- title="concept-option-selectedness">selectedness</span> of all the
- other <code>option</code> element in its <span
- title="concept-select-option-list">list of options</span> to
- false.</p>
+ <p>If the <code title="attr-select-multiple">multiple</code> attribute is absent, whenever an
+ <code>option</code> element in the <code>select</code> element's <span
+ title="concept-select-option-list">list of options</span> has its <span
+ title="concept-option-selectedness">selectedness</span> set to true, and whenever an
+ <code>option</code> element with its <span title="concept-option-selectedness">selectedness</span>
+ set to true is added to the <code>select</code> element's <span
+ title="concept-select-option-list">list of options</span>, the user agent must set the <span
+ title="concept-option-selectedness">selectedness</span> of all the other <code>option</code>
+ element in its <span title="concept-select-option-list">list of options</span> to false.</p>
- <p>If the <code title="attr-select-multiple">multiple</code>
- attribute is absent and the element's <span
- title="concept-select-size">display size</span> is greater than 1,
- then the user agent should also allow the user to request that the
- <code>option</code> whose <span
- title="concept-option-selectedness">selectedness</span> is true, if
- any, be unselected. Upon this request being conveyed to the user
- agent, and before the relevant user interaction event <!--
- interaction event spec point --> is queued (e.g. before the <code
- title="event-click">click</code> event), the user agent must set the
- <span title="concept-option-selectedness">selectedness</span> of
- that <code>option</code> element to false and then <span>queue a
- task</span> to <span>fire a simple event</span> that bubbles named
- <code title="event-change">change</code> at the <code>select</code>
- element, using the <span>user interaction task source</span> as the
- task source.</p>
+ <p>If the <code title="attr-select-multiple">multiple</code> attribute is absent and the element's
+ <span title="concept-select-size">display size</span> is greater than 1, then the user agent
+ should also allow the user to request that the <code>option</code> whose <span
+ title="concept-option-selectedness">selectedness</span> is true, if any, be unselected. Upon this
+ request being conveyed to the user agent, and before the relevant user interaction event <!--
+ interaction event spec point --> is queued (e.g. before the <code title="event-click">click</code>
+ event), the user agent must set the <span title="concept-option-selectedness">selectedness</span>
+ of that <code>option</code> element to false and then <span>queue a task</span> to <span>fire a
+ simple event</span> that bubbles named <code title="event-change">change</code> at the
+ <code>select</code> element, using the <span>user interaction task source</span> as the task
+ source.</p>
- <p>If the <code title="attr-select-multiple">multiple</code>
- attribute is absent and the element's <span
- title="concept-select-size">display size</span> is 1, then whenever
- there are no <code>option</code> elements in the <code>select</code>
- element's <span title="concept-select-option-list">list of
- options</span> that have their <span
- title="concept-option-selectedness">selectedness</span> set to true,
- the user agent must set the <span
- title="concept-option-selectedness">selectedness</span> of the first
- <code>option</code> element in the <span
- title="concept-select-option-list">list of options</span> in
- <span>tree order</span> that is not <span
- title="concept-option-disabled">disabled</span>, if any, to
+ <p>If the <code title="attr-select-multiple">multiple</code> attribute is absent and the element's
+ <span title="concept-select-size">display size</span> is 1, then whenever there are no
+ <code>option</code> elements in the <code>select</code> element's <span
+ title="concept-select-option-list">list of options</span> that have their <span
+ title="concept-option-selectedness">selectedness</span> set to true, the user agent must set the
+ <span title="concept-option-selectedness">selectedness</span> of the first <code>option</code>
+ element in the <span title="concept-select-option-list">list of options</span> in <span>tree
+ order</span> that is not <span title="concept-option-disabled">disabled</span>, if any, to
true.</p>
- <p>If the <code title="attr-select-multiple">multiple</code>
- attribute is present, and the element is not <span
- title="concept-fe-disabled">disabled</span>, then the user agent
- should allow the user to <dfn
- title="concept-select-toggle">toggle</dfn> the <span
- title="concept-option-selectedness">selectedness</span> of the
- <code>option</code> elements in its <span
- title="concept-select-option-list">list of options</span> that are
- themselves not <span title="concept-option-disabled">disabled</span>
- (either through a click, or through a <span
- title="option-command">menu command</span>, or any other mechanism).
- Upon the <span
- title="concept-option-selectedness">selectedness</span> of one or
- more <code>option</code> elements being changed by the user, and
- before the relevant user interaction event <!-- interaction event
- spec point --> is queued (e.g. before a related <code
- title="event-click">click</code> event), the user agent must
- <span>queue a task</span> to <span>fire a simple event</span> that
- bubbles named <code title="event-change">change</code> at the
- <code>select</code> element, using the <span>user interaction task
- source</span> as the task source.</p>
+ <p>If the <code title="attr-select-multiple">multiple</code> attribute is present, and the element
+ is not <span title="concept-fe-disabled">disabled</span>, then the user agent should allow the
+ user to <dfn title="concept-select-toggle">toggle</dfn> the <span
+ title="concept-option-selectedness">selectedness</span> of the <code>option</code> elements in its
+ <span title="concept-select-option-list">list of options</span> that are themselves not <span
+ title="concept-option-disabled">disabled</span> (either through a click, or through a <span
+ title="option-command">menu command</span>, or any other mechanism). Upon the <span
+ title="concept-option-selectedness">selectedness</span> of one or more <code>option</code>
+ elements being changed by the user, and before the relevant user interaction event <!--
+ interaction event spec point --> is queued (e.g. before a related <code
+ title="event-click">click</code> event), the user agent must <span>queue a task</span> to
+ <span>fire a simple event</span> that bubbles named <code title="event-change">change</code> at
+ the <code>select</code> element, using the <span>user interaction task source</span> as the task
+ source.</p>
- <p>The <span title="concept-form-reset-control">reset
- algorithm</span> for <code>select</code> elements is to go through
- all the <code>option</code> elements in the element's <span
- title="concept-select-option-list">list of options</span>, and set
- their <span title="concept-option-selectedness">selectedness</span>
- to true if the <code>option</code> element has a <code
- title="attr-option-selected">selected</code> attribute, and false
- otherwise.</p>
+ <p>The <span title="concept-form-reset-control">reset algorithm</span> for <code>select</code>
+ elements is to go through all the <code>option</code> elements in the element's <span
+ title="concept-select-option-list">list of options</span>, and set their <span
+ title="concept-option-selectedness">selectedness</span> to true if the <code>option</code> element
+ has a <code title="attr-option-selected">selected</code> attribute, and false otherwise.</p>
</div>
- <p>The <code title="attr-fae-form">form</code> attribute is used to
- explicitly associate the <code>select</code> element with its
- <span>form owner</span>. The <code title="attr-fe-name">name</code>
- attribute represents the element's name. The <code
- title="attr-fe-disabled">disabled</code> attribute is used to make
- the control non-interactive and to prevent its value from being
- submitted. The <code title="attr-fe-autofocus">autofocus</code>
+ <p>The <code title="attr-fae-form">form</code> attribute is used to explicitly associate the
+ <code>select</code> element with its <span>form owner</span>. The <code
+ title="attr-fe-name">name</code> attribute represents the element's name. The <code
+ title="attr-fe-disabled">disabled</code> attribute is used to make the control non-interactive and
+ to prevent its value from being submitted. The <code title="attr-fe-autofocus">autofocus</code>
attribute controls focus.</p>
- <p>A <code>select</code> element that is not <span
- title="concept-fe-disabled">disabled</span> is <i
- title="concept-fe-mutable">mutable</i>.</p>
+ <p>A <code>select</code> element that is not <span title="concept-fe-disabled">disabled</span> is
+ <i title="concept-fe-mutable">mutable</i>.</p>
<!--TOPIC:DOM APIs-->
<dl class="domintro">
@@ -60612,9 +60555,8 @@
<dd>
- <p>Returns "<code title="">select-multiple</code>" if the element
- has a <code title="attr-select-multiple">multiple</code>
- attribute, and "<code title="">select-one</code>"
+ <p>Returns "<code title="">select-multiple</code>" if the element has a <code
+ title="attr-select-multiple">multiple</code> attribute, and "<code title="">select-one</code>"
otherwise.</p>
</dd>
@@ -60630,48 +60572,66 @@
<dt><var title="">select</var> . <code title="dom-select-length">length</code> [ = <var title="">value</var> ]</dt>
<dd>
- <p>Returns the number of elements in the <span title="concept-select-option-list">list of options</span>.</p>
- <p>When set to a smaller number, truncates the number of <code>option</code> elements in the <code>select</code>.</p>
- <p>When set to a greater number, adds new blank <code>option</code> elements to the <code>select</code>.</p>
+
+ <p>Returns the number of elements in the <span title="concept-select-option-list">list of
+ options</span>.</p>
+
+ <p>When set to a smaller number, truncates the number of <code>option</code> elements in the
+ <code>select</code>.</p>
+
+ <p>When set to a greater number, adds new blank <code>option</code> elements to the
+ <code>select</code>.</p>
+
</dd>
<dt><var title="">element</var> = <var title="">select</var> . <code title="dom-select-item">item</code>(<var title="">index</var>)</dt>
<dt><var title="">select</var>[<var title="">index</var>]</dt>
<dd>
- <p>Returns the item with index <var title="">index</var> from the <span title="concept-select-option-list">list of options</span>. The items are sorted in <span>tree order</span>.</p>
+
+ <p>Returns the item with index <var title="">index</var> from the <span
+ title="concept-select-option-list">list of options</span>. The items are sorted in <span>tree
+ order</span>.</p>
+
</dd>
<dt><var title="">element</var> = <var title="">select</var> . <code title="dom-select-item">namedItem</code>(<var title="">name</var>)</dt>
<dd>
- <p>Returns the item with <span title="concept-id">ID</span> or <code title="attr-option-name">name</code> <var title="">name</var> from the <span title="concept-select-option-list">list of options</span>.</p>
- <p>If there are multiple matching items, then a <code>NodeList</code> object containing all those elements is returned.</p>
+
+ <p>Returns the item with <span title="concept-id">ID</span> or <code
+ title="attr-option-name">name</code> <var title="">name</var> from the <span
+ title="concept-select-option-list">list of options</span>.</p>
+
+ <p>If there are multiple matching items, then a <code>NodeList</code> object containing all
+ those elements is returned.</p>
+
<p>Returns null if no element with that <span title="concept-id">ID</span> could be found.</p>
+
</dd>
<dt><var title="">select</var> . <code title="dom-select-add">add</code>(<var title="">element</var> [, <var title="">before</var> ])</dt>
<dd>
+
<p>Inserts <var title="">element</var> before the node given by <var title="">before</var>.</p>
- <p>The <var title="">before</var> argument can be a number, in
- which case <var title="">element</var> is inserted before the item
- with that number, or an element from the <span
- title="concept-select-option-list">list of options</span>, in
- which case <var title="">element</var> is inserted before that
- element.</p>
- <p>If <var title="">before</var> is omitted, null, or a number out
- of range, then <var title="">element</var> will be added at the
- end of the list.</p>
- <p>This method will throw a <code>HierarchyRequestError</code>
- exception if <var title="">element</var> is an ancestor of the
- element into which it is to be inserted.</p>
+
+ <p>The <var title="">before</var> argument can be a number, in which case <var
+ title="">element</var> is inserted before the item with that number, or an element from the
+ <span title="concept-select-option-list">list of options</span>, in which case <var
+ title="">element</var> is inserted before that element.</p>
+
+ <p>If <var title="">before</var> is omitted, null, or a number out of range, then <var
+ title="">element</var> will be added at the end of the list.</p>
+
+ <p>This method will throw a <code>HierarchyRequestError</code> exception if <var
+ title="">element</var> is an ancestor of the element into which it is to be inserted.</p>
+
</dd>
<dt><var title="">select</var> . <code title="dom-select-selectedOptions">selectedOptions</code></dt>
<dd>
- <p>Returns an <code>HTMLCollection</code> of the <span
- title="concept-select-option-list">list of options</span> that are
- selected.</p>
+ <p>Returns an <code>HTMLCollection</code> of the <span title="concept-select-option-list">list
+ of options</span> that are selected.</p>
</dd>
@@ -60679,8 +60639,8 @@
<dd>
- <p>Returns the index of the first selected item, if any, or
- −1 if there is no selected item.</p>
+ <p>Returns the index of the first selected item, if any, or −1 if there is no selected
+ item.</p>
<p>Can be set, to change the selection.</p>
@@ -60690,9 +60650,8 @@
<dd>
- <p>Returns the <span title="concept-fe-value">value</span> of the
- first selected item, if any, or the empty string if there is no
- selected item.</p>
+ <p>Returns the <span title="concept-fe-value">value</span> of the first selected item, if any,
+ or the empty string if there is no selected item.</p>
<p>Can be set, to change the selection.</p>
@@ -60702,155 +60661,109 @@
<div class="impl">
- <p>The <dfn title="dom-select-type"><code>type</code></dfn> IDL
- attribute, on getting, must return the string "<code
- title="">select-one</code>" if the <code
- title="attr-select-multiple">multiple</code> attribute is absent,
- and the string "<code title="">select-multiple</code>" if the <code
- title="attr-select-multiple">multiple</code> attribute is
- present.</p>
+ <p>The <dfn title="dom-select-type"><code>type</code></dfn> IDL attribute, on getting, must return
+ the string "<code title="">select-one</code>" if the <code
+ title="attr-select-multiple">multiple</code> attribute is absent, and the string "<code
+ title="">select-multiple</code>" if the <code title="attr-select-multiple">multiple</code>
+ attribute is present.</p>
- <p>The <dfn title="dom-select-options"><code>options</code></dfn>
- IDL attribute must return an <code>HTMLOptionsCollection</code>
- rooted at the <code>select</code> node, whose filter matches the
- elements in the <span title="concept-select-option-list">list of
- options</span>.</p>
+ <p>The <dfn title="dom-select-options"><code>options</code></dfn> IDL attribute must return an
+ <code>HTMLOptionsCollection</code> rooted at the <code>select</code> node, whose filter matches
+ the elements in the <span title="concept-select-option-list">list of options</span>.</p>
- <p>The <code title="dom-select-options">options</code> collection is
- also mirrored on the <code>HTMLSelectElement</code> object. The
- <span>supported property indices</span> at any instant are the
- indices supported by the object returned by the <code
- title="dom-select-options">options</code> attribute at that
- instant.</p>
+ <p>The <code title="dom-select-options">options</code> collection is also mirrored on the
+ <code>HTMLSelectElement</code> object. The <span>supported property indices</span> at any instant
+ are the indices supported by the object returned by the <code
+ title="dom-select-options">options</code> attribute at that instant.</p>
- <p>The <dfn title="dom-select-length"><code>length</code></dfn> IDL
- attribute must return the number of nodes <span title="represented
- by the collection">represented</span> by the <code
- title="dom-select-options">options</code> collection. On setting, it
- must act like the attribute of the same name on the <code
- title="dom-select-options">options</code> collection.</p>
+ <p>The <dfn title="dom-select-length"><code>length</code></dfn> IDL attribute must return the
+ number of nodes <span title="represented by the collection">represented</span> by the <code
+ title="dom-select-options">options</code> collection. On setting, it must act like the attribute
+ of the same name on the <code title="dom-select-options">options</code> collection.</p>
- <p>The <dfn title="dom-select-item"><code>item(<var
- title="">index</var>)</code></dfn> method must return the value
- returned by the method of the same name on the <code
- title="dom-select-options">options</code> collection, when invoked
- with the same argument.</p>
+ <p>The <dfn title="dom-select-item"><code>item(<var title="">index</var>)</code></dfn> method must
+ return the value returned by the method of the same name on the <code
+ title="dom-select-options">options</code> collection, when invoked with the same argument.</p>
- <p>The <dfn title="dom-select-namedItem"><code>namedItem(<var
- title="">name</var>)</code></dfn> method must return the value
- returned by the method of the same name on the <code
- title="dom-select-options">options</code> collection, when invoked
- with the same argument.</p>
+ <p>The <dfn title="dom-select-namedItem"><code>namedItem(<var title="">name</var>)</code></dfn>
+ method must return the value returned by the method of the same name on the <code
+ title="dom-select-options">options</code> collection, when invoked with the same argument.</p>
- <p>When the user agent is to <dfn
- title="dom-HTMLSelectElement-setter">set the value of a new indexed
- property</dfn> for a given property index <var title="">index</var>
- to a new value <var title="">value</var>, it must instead <span
- title="dom-HTMLOptionsCollection-setter">set the value of a new
- indexed property</span> with the given property index <var
- title="">index</var> to the new value <var title="">value</var> on the
- <code title="dom-select-options">options</code> collection.</p>
+ <p>When the user agent is to <dfn title="dom-HTMLSelectElement-setter">set the value of a new
+ indexed property</dfn> for a given property index <var title="">index</var> to a new value <var
+ title="">value</var>, it must instead <span title="dom-HTMLOptionsCollection-setter">set the value
+ of a new indexed property</span> with the given property index <var title="">index</var> to the
+ new value <var title="">value</var> on the <code title="dom-select-options">options</code>
+ collection.</p>
- <p>Similarly, the <dfn
- title="dom-select-add"><code>add()</code></dfn> and <dfn
- title="dom-select-remove"><code>remove()</code></dfn> methods must
- act like their namesake methods on that same <code
- title="dom-select-options">options</code> collection.</p>
+ <p>Similarly, the <dfn title="dom-select-add"><code>add()</code></dfn> and <dfn
+ title="dom-select-remove"><code>remove()</code></dfn> methods must act like their namesake methods
+ on that same <code title="dom-select-options">options</code> collection.</p>
- <p>The <dfn
- title="dom-select-selectedOptions"><code>selectedOptions</code></dfn>
- IDL attribute must return an <code>HTMLCollection</code> rooted at
- the <code>select</code> node, whose filter matches the elements in
- the <span title="concept-select-option-list">list of options</span>
- that have their <span
- title="concept-option-selectedness">selectedness</span> set to
- true.</p>
+ <p>The <dfn title="dom-select-selectedOptions"><code>selectedOptions</code></dfn> IDL attribute
+ must return an <code>HTMLCollection</code> rooted at the <code>select</code> node, whose filter
+ matches the elements in the <span title="concept-select-option-list">list of options</span> that
+ have their <span title="concept-option-selectedness">selectedness</span> set to true.</p>
- <p>The <dfn
- title="dom-select-selectedIndex"><code>selectedIndex</code></dfn>
- IDL attribute, on getting, must return the <span
- title="concept-option-index">index</span> of the first
- <code>option</code> element in the <span
- title="concept-select-option-list">list of options</span> in
- <span>tree order</span> that has its <span
- title="concept-option-selectedness">selectedness</span> set to true,
- if any. If there isn't one, then it must return −1.</p>
+ <p>The <dfn title="dom-select-selectedIndex"><code>selectedIndex</code></dfn> IDL attribute, on
+ getting, must return the <span title="concept-option-index">index</span> of the first
+ <code>option</code> element in the <span title="concept-select-option-list">list of options</span>
+ in <span>tree order</span> that has its <span
+ title="concept-option-selectedness">selectedness</span> set to true, if any. If there isn't one,
+ then it must return −1.</p>
- <p>On setting, the <code
- title="dom-select-selectedIndex">selectedIndex</code> attribute must
- set the <span
- title="concept-option-selectedness">selectedness</span> of all the
- <code>option</code> elements in the <span
- title="concept-select-option-list">list of options</span> to false,
- and then the <code>option</code> element in the <span
- title="concept-select-option-list">list of options</span> whose
- <span title="concept-option-index">index</span> is the given new
- value, if any, must have its <span
- title="concept-option-selectedness">selectedness</span> set to
- true.</p>
+ <p>On setting, the <code title="dom-select-selectedIndex">selectedIndex</code> attribute must set
+ the <span title="concept-option-selectedness">selectedness</span> of all the <code>option</code>
+ elements in the <span title="concept-select-option-list">list of options</span> to false, and then
+ the <code>option</code> element in the <span title="concept-select-option-list">list of
+ options</span> whose <span title="concept-option-index">index</span> is the given new value, if
+ any, must have its <span title="concept-option-selectedness">selectedness</span> set to true.</p>
- <p>The <dfn title="dom-select-value"><code>value</code></dfn> IDL
- attribute, on getting, must return the <span
- title="concept-option-value">value</span> of the first
- <code>option</code> element in the <span
- title="concept-select-option-list">list of options</span> in
- <span>tree order</span> that has its <span
- title="concept-option-selectedness">selectedness</span> set to true,
- if any. If there isn't one, then it must return the empty
- string.</p>
+ <p>The <dfn title="dom-select-value"><code>value</code></dfn> IDL attribute, on getting, must
+ return the <span title="concept-option-value">value</span> of the first <code>option</code>
+ element in the <span title="concept-select-option-list">list of options</span> in <span>tree
+ order</span> that has its <span title="concept-option-selectedness">selectedness</span> set to
+ true, if any. If there isn't one, then it must return the empty string.</p>
- <p>On setting, the <code title="dom-select-value">value</code>
- attribute must set the <span
- title="concept-option-selectedness">selectedness</span> of all the
- <code>option</code> elements in the <span
- title="concept-select-option-list">list of options</span> to false,
- and then the first <code>option</code> element in the <span
- title="concept-select-option-list">list of options</span>, in
- <span>tree order</span>, whose <span
- title="concept-option-value">value</span> is equal to the given new
- value, if any, must have its <span
- title="concept-option-selectedness">selectedness</span> set to
- true.</p>
+ <p>On setting, the <code title="dom-select-value">value</code> attribute must set the <span
+ title="concept-option-selectedness">selectedness</span> of all the <code>option</code> elements in
+ the <span title="concept-select-option-list">list of options</span> to false, and then the first
+ <code>option</code> element in the <span title="concept-select-option-list">list of
+ options</span>, in <span>tree order</span>, whose <span title="concept-option-value">value</span>
+ is equal to the given new value, if any, must have its <span
+ title="concept-option-selectedness">selectedness</span> set to true.</p>
- <p>The <dfn title="dom-select-multiple"><code>multiple</code></dfn>,
- <dfn title="dom-select-required"><code>required</code></dfn>, and
- <dfn title="dom-select-size"><code>size</code></dfn> IDL attributes
- must <span>reflect</span> the respective content attributes of the
- same name. The <code title="dom-select-size">size</code> IDL
- attribute has a default value of zero.</p> <!-- see bug 12288 for
- compat reasons why .size allows zero (it's not limited to values
- greater than zero) even though that value really makes no sense -->
+ <p>The <dfn title="dom-select-multiple"><code>multiple</code></dfn>, <dfn
+ title="dom-select-required"><code>required</code></dfn>, and <dfn
+ title="dom-select-size"><code>size</code></dfn> IDL attributes must <span>reflect</span> the
+ respective content attributes of the same name. The <code title="dom-select-size">size</code> IDL
+ attribute has a default value of zero.</p> <!-- see bug 12288 for compat reasons why .size allows
+ zero (it's not limited to values greater than zero) even though that value really makes no sense
+ -->
- <p class="note">For historical reasons, the default value of the
- <code title="dom-select-size">size</code> IDL attribute does not
- return the actual size used, which, in the absence of the <code
- title="attr-select-size">size</code> content attribute, is either 1
- or 4 depending on the presence of the <code
- title="attr-select-multiple">multiple</code> attribute.</p>
+ <p class="note">For historical reasons, the default value of the <code
+ title="dom-select-size">size</code> IDL attribute does not return the actual size used, which, in
+ the absence of the <code title="attr-select-size">size</code> content attribute, is either 1 or 4
+ depending on the presence of the <code title="attr-select-multiple">multiple</code> attribute.</p>
<p>The <code title="dom-cva-willValidate">willValidate</code>, <code
title="dom-cva-validity">validity</code>, and <code
- title="dom-cva-validationMessage">validationMessage</code> IDL
- attributes, and the <code
+ title="dom-cva-validationMessage">validationMessage</code> IDL attributes, and the <code
title="dom-cva-checkValidity">checkValidity()</code> and <code
- title="dom-cva-setCustomValidity">setCustomValidity()</code>
- methods, are part of the <span>constraint validation API</span>. The
- <code title="dom-lfe-labels">labels</code> IDL attribute provides a
- list of the element's <code>label</code>s. The <code
- title="dom-fe-autofocus">autofocus</code>, <code
- title="dom-fe-disabled">disabled</code>, <code
- title="dom-fae-form">form</code>, and <code
- title="dom-fe-name">name</code> IDL attributes are part of the
- element's forms API.</p>
+ title="dom-cva-setCustomValidity">setCustomValidity()</code> methods, are part of the
+ <span>constraint validation API</span>. The <code title="dom-lfe-labels">labels</code> IDL
+ attribute provides a list of the element's <code>label</code>s. The <code
+ title="dom-fe-autofocus">autofocus</code>, <code title="dom-fe-disabled">disabled</code>, <code
+ title="dom-fae-form">form</code>, and <code title="dom-fe-name">name</code> IDL attributes are
+ part of the element's forms API.</p>
</div>
<!--TOPIC:HTML-->
<div class="example">
- <p>The following example shows how a <code>select</code> element
- can be used to offer the user with a set of options from which the
- user can select a single option. The default option is
+ <p>The following example shows how a <code>select</code> element can be used to offer the user
+ with a set of options from which the user can select a single option. The default option is
preselected.</p>
<pre><p>
@@ -60864,8 +60777,7 @@
</select>
</p></pre>
- <p>When there is no default option, a placeholder can be used
- instead:</p>
+ <p>When there is no default option, a placeholder can be used instead:</p>
<pre><select name="unittype" <strong>required</strong>>
<strong><option value=""> Select unit type </option></strong>
@@ -60880,8 +60792,8 @@
<div class="example">
- <p>Here, the user is offered a set of options from which he can
- select any number. By default, all five options are selected.</p>
+ <p>Here, the user is offered a set of options from which he can select any number. By default,
+ all five options are selected.</p>
<pre><p>
<label for="allowedunits">Select unit types to enable on this map:</label>
@@ -60898,8 +60810,7 @@
<div class="example">
- <p>Sometimes, a user has to select one or more items. This example
- shows such an interface.</p>
+ <p>Sometimes, a user has to select one or more items. This example shows such an interface.</p>
<pre><p>Select the songs from that you would like on your Act II Mix Tape:</p>
<select multiple required name="act2">
More information about the Commit-Watchers
mailing list