[html5] r2305 - [] (0) WF2: editing a <textarea>.

whatwg at whatwg.org whatwg at whatwg.org
Wed Oct 8 16:57:08 PDT 2008


Author: ianh
Date: 2008-10-08 16:57:07 -0700 (Wed, 08 Oct 2008)
New Revision: 2305

Modified:
   index
   source
Log:
[] (0) WF2: editing a <textarea>.

Modified: index
===================================================================
--- index	2008-10-08 07:58:16 UTC (rev 2304)
+++ index	2008-10-08 23:57:07 UTC (rev 2305)
@@ -26810,15 +26810,39 @@
 };</pre>
    </dd> 
   </dl><!-- XXX add selectionStart and company --><p>The <code><a href=#the-textarea-element>textarea</a></code> element represents a multiline plain
-  text edit control for the element's <a href=#concept-fe-value title=concept-fe-value>value</a>.</p>
+  text edit control for the element's <a href=#concept-fe-value title=concept-fe-value>value</a>. The contents of the control
+  represent the control's default value.</p>
 
-  <p class=XXX> ... <dfn id=attr-textarea-readonly title=attr-textarea-readonly><code>readonly</code></dfn>
-  <p class=XXX> ... <dfn id=concept-textarea-mutable title=concept-textarea-mutable>mutable</dfn></p> <!-- !disabled && !readonly -->
+  <p>The <dfn id=attr-textarea-readonly title=attr-textarea-readonly><code>readonly</code></dfn> attribute
+  is a <a href=#boolean-attribute>boolean attribute</a> 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><a href=#attr-textarea-readonly>readonly</a></code> attribute is
   specified on a <code><a href=#the-textarea-element>textarea</a></code> element, the element is
   <a href=#barred-from-constraint-validation>barred from constraint validation</a>.</p>
 
+  <p>A <code><a href=#the-textarea-element>textarea</a></code> element is <dfn id=concept-textarea-mutable title=concept-textarea-mutable>mutable</dfn> if it is neither
+  <a href=#concept-fe-disabled title=concept-fe-disabled>disabled</a> nor has a <code title=attr-textarea-readonly><a href=#attr-textarea-readonly>readonly</a></code> attribute
+  specified.</p>
+
+  <p>When a <code><a href=#the-textarea-element>textarea</a></code> is <a href=#concept-textarea-mutable title=concept-textarea-mutable>mutable</a>, its <a href=#concept-fe-value title=concept-fe-value>value</a> should be editable by the
+  user.</p>
+
+  <p>A <code><a href=#the-textarea-element>textarea</a></code> element has a <dfn id=concept-textarea-dirty 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 <a href=#concept-fe-value title=concept-fe-value>value</a>.</p>
+
+  <p>When the <code><a href=#the-textarea-element>textarea</a></code> element's <code><a href=#textcontent>textContent</a></code>
+  DOM attribute changes value, if the element's <a href=#concept-textarea-dirty title=concept-textarea-dirty>dirty value flag</a> is false,
+  then the element's <a href=#concept-fe-value title=concept-fe-value>value</a> must
+  be set to the value of the element's <code><a href=#textcontent>textContent</a></code> DOM
+  attribute.</p>
+
+  <p>The <a href=#concept-form-reset-control title=concept-form-reset-control>reset
+  algorithm</a> for <code><a href=#the-textarea-element>textarea</a></code> elements is to set the
+  element's <a href=#concept-fe-value title=concept-fe-value>value</a> to the value
+  of the element's <code><a href=#textcontent>textContent</a></code> DOM attribute.</p>
+
   <p class=XXX> ... <dfn id=attr-textarea-cols title=attr-textarea-cols><code>cols</code></dfn>
   <p class=XXX> ... <dfn id=attr-textarea-rows title=attr-textarea-rows><code>rows</code></dfn>
 
@@ -26827,11 +26851,6 @@
   <p class=XXX> ... <dfn id=attr-textarea-maxlength title=attr-textarea-maxlength><code>maxlength</code></dfn>
   <p class=XXX> ... <dfn id=attr-textarea-required title=attr-textarea-required><code>required</code></dfn>
 
-  <p>The <a href=#concept-form-reset-control title=concept-form-reset-control>reset
-  algorithm</a> for <code><a href=#the-textarea-element>textarea</a></code> elements is to set the
-  element's <a href=#concept-fe-value title=concept-fe-value>value</a> to the value
-  of the element's <code><a href=#textcontent>textContent</a></code> DOM attribute.</p>
-
   <p class=XXX> ... <dfn id=attr-textarea-accept title=attr-textarea-accept><code>accept</code></dfn>
 
   <p>The <code title=attr-fae-form><a href=#attr-fae-form>form</a></code> attribute is used to

Modified: source
===================================================================
--- source	2008-10-08 07:58:16 UTC (rev 2304)
+++ source	2008-10-08 23:57:07 UTC (rev 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




More information about the Commit-Watchers mailing list