HTML Standard Tracker


File a bug

SVNBugCommentTime (UTC)
2305WF2: editing a <textarea>.2008-10-08 23:57
@@ -30057,43 +30057,70 @@ interface <dfn>HTMLOptionElement</dfn> : <span>HTMLElement</span> {
   readonly attribute <span>NodeList</span> <span title="dom-lfe-labels">labels</span>;
   <!-- XXX add selectionStart and company -->
   <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 class="XXX"> ... <dfn title="attr-textarea-cols"><code>cols</code></dfn>
-  <p class="XXX"> ... <dfn title="attr-textarea-rows"><code>rows</code></dfn>
+  <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 class="XXX"> ... <dfn title="attr-textarea-wrap"><code>wrap</code></dfn>
+  <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 class="XXX"> ... <dfn title="attr-textarea-maxlength"><code>maxlength</code></dfn>
-  <p class="XXX"> ... <dfn title="attr-textarea-required"><code>required</code></dfn>
+  <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>
+  <p class="XXX"> ... <dfn title="attr-textarea-wrap"><code>wrap</code></dfn>
+  <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 class="XXX"> ... <dfn title="attr-textarea-accept"><code>accept</code></dfn>
   <p>The <code title="attr-fae-form">form</code> attribute is used to
   explicitly associate the <code>textarea</code> element with its
   <span>form owner</span>. The <code title="attr-fe-name">name</code>
   attribute represents the element's name. The <code
   title="attr-fe-disabled">disabled</code> attribute is used to make
   the control non-interactive and to prevent its value from being
   submitted. The <code title="attr-fe-autofocus">autofocus</code>
   attribute controls focus.</p>