Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
[] (0) WF2: <select> -- the beginnings. Also: typo fixes, fix <input …
…size> definition to make better use of rfc2119 terms, and move .labels in the IDL down to after the CVA stuff, so that it matches the order in the prose.

git-svn-id: http://svn.whatwg.org/webapps@2285 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
Hixie committed Oct 6, 2008
1 parent b74ba69 commit c3be9ca
Show file tree
Hide file tree
Showing 2 changed files with 179 additions and 42 deletions.
114 changes: 90 additions & 24 deletions index
Expand Up @@ -16,7 +16,7 @@
<div class=head>
<p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG src=/images/logo></a></p>
<h1>HTML 5</h1>
<h2 class="no-num no-toc" id=draft-recommendation-&mdash;-date:-01-jan-1901>Draft Recommendation &mdash; 5 October 2008</h2>
<h2 class="no-num no-toc" id=draft-recommendation-&mdash;-date:-01-jan-1901>Draft Recommendation &mdash; 6 October 2008</h2>
<p>You can take part in this work. <a href=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
<p><strong>Web designers!</strong> We have a <a href=http://blog.whatwg.org/faq/>FAQ</a>, a <a href=http://forums.whatwg.org/>forum</a>, and a <a href=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
<dl><dt>Multiple-page version:</dt>
Expand Down Expand Up @@ -17286,7 +17286,7 @@ interface <dfn id=htmlaudioelement>HTMLAudioElement</dfn> : <a href=#htmlmediael

<p>The <dfn id=effective-loop-start><var>effective loop start</var></dfn> is the smaller of
the <code title=dom-media-loopStart><a href=#dom-media-loopstart>loopStart</a></code> DOM attribute
and the end of the <a href=#media-resource>media resource</a>.<p>
and the end of the <a href=#media-resource>media resource</a>.</p>

<p>The <dfn id=attr-media-loopend title=attr-media-loopend><code>loopend</code></dfn>
content attribute gives an offset into the <a href=#media-resource>media
Expand All @@ -17298,7 +17298,7 @@ interface <dfn id=htmlaudioelement>HTMLAudioElement</dfn> : <a href=#htmlmediael
<p>The <dfn id=effective-loop-end><var>effective loop end</var></dfn> is the greater of
the <code title=dom-media-start><a href=#dom-media-start>start</a></code>, <code title=dom-media-loopStart><a href=#dom-media-loopstart>loopStart</a></code>, and <code title=dom-media-loopEnd><a href=#dom-media-loopend>loopEnd</a></code> DOM attributes, except if
that is greater than the end of the <a href=#media-resource>media resource</a>, in
which case that's its value.<p>
which case that's its value.</p>

<p>The <dfn id=attr-media-end title=attr-media-end><code>end</code></dfn> content
attribute gives an offset into the <a href=#media-resource>media resource</a> at
Expand All @@ -17307,7 +17307,7 @@ interface <dfn id=htmlaudioelement>HTMLAudioElement</dfn> : <a href=#htmlmediael
<p>The <dfn id=effective-end><var>effective end</var></dfn> is the greater of the
<code title=dom-media-start><a href=#dom-media-start>start</a></code>, <code title=dom-media-loopStart><a href=#dom-media-loopstart>loopStart</a></code>, and <code title=dom-media-loopEnd><a href=#dom-media-loopend>end</a></code> DOM attributes, except if that
is greater than the end of the <a href=#media-resource>media resource</a>, in which
case that's its value.<p>
case that's its value.</p>

<p>The <code title=attr-media-start><a href=#attr-media-start>start</a></code>, <code title=attr-media-loopstart><a href=#attr-media-loopstart>loopstart</a></code>, <code title=attr-media-loopend><a href=#attr-media-loopend>loopend</a></code>, and <code title=attr-media-end><a href=#attr-media-end>end</a></code> attributes must, if specified,
contain <span title="value time offset">value time
Expand Down Expand Up @@ -22976,8 +22976,6 @@ function AddCloud(data, x, y) { ... }</pre>
attribute float <a href=#dom-input-valueasnumber title=dom-input-valueAsNumber>valueAsNumber</a>;
readonly attribute <a href=#htmloptionelement>HTMLOptionElement</a> <a href=#dom-input-selectedoption title=dom-input-selectedOption>selectedOption</a>;

readonly attribute <span>NodeList</span> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;

void <a href=#dom-input-stepup title=dom-input-stepUp>stepUp</a>(in int n);
void <a href=#dom-input-stepdown title=dom-input-stepDown>stepDown</a>(in int n);

Expand All @@ -22986,6 +22984,8 @@ function AddCloud(data, x, y) { ... }</pre>
readonly attribute DOMString <a href=#dom-cva-validationmessage title=dom-cva-validationMessage>validationMessage</a>;
boolean <a href=#dom-cva-checkvalidatity title=dom-cva-checkValidatity>checkValidity</a>();
void <a href=#dom-cva-setcustomvalidity title=dom-cva-setCustomValidity>setCustomValidity</a>(in DOMString error);

readonly attribute <span>NodeList</span> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;
};</pre>
</dd>
</dl><!-- XXX add selectionStart and company --><p>The <code><a href=#the-input-element>input</a></code> element represents a typed data field,
Expand Down Expand Up @@ -25744,12 +25744,21 @@ function AddCloud(data, x, y) { ... }</pre>
<h6 id=the-size-attribute><span class=secno>4.10.4.2.4 </span>The <code title=attr-input-size><a href=#attr-input-size>size</a></code> attribute</h6>

<p>The <dfn id=attr-input-size title=attr-input-size><code>size</code></dfn>
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>
attribute gives the number of characters that, in a visual
rendering, the user agent is to allow the user to see while editing
the element's <a href=#concept-fe-value title=concept-fe-value>value</a>.</p>

<p>The attribute's value gives the number of characters that, in a
visual rendering, the user agent should allow the user to see while
editing the element's <a href=#concept-fe-value title=concept-fe-value>value</a>.</p>
<p>The <code title=attr-input-size><a href=#attr-input-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>If the attribute is present, then its value must be parsed using
the <a href=#rules-for-parsing-non-negative-integers>rules for parsing non-negative integers</a>, and if the
result is a number greater than zero, then the user agent should
ensure that at least that many characters are visible.</p>

<p class=XXX>The rendering section will define this in more
detail.</p>

<p>The <code title=dom-input-size><a href=#dom-input-size>size</a></code> DOM attribute
<a href=#limited-to-only-positive-non-zero-numbers>limited to only positive non-zero numbers</a>.</p>
Expand Down Expand Up @@ -26156,13 +26165,13 @@ function AddCloud(data, x, y) { ... }</pre>
attribute DOMString <a href=#dom-button-type title=dom-button-type>type</a>;
attribute DOMString <a href=#dom-button-value title=dom-button-value>value</a>;

readonly attribute <span>NodeList</span> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;

readonly attribute boolean <a href=#dom-cva-willvalidate title=dom-cva-willValidate>willValidate</a>;
readonly attribute <span>ValidityState</span> <a href=#dom-cva-validity title=dom-cva-validity>validity</a>;
readonly attribute DOMString <a href=#dom-cva-validationmessage title=dom-cva-validationMessage>validationMessage</a>;
boolean <a href=#dom-cva-checkvalidatity title=dom-cva-checkValidatity>checkValidity</a>();
void <a href=#dom-cva-setcustomvalidity title=dom-cva-setCustomValidity>setCustomValidity</a>(in DOMString error);

readonly attribute <span>NodeList</span> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;
};</pre>
</dd>
</dl><p>The <code><a href=#the-button-element>button</a></code> element represents a button. If the
Expand Down Expand Up @@ -26257,18 +26266,18 @@ function AddCloud(data, x, y) { ... }</pre>
<dd><code title=attr-fe-autofocus><a href=#attr-fe-autofocus>autofocus</a></code></dd>
<dd><code title=attr-fe-disabled><a href=#attr-fe-disabled>disabled</a></code></dd>
<dd><code title=attr-fae-form><a href=#attr-fae-form>form</a></code></dd>
<dd><code title=attr-select-multiple>multiple</code></dd>
<dd><code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code></dd>
<dd><code title=attr-fe-name><a href=#attr-fe-name>name</a></code></dd>
<dd><code title=attr-select-size>size</code></dd>
<dd><code title=attr-select-size><a href=#attr-select-size>size</a></code></dd>
<dt>DOM interface:</dt>
<dd>
<pre class=idl>interface <dfn id=htmlselectelement>HTMLSelectElement</dfn> : <a href=#htmlelement>HTMLElement</a> {
attribute boolean <a href=#dom-fe-autofocus title=dom-fe-autofocus>autofocus</a>;
attribute boolean <a href=#dom-fe-disabled title=dom-fe-disabled>disabled</a>;
readonly attribute <a href=#htmlformelement>HTMLFormElement</a> <a href=#dom-fae-form title=dom-fae-form>form</a>;
attribute boolean <span title=dom-select-multiple>multiple</span>;
attribute boolean <a href=#dom-select-multiple title=dom-select-multiple>multiple</a>;
attribute DOMString <a href=#dom-fe-name title=dom-fe-name>name</a>;
attribute boolean <span title=dom-select-size>size</span>;
attribute boolean <a href=#dom-select-size title=dom-select-size>size</a>;

readonly attribute DOMString <span title=dom-select-type>type</span>;

Expand All @@ -26280,8 +26289,6 @@ function AddCloud(data, x, y) { ... }</pre>
attribute long <span title=dom-select-selectedIndex>selectedIndex</span>;
attribute DOMString <span title=dom-select-value>value</span>;

readonly attribute <span>NodeList</span> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;

void <span title=dom-select-add>add</span>(in <a href=#htmlelement>HTMLElement</a> element, in <a href=#htmlelement>HTMLElement</a> before);
void <span title=dom-select-remove>remove</span>(in long index);

Expand All @@ -26290,9 +26297,45 @@ function AddCloud(data, x, y) { ... }</pre>
readonly attribute DOMString <a href=#dom-cva-validationmessage title=dom-cva-validationMessage>validationMessage</a>;
boolean <a href=#dom-cva-checkvalidatity title=dom-cva-checkValidatity>checkValidity</a>();
void <a href=#dom-cva-setcustomvalidity title=dom-cva-setCustomValidity>setCustomValidity</a>(in DOMString error);

readonly attribute <span>NodeList</span> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;
};</pre>
</dd>
</dl><p class=XXX>...</p>
</dl><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 represents a control
for selecting zero or more options from the <a href=#select-option-list title=select-option-list>list of options</a>. If the attribute
is absent, then the <code><a href=#the-select-element>select</a></code> element represents a control
for selecting a single option from the <a href=#select-option-list title=select-option-list>list of options</a>.</p>

<p>The <dfn id=select-option-list title=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-size title=attr-select-size><code>size</code></dfn>
attribute gives the number of options to show to the user. The <code title=attr-input-size><a href=#attr-input-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. If the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute is present,
then the <code title=attr-input-size><a href=#attr-input-size>size</a></code> attribute's
default value is 4. If the <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute is absent,
then the <code title=attr-input-size><a href=#attr-input-size>size</a></code> attribute's
default value is 1.</p>

<!-- XXX for the rendering section
<p>If the <code title="attr-select-multiple">multiple</code>
attribute is absent, and either the <code
title="attr-input-size">size</code> attribute is also absent or
parsing its value using the <span>rules for parsing non-negative
integers</span> returns 1, 0, or an error, then the control should
be rendered as a drop-down select box. Otherwise, it should be
rendered as a list select box.</p>
-->

<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
Expand All @@ -26302,6 +26345,29 @@ function AddCloud(data, x, y) { ... }</pre>
submitted. The <code title=attr-fe-autofocus><a href=#attr-fe-autofocus>autofocus</a></code>
attribute controls focus.</p>

<p class=XXX>...</p>

<!-- XXX
readonly attribute DOMString <span title="dom-select-type">type</span>;

readonly attribute <span>HTMLOptionsCollection</span> <span title="dom-select-options">options</span>;
attribute unsigned long <span title="dom-select-length">length</span>;
[IndexGetter] <span>HTMLElement</span> <span title="dom-select-XXX9">XXX9</span>(in unsigned long index);

readonly attribute <span>HTMLOptionsCollection</span> <span title="dom-select-selectedOptions">selectedOptions</span>;
attribute long <span title="dom-select-selectedIndex">selectedIndex</span>;
attribute DOMString <span title="dom-select-value">value</span>;

void <span title="dom-select-add">add</span>(in <span>HTMLElement</span> element, in <span>HTMLElement</span> before);
void <span title="dom-select-remove">remove</span>(in long index);
-->

<p>The <dfn id=dom-select-multiple title=dom-select-multiple><code>multiple</code></dfn>
and <dfn id=dom-select-size title=dom-select-size><code>size</code></dfn> DOM
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> DOM attribute <a href=#limited-to-only-positive-non-zero-numbers>limited to
only positive non-zero numbers</a>.</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>
attributes, and the <code title=dom-cva-checkValidatity><a href=#dom-cva-checkvalidatity>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
Expand Down Expand Up @@ -26445,13 +26511,13 @@ interface <dfn id=htmloptionelement>HTMLOptionElement</dfn> : <a href=#htmleleme
attribute DOMString <span title=dom-textarea-defaultValue>defaultValue</span>;
attribute DOMString <span title=dom-textarea-value>value</span>;

readonly attribute <span>NodeList</span> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;

readonly attribute boolean <a href=#dom-cva-willvalidate title=dom-cva-willValidate>willValidate</a>;
readonly attribute <span>ValidityState</span> <a href=#dom-cva-validity title=dom-cva-validity>validity</a>;
readonly attribute DOMString <a href=#dom-cva-validationmessage title=dom-cva-validationMessage>validationMessage</a>;
boolean <a href=#dom-cva-checkvalidatity title=dom-cva-checkValidatity>checkValidity</a>();
void <a href=#dom-cva-setcustomvalidity title=dom-cva-setCustomValidity>setCustomValidity</a>(in DOMString error);

readonly attribute <span>NodeList</span> <a href=#dom-lfe-labels title=dom-lfe-labels>labels</a>;
};</pre>
</dd>
</dl><!-- XXX add selectionStart and company --><p class=XXX>...</p>
Expand Down Expand Up @@ -28291,7 +28357,7 @@ http://mail.gnome.org/archives/usability/2006-June/msg00015.html
<dd>

<p>If the first element child of a cell's element is a
<code><a href=#the-select-element>select</a></code> element that has a no <code title=attr-select-multiple>multiple</code> attribute and has at
<code><a href=#the-select-element>select</a></code> element that has a no <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute and has at
least one <code><a href=#the-option-element>option</a></code> element descendent, then the cell
acts as a cyclable cell.</p>

Expand Down Expand Up @@ -29985,7 +30051,7 @@ menu li:not(:first-child)::before { content: ' | '; }</pre>

<p>The <a href=#command-facet-type title=command-facet-Type>Type</a> of the command
is "radio" if the <code><a href=#the-option-element>option</a></code>'s nearest ancestor
<code><a href=#the-select-element>select</a></code> element has no <code title=attr-select-multiple>multiple</code> attribute, and
<code><a href=#the-select-element>select</a></code> element has no <code title=attr-select-multiple><a href=#attr-select-multiple>multiple</a></code> attribute, and
"checkbox" if it does.</p>

<p>The <a href=#command-facet-id title=command-facet-ID>ID</a> of the command is
Expand Down

0 comments on commit c3be9ca

Please sign in to comment.