- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 03 Nov 2011 17:10:45 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv18360
Modified Files:
Overview.html
Log Message:
compat changes for <textarea>.value and .textLength (whatwg r6815)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.5449
retrieving revision 1.5450
diff -u -d -r1.5449 -r1.5450
--- Overview.html 2 Nov 2011 20:40:26 -0000 1.5449
+++ Overview.html 3 Nov 2011 17:10:41 -0000 1.5450
@@ -320,7 +320,7 @@
<h1>HTML5</h1>
<h2 class="no-num no-toc" id="a-vocabulary-and-associated-apis-for-html-and-xhtml">A vocabulary and associated APIs for HTML and XHTML</h2>
- <h2 class="no-num no-toc" id="editor-s-draft-2-november-2011">Editor's Draft 2 November 2011</h2>
+ <h2 class="no-num no-toc" id="editor-s-draft-3-november-2011">Editor's Draft 3 November 2011</h2>
<dl><dt>Latest Published Version:</dt>
<dd><a href="http://www.w3.org/TR/html5/">http://www.w3.org/TR/html5/</a></dd>
<dt>Latest Editor's Draft:</dt>
@@ -466,7 +466,7 @@
Group</a> is the W3C working group responsible for this
specification's progress along the W3C Recommendation
track.
- This specification is the 2 November 2011 Editor's Draft.
+ This specification is the 3 November 2011 Editor's Draft.
</p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><p>Work on this specification is also done at the <a href="http://www.whatwg.org/">WHATWG</a>. The W3C HTML working group
actively pursues convergence with the WHATWG, as required by the <a href="http://www.w3.org/2007/03/HTML-WG-charter">W3C HTML working
group charter</a>.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><p>This document was produced by a group operating under the <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5
@@ -37961,7 +37961,29 @@
attribute is in the <a href="#attr-textarea-wrap-hard-state" title="attr-textarea-wrap-hard-state">Hard</a> state, the <code title="attr-textarea-cols"><a href="#attr-textarea-cols">cols</a></code> attribute must be
specified.</p><div class="impl">
- <p>The element's <a href="#concept-fe-value" title="concept-fe-value">value</a> is
+ <p>For historical reasons, the element's value is normalised in
+ three different ways for three different purposes. The <a href="#concept-textarea-raw-value" title="concept-textarea-raw-value">raw value</a> is the value as
+ it was originally set. It is not normalized. The <a href="#concept-textarea-api-value" title="concept-textarea-api-value">API value</a> is the value
+ used in the <code title="dom-textarea-value"><a href="#dom-textarea-value">value</a></code> IDL
+ attribute. It is normalized so that line breaks use U+000A LINE FEED
+ (LF) characters. Finally, there is the form submission <a href="#concept-fe-value" title="concept-fe-value">value</a>. It is normalized so that line
+ breaks use U+000D CARRIAGE RETURN U+000A LINE FEED (CRLF) character
+ pairs, and in addition, if necessary given the element's <code title="attr-textarea-wrap"><a href="#attr-textarea-wrap">wrap</a></code> attribute, additional line
+ breaks are inserted to wrap the text at the given width.</p>
+
+ <p>The element's <dfn id="concept-textarea-api-value" title="concept-textarea-api-value">API
+ value</dfn> is defined to be the element's <a href="#concept-textarea-raw-value" title="concept-textarea-raw-value">raw value</a> with the
+ following transformation applied:</p>
+
+ <ol><li><p>Replace every U+000D CARRIAGE RETURN U+000A LINE FEED (CRLF)
+ character pair from the <a href="#concept-textarea-raw-value" title="concept-textarea-raw-value">raw value</a> with a single
+ U+000A LINE FEED (CRLF) character.</li>
+
+ <li><p>Replace every remaining U+000D CARRIAGE RETURN character from
+ the <a href="#concept-textarea-raw-value" title="concept-textarea-raw-value">raw value</a> with
+ a single U+000A LINE FEED (CRLF) character.</li>
+
+ </ol><p>The element's <a href="#concept-fe-value" title="concept-fe-value">value</a> is
defined to be the element's <a href="#concept-textarea-raw-value" title="concept-textarea-raw-value">raw value</a> with the
following transformation applied:</p>
@@ -38062,7 +38084,7 @@
IDL attribute.</p>
<p>The <dfn id="dom-textarea-value" title="dom-textarea-value"><code>value</code></dfn>
- attribute must, on getting, return the element's <a href="#concept-textarea-raw-value" title="concept-textarea-raw-value">raw value</a>; on setting, it
+ attribute must, on getting, return the element's <a href="#concept-textarea-api-value" title="concept-textarea-api-value">API value</a>; on setting, it
must set the element's <a href="#concept-textarea-raw-value" title="concept-textarea-raw-value">raw
value</a> to the new value, set the element's <a href="#concept-textarea-dirty" title="concept-textarea-dirty">dirty value flag</a> to true, and
should then move the text entry cursor position to the end of the
@@ -38071,7 +38093,8 @@
<p>The <dfn id="dom-textarea-textlength" title="dom-textarea-textLength"><code>textLength</code></dfn> IDL
attribute must return the <a href="#code-point-length">code-point length</a> of the
- element's <a href="#concept-fe-value" title="concept-fe-value">value</a>.</p>
+ element's <a href="#concept-textarea-api-value" title="concept-textarea-api-value">API
+ value</a>.</p>
<p>The <code title="dom-cva-willValidate"><a href="#dom-cva-willvalidate">willValidate</a></code>, <code title="dom-cva-validity"><a href="#dom-cva-validity">validity</a></code>, and <code title="dom-cva-validationMessage"><a href="#dom-cva-validationmessage">validationMessage</a></code>
attributes, and the <code title="dom-cva-checkValidatity"><a href="#dom-cva-checkvalidatity">checkValidity()</a></code> and <code title="dom-cva-setCustomValidity"><a href="#dom-cva-setcustomvalidity">setCustomValidity()</a></code>
Received on Thursday, 3 November 2011 17:12:53 UTC