Skip to content
Permalink
Browse files

[] (0) WF2: <input type=time>

git-svn-id: http://svn.whatwg.org/webapps@2253 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information...
Hixie committed Sep 30, 2008
1 parent 9bccbfa commit a4b76ea4579a49b71e3e10fd52c3e04cc57a67a8
Showing with 228 additions and 2 deletions.
  1. +117 −1 index
  2. +111 −1 source
118 index
the <a href="#time4" title=attr-input-type-time>Time</a> state, the rules
in this section apply.

<p class=big-issue>...
<p>The <code><a href="#input0">input</a></code> element represents a
control for setting the element's <a href="#value12"
title=concept-fe-value>value</a> to a string representing a specific <a
href="#time" title=concept-time>time</a>.

<p>If the element is <i title=concept-input-mutable><a
href="#mutable">mutable</a></i>, the user should allow the user to change
the <a href="#time" title=concept-time>time</a> represented by its <a
href="#value12" title=concept-fe-value>value</a>, as obtained by <a
href="#parse5" title="parse a time string">parsing a time</a> from it.
User agents must not allow the user to set the <a href="#value12"
title=concept-fe-value>value</a> to a string that is not a <a
href="#valid11">valid time string</a>. If the user agent provides a user
interface for selecting a <a href="#time" title=concept-time>time</a>,
then the <a href="#value12" title=concept-fe-value>value</a> must be set
to a <a href="#valid11">valid time string</a> representing the user's
selection. User agents should allow the user to set the <a href="#value12"
title=concept-fe-value>value</a> to the empty string.

<p><strong>The <a href="#value8">value sanitization algorithm</a> is as
follows:</strong> If the <a href="#value12"
title=concept-fe-value>value</a> of the element is not a <a
href="#valid11">valid time string</a>, then set it to the empty string
instead.

<p>The <code title=attr-input-min><a href="#min2">min</a></code> attribute,
if specified, must have a value that is a <a href="#valid11">valid time
string</a>. The <code title=attr-input-max><a href="#max4">max</a></code>
attribute, if specified, must have a value that is a <a
href="#valid11">valid time string</a>.

<p>The <code title=attr-input-step><a href="#step0">step</a></code>
attribute is expressed in seconds. The <a href="#step-"
title=concept-input-step-scale>step scale factor</a> is 1000 (which
converts the seconds to milliseconds, as used in the other algorithms).
The <a href="#default2" title=concept-input-step-default>default step</a>
is 60 seconds.

<p>When the element is <a href="#suffering3">suffering from a step
mismatch</a>, the user agent may round the element's <span
title=concept-input-value>value</span> to the nearest <a href="#time"
title=concept-time>time</a> for which the element would not <a
href="#suffering3" title="suffering from a step mismatch">suffer from a
step mismatch</a>.

<p><strong>The <a href="#algorithm5"
title=concept-input-value-string-number>algorithm to convert a string to a
number</a>, given a string <var title="">input</var>, is as
follows:</strong> If <a href="#parse5" title="parse a time string">parsing
a time</a> from <var title="">input</var> results in an error, then return
an error; otherwise, return the number of milliseconds elapsed from
midnight to the parsed <a href="#time" title=concept-time>time</a> on a
day with no time changes.

<p><strong>The <a href="#algorithm6"
title=concept-input-value-number-string>algorithm to convert a number to a
string</a>, given a number <var title="">input</var>, is as
follows:</strong> Return a <a href="#valid11">valid time string</a> that
represents the <a href="#time" title=concept-time>time</a> that is <var
title="">input</var> milliseconds after midnight on a day with no time
changes.

<p><strong>The <a href="#algorithm7"
title=concept-input-value-string-date>algorithm to convert a string to a
<code>Date</code> object</a>, given a string <var title="">input</var>, is
as follows:</strong> If <a href="#parse5" title="parse a time
string">parsing a time</a> from <var title="">input</var> results in an
error, then return an error; otherwise, return a <code>Date</code> object
representing the parsed <a href="#time" title=concept-time>time</a> in UTC
on 1970-01-01.

<p><strong>The <a href="#algorithm8"
title=concept-input-value-date-string>algorithm to convert a
<code>Date</code> object to a string</a>, given a <code>Date</code> object
<var title="">input</var>, is as follows:</strong> Return a <a
href="#valid11">valid time string</a> that represents the UTC <a
href="#time" title=concept-time>time</a> component that is represented by
<var title="">input</var>.

<p>The following common <code><a href="#input0">input</a></code> element
content attributes, DOM attributes, and methods apply to the element:
<code title=attr-input-autocomplete><a
href="#autocomplete0">autocomplete</a></code>, <code
title=attr-input-list>list</code>, <code title=attr-input-max><a
href="#max4">max</a></code>, <code title=attr-input-min><a
href="#min2">min</a></code>, <code title=attr-input-readonly><a
href="#readonly0">readonly</a></code>, <code
title=attr-input-required>required</code>, and <code
title=attr-input-step><a href="#step0">step</a></code> content attributes;
<code title=dom-input-list><a href="#list">list</a></code>, <code
title=dom-input-valueAsDate><a href="#valueasdate">valueAsDate</a></code>,
<code title=dom-input-valueAsNumber><a
href="#valueasnumber">valueAsNumber</a></code>, <code
title=dom-input-selectedOption><a
href="#selectedoption">selectedOption</a></code>, <code
title=dom-input-stepUp><a href="#stepup">stepUp()</a></code>, and <code
title=dom-input-stepDown><a href="#stepdown">stepDown()</a></code> DOM
attributes.

<p>The following content attributes must not be specified and do not apply
to the element: <code class=no-backref title=attr-input-accept><a
href="#accept0">accept</a></code>, <code class=no-backref
title=attr-input-alt>alt</code>, <code class=no-backref
title=attr-input-checked>checked</code>, <code class=no-backref
title=attr-input-maxlength><a href="#maxlength0">maxlength</a></code>,
<code class=no-backref title=attr-input-pattern>pattern</code>, <code
class=no-backref title=attr-input-size>size</code>, <code class=no-backref
title=attr-input-src>src</code>, <code class=no-backref
title=attr-fs-target><a href="#target3">target</a></code>, <code
class=no-backref title=attr-fs-method><a href="#method">method</a></code>,
<code class=no-backref title=attr-fs-enctype><a
href="#enctype">enctype</a></code>, and <code class=no-backref
title=attr-fs-action><a href="#action">action</a></code>.

<p>The <code class=no-backref title=dom-input-checked><a
href="#checked1">checked</a></code> DOM attribute does not apply to the
element.

<h6 id=local0><span class=secno>4.10.4.1.10. </span><dfn id=local2
title=attr-input-type-datetime-local>Local Date and Time</dfn> state</h6>
112 source
title="attr-input-type-time">Time</span> state, the rules in this
section apply.</p>

<p class="big-issue">...</p>
<p>The <code>input</code> element represents a control for setting
the element's <span title="concept-fe-value">value</span> to a
string representing a specific <span
title="concept-time">time</span>.</p>

<p>If the element is <i title="concept-input-mutable">mutable</i>,
the user should allow the user to change the <span
title="concept-time">time</span> represented by its <span
title="concept-fe-value">value</span>, as obtained by <span
title="parse a time string">parsing a time</span> from it. User
agents must not allow the user to set the <span
title="concept-fe-value">value</span> to a string that is not a
<span>valid time string</span>. If the user agent provides a user
interface for selecting a <span title="concept-time">time</span>,
then the <span title="concept-fe-value">value</span> must be set to
a <span>valid time string</span> representing the user's
selection. User agents should allow the user to set the <span
title="concept-fe-value">value</span> to the empty string.</p>

<p><strong>The <span>value sanitization algorithm</span> is as
follows:</strong> If the <span title="concept-fe-value">value</span>
of the element is not a <span>valid time string</span>, then set it
to the empty string instead.</p>

<p>The <code title="attr-input-min">min</code> attribute, if
specified, must have a value that is a <span>valid time
string</span>. The <code title="attr-input-max">max</code>
attribute, if specified, must have a value that is a <span>valid
time string</span>.</p>

<p>The <code title="attr-input-step">step</code> attribute is
expressed in seconds. The <span
title="concept-input-step-scale">step scale factor</span> is 1000
(which converts the seconds to milliseconds, as used in the other
algorithms). The <span title="concept-input-step-default">default
step</span> is 60 seconds.</p>

<p>When the element is <span>suffering from a step mismatch</span>,
the user agent may round the element's <span
title="concept-input-value">value</span> to the nearest <span
title="concept-time">time</span> for which the element would not
<span title="suffering from a step mismatch">suffer from a step
mismatch</span>.</p>

<p><strong>The <span
title="concept-input-value-string-number">algorithm to convert a
string to a number</span>, given a string <var title="">input</var>,
is as follows:</strong> If <span title="parse a time string">parsing
a time</span> from <var title="">input</var> results in an error,
then return an error; otherwise, return the number of milliseconds
elapsed from midnight to the parsed <span
title="concept-time">time</span> on a day with no time changes.</p>

<p><strong>The <span
title="concept-input-value-number-string">algorithm to convert a
number to a string</span>, given a number <var title="">input</var>,
is as follows:</strong> Return a <span>valid time string</span> that
represents the <span title="concept-time">time</span> that is <var
title="">input</var> milliseconds after midnight on a day with no
time changes.</p>

<p><strong>The <span
title="concept-input-value-string-date">algorithm to convert a
string to a <code>Date</code> object</span>, given a string <var
title="">input</var>, is as follows:</strong> If <span title="parse
a time string">parsing a time</span> from <var title="">input</var>
results in an error, then return an error; otherwise, return a
<code>Date</code> object representing the parsed <span
title="concept-time">time</span> in UTC on 1970-01-01.</p>

<p><strong>The <span
title="concept-input-value-date-string">algorithm to convert a
<code>Date</code> object to a string</span>, given a
<code>Date</code> object <var title="">input</var>, is as
follows:</strong> Return a <span>valid time string</span> that
represents the UTC <span title="concept-time">time</span> component
that is represented by <var title="">input</var>.</p>

<p>The following common <code>input</code> element content
attributes, DOM attributes, and methods apply to the element:
<code title="attr-input-autocomplete">autocomplete</code>,
<code title="attr-input-list">list</code>,
<code title="attr-input-max">max</code>,
<code title="attr-input-min">min</code>,
<code title="attr-input-readonly">readonly</code>,
<code title="attr-input-required">required</code>, and
<code title="attr-input-step">step</code> content attributes;
<code title="dom-input-list">list</code>,
<code title="dom-input-valueAsDate">valueAsDate</code>,
<code title="dom-input-valueAsNumber">valueAsNumber</code>,
<code title="dom-input-selectedOption">selectedOption</code>,
<code title="dom-input-stepUp">stepUp()</code>, and
<code title="dom-input-stepDown">stepDown()</code> DOM attributes.</p>

<p>The following content attributes must not be specified and do not
apply to the element:
<code class="no-backref" title="attr-input-accept">accept</code>,
<code class="no-backref" title="attr-input-alt">alt</code>,
<code class="no-backref" title="attr-input-checked">checked</code>,
<code class="no-backref" title="attr-input-maxlength">maxlength</code>,
<code class="no-backref" title="attr-input-pattern">pattern</code>,
<code class="no-backref" title="attr-input-size">size</code>,
<code class="no-backref" title="attr-input-src">src</code>,
<code class="no-backref" title="attr-fs-target">target</code>,
<code class="no-backref" title="attr-fs-method">method</code>,
<code class="no-backref" title="attr-fs-enctype">enctype</code>, and
<code class="no-backref" title="attr-fs-action">action</code>.</p>

<p>The
<code class="no-backref" title="dom-input-checked">checked</code>
DOM attribute does not apply to the element.</p>



0 comments on commit a4b76ea

Please sign in to comment.
You can’t perform that action at this time.