- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 30 Sep 2008 21:21:47 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv30166
Modified Files:
Overview.html
Log Message:
WF2: <input type=time> (whatwg r2253)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1425
retrieving revision 1.1426
diff -u -d -r1.1425 -r1.1426
--- Overview.html 30 Sep 2008 10:56:49 -0000 1.1425
+++ Overview.html 30 Sep 2008 21:21:45 -0000 1.1426
@@ -30646,7 +30646,123 @@
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>
Received on Tuesday, 30 September 2008 21:22:26 UTC