W3C home > Mailing lists > Public > public-html-diffs@w3.org > November 2011

hixie: compat changes for <textarea>.value and .textLength (whatwg r6815)

From: poot <cvsmail@w3.org>
Date: Thu, 03 Nov 2011 13:13:00 -0400
To: public-html-diffs@w3.org
Message-Id: <E1RM0qa-0004Be-5a@jay.w3.org>
hixie: compat changes for <textarea>.value and .textLength (whatwg
r6815)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.5449&r2=1.5450&f=h
http://html5.org/tools/web-apps-tracker?from=6814&to=6815

===================================================================
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:13:04 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 3 November 2011 17:13:04 GMT