- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 18 Sep 2008 03:18:23 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv21605
Modified Files:
Overview.html
Log Message:
WF2: Define input.value, especially for type=text; and related tweaks to make things read better. (whatwg r2213)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1385
retrieving revision 1.1386
diff -u -d -r1.1385 -r1.1386
--- Overview.html 18 Sep 2008 00:42:11 -0000 1.1385
+++ Overview.html 18 Sep 2008 03:18:20 -0000 1.1386
@@ -28613,7 +28613,7 @@
state must be invoked.
<p>Each <code><a href="#input0">input</a></code> element has a <a
- href="#value11" title=concept-fe-value>value</a>, which is exposed by the
+ href="#value12" title=concept-fe-value>value</a>, which is exposed by the
<code title=dom-input-value><a href="#value9">value</a></code> DOM
attribute.
@@ -28624,7 +28624,11 @@
element is <dfn id=immutable
title=concept-input-immutable><i>immutable</i></dfn>. Unless otherwise
specified, an <code><a href="#input0">input</a></code> element is always
- <i title=concept-input-mutable><a href="#mutable">mutable</a></i>.
+ <i title=concept-input-mutable><a href="#mutable">mutable</a></i>. When an
+ <code><a href="#input0">input</a></code> element is <i
+ title=concept-input-immutable><a href="#immutable">immutable</a></i>, the
+ user agent should not allow the user to modify the <a href="#value12"
+ title=concept-fe-value>value</a>.
<p>When an <code><a href="#input0">input</a></code> element is <a
href="#disabled4" title=concept-fe-disabled>disabled</a>, it is <i
@@ -28644,10 +28648,10 @@
href="#dirty0">dirty</a></i>) when the element is created, and must be set
to true (<i title=concept-input-dirty><a href="#dirty0">dirty</a></i>)
whenever the user interacts with the control in a way that changes the <a
- href="#value11" title=concept-fe-value>value</a>.
+ href="#value12" title=concept-fe-value>value</a>.
<p>The <dfn id=value8 title=attr-input-value><code>value</code></dfn>
- content attribute gives the default <a href="#value11"
+ content attribute gives the default <a href="#value12"
title=concept-fe-value>value</a> of the <code><a
href="#input0">input</a></code> element. When the <code
title=attr-input-value><a href="#value8">value</a></code> content
@@ -28733,7 +28737,18 @@
<p>When an <code><a href="#input0">input</a></code> element's <code
title=attr-input-type><a href="#type12">type</a></code> attribute is in
the <a href="#text2" title=attr-input-type-text>Text</a> state, the
- element represents a text edit control for a single line of plain text.
+ element represents a one line plain text edit control for the element's <a
+ href="#value12" title=concept-fe-value>value</a>.
+
+ <p>If an <code><a href="#input0">input</a></code> element whose <code
+ title=attr-input-type><a href="#type12">type</a></code> attribute is in
+ the <a href="#text2" title=attr-input-type-text>Text</a> state is <i
+ title=concept-input-mutable><a href="#mutable">mutable</a></i>, its <a
+ href="#value12" title=concept-fe-value>value</a> should be editable by the
+ user. User agents must not allow users to insert U+000A LINE FEED (LF) or
+ U+000D CARRIAGE RETURN (CR) characters into the <a href="#value12"
+ title=concept-fe-value>value</a> of such <code><a
+ href="#input0">input</a></code> elements.
<p><strong>The <a href="#text2" title=attr-input-type-text>Text</a> state's
<a href="#control0">control initialization algorithm</a> is as
@@ -28744,20 +28759,15 @@
<a href="#default2">default value change algorithm</a> is as
follows:</strong> If the <code><a href="#input0">input</a></code> element
is not <i title=concept-input-dirty><a href="#dirty0">dirty</a></i> then
- set the <a href="#value11" title=concept-fe-value>value</a> of the element
+ set the <a href="#value12" title=concept-fe-value>value</a> of the element
to the value of the <code title=attr-input-value><a
href="#value8">value</a></code> content attribute and <a
href="#strip">strip line breaks from the value</a>.
- <p>If an <code><a href="#input0">input</a></code> element whose <code
- title=attr-input-type><a href="#type12">type</a></code> attribute is in
- the <a href="#text2" title=attr-input-type-text>Text</a> state is <i
- title=concept-input-mutable><a href="#mutable">mutable</a></i>, its <a
- href="#value11" title=concept-fe-value>value</a> should be editable by the
- user. User agents must not allow users to insert U+000A LINE FEED (LF) or
- U+000D CARRIAGE RETURN (CR) characters into the <a href="#value11"
- title=concept-fe-value>value</a> of such <code><a
- href="#input0">input</a></code> elements.
+ <p><strong>The <a href="#value10"><code title=dom-input-value>value</code>
+ setter algorithm</a> is as follows:</strong> Set the <a href="#value12"
+ title=concept-fe-value>value</a> of the element to the new value and <a
+ href="#strip">strip line breaks from the value</a>.
<p>When an <code><a href="#input0">input</a></code> element's <code
title=attr-input-type><a href="#type12">type</a></code> attribute is in
@@ -29020,7 +29030,7 @@
<p>When a user agent is to <dfn id=strip>strip line breaks from the
value</dfn>, the user agent must remove any U+000A LINE FEED (LF) and
- U+000D CARRIAGE RETURN (CR) characters from <a href="#value11"
+ U+000D CARRIAGE RETURN (CR) characters from <a href="#value12"
title=concept-fe-value>value</a>.
<h5 id=common4><span class=secno>4.9.4.2. </span>Common <code><a
@@ -29100,8 +29110,15 @@
<h6 id=value><span class=secno>4.9.4.3.1. </span>Value manipulation</h6>
- <p class=big-issue>... <dfn id=value9
- title=dom-input-value><code>value</code></dfn>
+ <p>The <dfn id=value9 title=dom-input-value><code>value</code></dfn> DOM
+ attribute allows secripts to manipulate the <span
+ title=concept-input-value>value</span> of an <code><a
+ href="#input0">input</a></code> element. On getting, it must return the
+ current <span title=concept-input-value>value</span> of the element. On
+ setting, it must run the <dfn id=value10><code
+ title=dom-input-value>value</code> setter algorithm</dfn> defined for the
+ element's <code title=attr-input-type><a href="#type12">type</a></code>
+ attribute's current state.
<hr>
@@ -29482,7 +29499,7 @@
<p class=big-issue>... <dfn id=selected1
title=concept-option-selected>selected</dfn>
- <p class=big-issue>... <dfn id=value10
+ <p class=big-issue>... <dfn id=value11
title=concept-option-value>value</dfn>
<p class=big-issue> <dfn id=option0
@@ -29791,7 +29808,7 @@
<p class=big-issue>... <dfn id=disabled6
title=dom-fe-disabled>disabled</dfn> DOM attribute
- <p class=big-issue>... <dfn id=value11 title=concept-fe-value>value</dfn></p>
+ <p class=big-issue>... <dfn id=value12 title=concept-fe-value>value</dfn></p>
<!-- XXX autocomplete: define somewhere that the value may be set from a stored value -->
<h4 id=attributes2><span class=secno>4.9.14 </span><dfn
@@ -30138,7 +30155,7 @@
href="#select">select</a></code> element that is <a href="#selected1"
title=concept-option-selected>selected</a>, append an entry in the
<var title="">form data set</var> with the <var title="">name</var> as
- the name and the <a href="#value10"
+ the name and the <a href="#value11"
title=concept-option-value>value</a> of the <code><a
href="#option">option</a></code> element as the value.
@@ -30156,7 +30173,7 @@
<li>
<p>Otherwise, append an entry in the <var title="">form data set</var>
- with <var title="">name</var> as the name and the <a href="#value11"
+ with <var title="">name</var> as the name and the <a href="#value12"
title=concept-fe-value>value</a> of the <var title="">field</var>
element as the value.
</ol>
Received on Thursday, 18 September 2008 03:18:57 UTC