HTML5 Tracker

Short URL: http://html5.org/r/2305

Index: source
===================================================================
--- source	(revision 2304)
+++ source	(revision 2305)
@@ -30064,16 +30064,48 @@
 
   <p>The <code>textarea</code> element represents a multiline plain
   text edit control for the element's <span
-  title="concept-fe-value">value</span>.</p>
+  title="concept-fe-value">value</span>. The contents of the control
+  represent the control's default value.</p>
 
-  <p class="XXX"> ... <dfn title="attr-textarea-readonly"><code>readonly</code></dfn>
-  <p class="XXX"> ... <dfn title="concept-textarea-mutable">mutable</dfn></p> <!-- !disabled && !readonly -->
+  <p>The <dfn
+  title="attr-textarea-readonly"><code>readonly</code></dfn> attribute
+  is a <span>boolean attribute</span> used to control whether the text
+  can be edited by the user or not.</p>
 
   <p><strong>Constraint validation:</strong> If the <code
   title="attr-textarea-readonly">readonly</code> attribute is
   specified on a <code>textarea</code> element, the element is
   <span>barred from constraint validation</span>.</p>
 
+  <p>A <code>textarea</code> element is <dfn
+  title="concept-textarea-mutable">mutable</dfn> if it is neither
+  <span title="concept-fe-disabled">disabled</span> nor has a <code
+  title="attr-textarea-readonly">readonly</code> attribute
+  specified.</p>
+
+  <p>When a <code>textarea</code> is <span
+  title="concept-textarea-mutable">mutable</span>, its <span
+  title="concept-fe-value">value</span> should be editable by the
+  user.</p>
+
+  <p>A <code>textarea</code> element has a <dfn
+  title="concept-textarea-dirty">dirty value flag</dfn>, which must be
+  initially set to false, and must be set to true whenever the user
+  interacts with the control in a way that changes the <span
+  title="concept-fe-value">value</span>.</p>
+
+  <p>When the <code>textarea</code> element's <code>textContent</code>
+  DOM attribute changes value, if the element's <span
+  title="concept-textarea-dirty">dirty value flag</span> is false,
+  then the element's <span title="concept-fe-value">value</span> must
+  be set to the value of the element's <code>textContent</code> DOM
+  attribute.</p>
+
+  <p>The <span title="concept-form-reset-control">reset
+  algorithm</span> for <code>textarea</code> elements is to set the
+  element's <span title="concept-fe-value">value</span> to the value
+  of the element's <code>textContent</code> DOM attribute.</p>
+
   <p class="XXX"> ... <dfn title="attr-textarea-cols"><code>cols</code></dfn>
   <p class="XXX"> ... <dfn title="attr-textarea-rows"><code>rows</code></dfn>
 
@@ -30082,11 +30114,6 @@
   <p class="XXX"> ... <dfn title="attr-textarea-maxlength"><code>maxlength</code></dfn>
   <p class="XXX"> ... <dfn title="attr-textarea-required"><code>required</code></dfn>
 
-  <p>The <span title="concept-form-reset-control">reset
-  algorithm</span> for <code>textarea</code> elements is to set the
-  element's <span title="concept-fe-value">value</span> to the value
-  of the element's <code>textContent</code> DOM attribute.</p>
-
   <p class="XXX"> ... <dfn title="attr-textarea-accept"><code>accept</code></dfn>
 
   <p>The <code title="attr-fae-form">form</code> attribute is used to

Previous | Next