[html5] r2253 - [] (0) WF2: <input type=time>
whatwg at whatwg.org
whatwg at whatwg.org
Tue Sep 30 14:21:36 PDT 2008
Author: ianh
Date: 2008-09-30 14:21:33 -0700 (Tue, 30 Sep 2008)
New Revision: 2253
Modified:
index
source
Log:
[] (0) WF2: <input type=time>
Modified: index
===================================================================
--- index 2008-09-30 10:56:41 UTC (rev 2252)
+++ index 2008-09-30 21:21:33 UTC (rev 2253)
@@ -30639,8 +30639,124 @@
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>
Modified: source
===================================================================
--- source 2008-09-30 10:56:41 UTC (rev 2252)
+++ source 2008-09-30 21:21:33 UTC (rev 2253)
@@ -27104,10 +27104,120 @@
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>
+
+
+
<h6><dfn title="attr-input-type-datetime-local">Local Date and Time</dfn> state</h6>
<p>When an <code>input</code> element's <code
More information about the Commit-Watchers
mailing list