[] (0) Filling in the rendering section: more <input> types -- date, …

…number, range, color.

git-svn-id: http://svn.whatwg.org/webapps@2766 340c8d12-0b0e-0410-8428-c7bf67bfef74

index

@@ -34,7 +34,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; 6 February 2009</h2>
   <h2 class="no-num no-toc" id=draft-recommendation-&mdash;-date:-01-jan-1901>Draft Recommendation &mdash; 7 February 2009</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>
  <h4 id=the-input-element-as-a-text-entry-widget><span class=secno>10.4.6 </span>The <code><a href=#the-input-element>input</a></code> element as a text entry widget</h4>

  <pre class=css>@namespace url(http://www.w3.org/1999/xhtml);
input { binding: <i title="">textfield</i>; }
input[type=password] { binding: <i title="">textfield-password</i>; }
input { binding: <i title="">input-textfield</i>; }
input[type=password] { binding: <i title="">input-password</i>; }
/* later rules override this for other values of type="" */</pre>

  <p>When the <i title="">textfield</i> binding applies to an
  <p>When the <i title="">input-textfield</i> binding applies to an
  <code><a href=#the-input-element>input</a></code> element whose <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#text-state-and-search-state title=attr-input-type-text>Text</a>, <a href=#text-state-and-search-state title=attr-input-type-search>Search</a>, <a href=#url-state title=attr-input-type-url>URL</a>, or <a href=#e-mail-state title=attr-input-type-email>E-mail</a> state, the element is
  expected to render as an 'inline-block' box rendered as a text
  field.</p>

  <p>When the <i title="">textfield</i> binding applies, to an
  <p>When the <i title="">input-password</i> binding applies, to an
  <code><a href=#the-input-element>input</a></code> element whose <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#password-state title=attr-input-type-password>Password</a> state, the element
  is expected to render as an 'inline-block' box rendered as a text
  field whose contents are obscured.</p>
  <p>The <dfn id=converting-a-character-width-to-pixels>converting a character width to pixels</dfn> algorithm
  return <span>(<var title="">size-1</var>)&times;<var title="">avg</var>&nbsp;+&nbsp;<var title="">max</var></span>, where
  <var title="">size</var> is the character width to convert, <var title="">avg</var> is the average character width of the primary
  font for the element for which the algorithm is being run, and <var title="">max</var> is the maximum character width of that same
  font. (The element's 'letter-spacing' property does not affect the
  result.)</p>
  font for the element for which the algorithm is being run, in
  pixels, and <var title="">max</var> is the maximum character width
  of that same font, also in pixels. (The element's 'letter-spacing'
  property does not affect the result.)</p>



  <h4 id=the-input-element-as-domain-specific-widgets><span class=secno>10.4.7 </span>The <code><a href=#the-input-element>input</a></code> element as domain-specific widgets</h4>

  <p class=XXX>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#date-and-time-state title=attr-input-type-datetime>Date and Time</a>, <a href=#date-state title=attr-input-type-date>Date</a>, <a href=#month-state title=attr-input-type-month>Month</a>, <a href=#week-state title=attr-input-type-week>Week</a>, <a href=#time-state title=attr-input-type-time>Time</a>, <a href=#local-date-and-time-state title=attr-input-type-datetime-local>Local Date and Time</a> or
  <a href=#number-state title=attr-input-type-number>Number</a> state...</p>
  <!-- datalist presentation -->
  <pre class=css>@namespace url(http://www.w3.org/1999/xhtml);
input[type=datetime] { binding: <i title="">input-datetime</i>; }
input[type=date] { binding: <i title="">input-date</i>; }
input[type=month] { binding: <i title="">input-month</i>; }
input[type=week] { binding: <i title="">input-week</i>; }
input[type=time] { binding: <i title="">input-time</i>; }
input[type=datetime-local] { binding: <i title="">input-datetime-local</i>; }
input[type=number] { binding: <i title="">input-number</i>; }</pre>

  <p>When the <i title="">datetime</i> binding applies to an
  <code><a href=#the-input-element>input</a></code> element whose <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#date-and-time-state title=attr-input-type-datetime>Date and Time</a> state, the
  element is expected to render as an 'inline-block' box depicting a
  Date and Time control.</p>

  <p>When the <i title="">date</i> binding applies to an
  <code><a href=#the-input-element>input</a></code> element whose <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#date-state title=attr-input-type-date>Date</a> state, the element is
  expected to render as an 'inline-block' box depicting a Date
  control.</p>

  <p>When the <i title="">month</i> binding applies to an
  <code><a href=#the-input-element>input</a></code> element whose <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#month-state title=attr-input-type-month>Month</a> state, the element is
  expected to render as an 'inline-block' box depicting a Month
  control.</p>

  <p>When the <i title="">week</i> binding applies to an
  <code><a href=#the-input-element>input</a></code> element whose <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#week-state title=attr-input-type-week>Week</a> state, the element is
  expected to render as an 'inline-block' box depicting a Week
  control.</p>

  <p>When the <i title="">time</i> binding applies to an
  <code><a href=#the-input-element>input</a></code> element whose <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#time-state title=attr-input-type-time>Time</a> state, the element is
  expected to render as an 'inline-block' box depicting a Time
  control.</p>

  <p>When the <i title="">datetime-local</i> binding applies to an
  <code><a href=#the-input-element>input</a></code> element whose <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#local-date-and-time-state title=attr-input-type-datetime-local>Local Date and Time</a>
  state, the element is expected to render as an 'inline-block' box
  depicting a Local Date and Time control.</p>

  <p>When the <i title="">number</i> binding applies to an
  <code><a href=#the-input-element>input</a></code> element whose <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#number-state title=attr-input-type-number>Number</a> state, the element is
  expected to render as an 'inline-block' box depicting a Number
  control.</p>

  <p>These controls are all expected to be about one line high, and
  about as wide as necessary to show the widest possible value.</p>



  <h4 id=the-input-element-as-a-range-control><span class=secno>10.4.8 </span>The <code><a href=#the-input-element>input</a></code> element as a range control</h4>

  <p class=XXX>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#range-state title=attr-input-type-range>Range</a> state, ...</p>
  <!-- datalist presentation -->
  <pre class=css>@namespace url(http://www.w3.org/1999/xhtml);
input[type=range] { binding: <i title="">input-range</i>; }</pre>

  <p>When the <i title="">datetime</i> binding applies to an
  <code><a href=#the-input-element>input</a></code> element whose <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#range-state title=attr-input-type-range>Range</a> state, the element is
  expected to render as an 'inline-block' box depicting a slider
  control.</p>

  <p>When the control is wider than it is tall, the control is
  expected to be a horizontal slider, with the lowest value on the
  right if the 'direction' property on this element has a computed
  value of 'rtl', and on the left otherwise. When the control is
  taller than it is wide, it is expected to be a vertical slider, with
  the lowest value on the top.</p>

  <p>Predefined suggested values (provided by the <code title=attr-input-list><a href=#attr-input-list>list</a></code> attribute) are expected to be
  shown as tick marks on the slider, which the slider can snap to.</p>



  <h4 id=the-input-element-as-a-color-well><span class=secno>10.4.9 </span>The <code><a href=#the-input-element>input</a></code> element as a color well</h4>

  <p class=XXX>When an <code><a href=#the-input-element>input</a></code> element's <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#color-state title=attr-input-type-color>Color</a> state, ...</p>
  <!-- datalist presentation -->
  <pre class=css>@namespace url(http://www.w3.org/1999/xhtml);
input[type=color] { binding: <i title="">input-color</i>; }</pre>

  <p>When the <i title="">datetime</i> binding applies to an
  <code><a href=#the-input-element>input</a></code> element whose <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#color-state title=attr-input-type-color>Color</a> state, the element is
  expected to render as an 'inline-block' box depicting a color well,
  which, when activated, provides the user with a color picker (e.g. a
  color wheel or color palette) from which the color can be
  changed.</p>

  <p>Predefined suggested values (provided by the <code title=attr-input-list><a href=#attr-input-list>list</a></code> attribute) are expected to be
  shown in the color picker interface, not on the color well
  itself.</p>

source

  <h4>The <code>input</code> element as a text entry widget</h4>

  <pre class="css">@namespace url(http://www.w3.org/1999/xhtml);
input { binding: <i title="">textfield</i>; }
input[type=password] { binding: <i title="">textfield-password</i>; }
input { binding: <i title="">input-textfield</i>; }
input[type=password] { binding: <i title="">input-password</i>; }
/* later rules override this for other values of type="" */</pre>

  <p>When the <i title="">textfield</i> binding applies to an
  <p>When the <i title="">input-textfield</i> binding applies to an
  <code>input</code> element whose <code
  title="attr-input-type">type</code> attribute is in the <span
  title="attr-input-type-text">Text</span>, <span
  expected to render as an 'inline-block' box rendered as a text
  field.</p>

  <p>When the <i title="">textfield</i> binding applies, to an
  <p>When the <i title="">input-password</i> binding applies, to an
  <code>input</code> element whose <code
  title="attr-input-type">type</code> attribute is in the <span
  title="attr-input-type-password">Password</span> state, the element
  title="">avg</var>&nbsp;+&nbsp;<var title="">max</var></span>, where
  <var title="">size</var> is the character width to convert, <var
  title="">avg</var> is the average character width of the primary
  font for the element for which the algorithm is being run, and <var
  title="">max</var> is the maximum character width of that same
  font. (The element's 'letter-spacing' property does not affect the
  result.)</p>
  font for the element for which the algorithm is being run, in
  pixels, and <var title="">max</var> is the maximum character width
  of that same font, also in pixels. (The element's 'letter-spacing'
  property does not affect the result.)</p>



  <h4>The <code>input</code> element as domain-specific widgets</h4>

  <p class="XXX">When an <code>input</code> element's <code
  <pre class="css">@namespace url(http://www.w3.org/1999/xhtml);
input[type=datetime] { binding: <i title="">input-datetime</i>; }
input[type=date] { binding: <i title="">input-date</i>; }
input[type=month] { binding: <i title="">input-month</i>; }
input[type=week] { binding: <i title="">input-week</i>; }
input[type=time] { binding: <i title="">input-time</i>; }
input[type=datetime-local] { binding: <i title="">input-datetime-local</i>; }
input[type=number] { binding: <i title="">input-number</i>; }</pre>

  <p>When the <i title="">datetime</i> binding applies to an
  <code>input</code> element whose <code
  title="attr-input-type">type</code> attribute is in the <span
  title="attr-input-type-datetime">Date and Time</span> state, the
  element is expected to render as an 'inline-block' box depicting a
  Date and Time control.</p>

  <p>When the <i title="">date</i> binding applies to an
  <code>input</code> element whose <code
  title="attr-input-type">type</code> attribute is in the <span
  title="attr-input-type-date">Date</span> state, the element is
  expected to render as an 'inline-block' box depicting a Date
  control.</p>

  <p>When the <i title="">month</i> binding applies to an
  <code>input</code> element whose <code
  title="attr-input-type">type</code> attribute is in the <span
  title="attr-input-type-datetime">Date and Time</span>, <span
  title="attr-input-type-date">Date</span>, <span
  title="attr-input-type-month">Month</span>, <span
  title="attr-input-type-week">Week</span>, <span
  title="attr-input-type-time">Time</span>, <span
  title="attr-input-type-datetime-local">Local Date and Time</span> or
  <span title="attr-input-type-number">Number</span> state...</p>
  <!-- datalist presentation -->
  title="attr-input-type-month">Month</span> state, the element is
  expected to render as an 'inline-block' box depicting a Month
  control.</p>

  <p>When the <i title="">week</i> binding applies to an
  <code>input</code> element whose <code
  title="attr-input-type">type</code> attribute is in the <span
  title="attr-input-type-week">Week</span> state, the element is
  expected to render as an 'inline-block' box depicting a Week
  control.</p>

  <p>When the <i title="">time</i> binding applies to an
  <code>input</code> element whose <code
  title="attr-input-type">type</code> attribute is in the <span
  title="attr-input-type-time">Time</span> state, the element is
  expected to render as an 'inline-block' box depicting a Time
  control.</p>

  <p>When the <i title="">datetime-local</i> binding applies to an
  <code>input</code> element whose <code
  title="attr-input-type">type</code> attribute is in the <span
  title="attr-input-type-datetime-local">Local Date and Time</span>
  state, the element is expected to render as an 'inline-block' box
  depicting a Local Date and Time control.</p>

  <p>When the <i title="">number</i> binding applies to an
  <code>input</code> element whose <code
  title="attr-input-type">type</code> attribute is in the <span
  title="attr-input-type-number">Number</span> state, the element is
  expected to render as an 'inline-block' box depicting a Number
  control.</p>

  <p>These controls are all expected to be about one line high, and
  about as wide as necessary to show the widest possible value.</p>



  <h4>The <code>input</code> element as a range control</h4>

  <p class="XXX">When an <code>input</code> element's <code
  <pre class="css">@namespace url(http://www.w3.org/1999/xhtml);
input[type=range] { binding: <i title="">input-range</i>; }</pre>

  <p>When the <i title="">datetime</i> binding applies to an
  <code>input</code> element whose <code
  title="attr-input-type">type</code> attribute is in the <span
  title="attr-input-type-range">Range</span> state, ...</p>
  <!-- datalist presentation -->
  title="attr-input-type-range">Range</span> state, the element is
  expected to render as an 'inline-block' box depicting a slider
  control.</p>

  <p>When the control is wider than it is tall, the control is
  expected to be a horizontal slider, with the lowest value on the
  right if the 'direction' property on this element has a computed
  value of 'rtl', and on the left otherwise. When the control is
  taller than it is wide, it is expected to be a vertical slider, with
  the lowest value on the top.</p>

  <p>Predefined suggested values (provided by the <code
  title="attr-input-list">list</code> attribute) are expected to be
  shown as tick marks on the slider, which the slider can snap to.</p>



  <h4>The <code>input</code> element as a color well</h4>

  <p class="XXX">When an <code>input</code> element's <code
  <pre class="css">@namespace url(http://www.w3.org/1999/xhtml);
input[type=color] { binding: <i title="">input-color</i>; }</pre>

  <p>When the <i title="">datetime</i> binding applies to an
  <code>input</code> element whose <code
  title="attr-input-type">type</code> attribute is in the <span
  title="attr-input-type-color">Color</span> state, ...</p>
  <!-- datalist presentation -->
  title="attr-input-type-color">Color</span> state, the element is
  expected to render as an 'inline-block' box depicting a color well,
  which, when activated, provides the user with a color picker (e.g. a
  color wheel or color palette) from which the color can be
  changed.</p>

  <p>Predefined suggested values (provided by the <code
  title="attr-input-list">list</code> attribute) are expected to be
  shown in the color picker interface, not on the color well
  itself.</p>