- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 04 Sep 2008 22:30:48 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv26333
Modified Files:
Overview.html
Log Message:
WF2: <textarea> element summary. (whatwg r2153)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1325
retrieving revision 1.1326
diff -u -d -r1.1325 -r1.1326
--- Overview.html 4 Sep 2008 11:22:58 -0000 1.1325
+++ Overview.html 4 Sep 2008 22:30:46 -0000 1.1326
@@ -7543,9 +7543,10 @@
<code><a href="#meta0">meta</a></code>, <code><a
href="#object">object</a></code>,<!-- param?
XXX--> <code><a
- href="#select">select</a></code>, and <code>textarea</code> elements in
- that document that have a <code title="">name</code> attribute whose value
- is equal to the <var title="">name</var> argument (in a <a
+ href="#select">select</a></code>, and <code><a
+ href="#textarea">textarea</a></code> elements in that document that have a
+ <code title="">name</code> attribute whose value is equal to the <var
+ title="">name</var> argument (in a <a
href="#case-sensitive">case-sensitive</a> manner), in <a
href="#tree-order">tree order</a>.
@@ -26715,7 +26716,6 @@
readonly attribute <a href="#htmlcollection0">HTMLCollection</a> <span title=dom-input-labels>labels</span>;
- void <span title=dom-input-select>select</span>();
void <span title=dom-input-stepUp>stepUp</span>(in int n);
void <span title=dom-input-stepDown>stepDown</span>(in int n);
@@ -27039,8 +27039,90 @@
<code><a href="#option">option</a></code> element). ... argument
processing ...
- <h4 id=the-textarea><span class=secno>4.9.10 </span>The
- <code>textarea</code> element</h4>
+ <h4 id=the-textarea><span class=secno>4.9.10 </span>The <dfn
+ id=textarea><code>textarea</code></dfn> element</h4>
+
+ <dl class=element>
+ <dt>Categories
+
+ <dd><a href="#phrasing0">Phrasing content</a>.
+
+ <dd><a href="#interactive1">Interactive content</a>.
+
+ <dt>Contexts in which this element may be used:
+
+ <dd>Where <a href="#phrasing0">phrasing content</a> is expected.
+
+ <dt>Content model:
+
+ <dd>Text.
+
+ <dt>Element-specific attributes:
+
+ <dd><code title=attr-textarea-accept>accept</code>
+
+ <dd><code title=attr-textarea-autofocus>autofocus</code>
+
+ <dd><code title=attr-textarea-cols>cols</code>
+
+ <dd><code title=attr-textarea-disabled>disabled</code>
+
+ <dd><code title=attr-textarea-form>form</code>
+
+ <dd><code title=attr-textarea-inputmode>inputmode</code>
+
+ <dd><code title=attr-textarea-maxlength>maxlength</code>
+
+ <dd><code title=attr-textarea-name>name</code>
+
+ <dd><code title=attr-textarea-pattern>pattern</code>
+
+ <dd><code title=attr-textarea-readonly>readonly</code>
+
+ <dd><code title=attr-textarea-required>required</code>
+
+ <dd><code title=attr-textarea-rows>rows</code>
+
+ <dd><code title=attr-textarea-wrap>wrap</code>
+
+ <dt>DOM interface:
+
+ <dd>
+ <pre
+ class=idl>interface <dfn id=htmltextareaelement>HTMLTextAreaElement</dfn> : <a href="#htmlelement">HTMLElement</a> {
+ attribute DOMString <span title=dom-textarea-accept>accept</span>;
+ attribute boolean <span title=dom-textarea-autofocus>autofocus</span>;
+ attribute unsigned long <span title=dom-textarea-cols>cols</span>;
+ attribute boolean <span title=dom-textarea-disabled>disabled</span>;
+ readonly attribute <a href="#htmlformelement">HTMLFormElement</a> <span title=dom-textarea-form>form</span>;
+ attribute DOMString <span title=dom-textarea-inputmode>inputmode</span>;
+ attribute long <span title=dom-textarea-maxLength>maxLength</span>;
+ attribute DOMString <span title=dom-textarea-name>name</span>;
+ attribute DOMString <span title=dom-textarea-pattern>pattern</span>;
+ attribute boolean <span title=dom-textarea-readOnly>readOnly</span>;
+ attribute boolean <span title=dom-textarea-required>required</span>;
+ attribute unsigned long <span title=dom-textarea-rows>rows</span>;
+ attribute DOMString <span title=dom-textarea-wrap>wrap</span>;
+
+ readonly attribute DOMString <span title=dom-textarea-type>type</span>;
+ attribute DOMString <span title=dom-textarea-defaultValue>defaultValue</span>;
+ attribute DOMString <span title=dom-textarea-value>value</span>;
+
+ readonly attribute <a href="#htmlcollection0">HTMLCollection</a> <span title=dom-textarea-labels>labels</span>;
+
+ readonly attribute boolean <span title=dom-textarea-willValidate>willValidate</span>;
+ readonly attribute <span>ValidityState</span> <span title=dom-textarea-validity>validity</span>;
+ readonly attribute DOMString <span title=dom-textarea-validationMessage>validationMessage</span>;
+ boolean <span title=dom-textarea-checkValidatity>checkValidity</span>();
+ void <span title=dom-textarea-setCustomValidity>setCustomValidity</span>(in DOMString error);
+
+ void <span title=dom-textarea-dispatchChange>dispatchChange</span>();
+ void <span title=dom-textarea-dispatchFormChange>dispatchFormChange</span>();
+};</pre>
+ </dl>
+ <!-- XXX add selectionStart and company -->
+
+ <p class=big-issue>...
<h4 id=the-output><span class=secno>4.9.11 </span>The <code>output</code>
element</h4>
@@ -41093,7 +41175,8 @@
<p>Mostly for historical reasons, in addition to the <a
href="#browsing1">browsing context</a>'s <a href="#a-selection" title="the
- selection">selection</a>, each <code>textarea</code> and <code><a
+ selection">selection</a>, each <code><a
+ href="#textarea">textarea</a></code> and <code><a
href="#input0">input</a></code> element has an independent selection.
These are the <dfn id=text-field title="text field selection">text field
selections</dfn>.
@@ -41327,9 +41410,9 @@
<p class=big-issue>When we define HTMLTextAreaElement and HTMLInputElement
we will have to add the IDL given below to both of their IDLs.
- <p>The <code><a href="#input0">input</a></code> and <code>textarea</code>
- elements define four members in their DOM interfaces for handling their
- text selection:
+ <p>The <code><a href="#input0">input</a></code> and <code><a
+ href="#textarea">textarea</a></code> elements define four members in their
+ DOM interfaces for handling their text selection:
<pre
class=idl> void <a href="#select2" title="dom-textarea/input-select">select</a>();
@@ -41339,8 +41422,8 @@
<!-- XXX also add textLength? it seems to be widely used -->
<p>These methods and attributes expose and control the selection of
- <code><a href="#input0">input</a></code> and <code>textarea</code> text
- fields.
+ <code><a href="#input0">input</a></code> and <code><a
+ href="#textarea">textarea</a></code> text fields.
<p>The <dfn id=select2
title="dom-textarea/input-select"><code>select()</code></dfn> method must
@@ -41401,7 +41484,8 @@
<pre>var selectionText = control.value.substring(control.selectionStart, control.selectionEnd);</pre>
<p>...where <var title="">control</var> is the <code><a
- href="#input0">input</a></code> or <code>textarea</code> element.</p>
+ href="#input0">input</a></code> or <code><a
+ href="#textarea">textarea</a></code> element.</p>
</div>
<p>Characters with no visible rendering, such as U+200D ZERO WIDTH JOINER,
@@ -41683,11 +41767,12 @@
<code><a href="#option">option</a></code> elements' <code
title=dom-option-defaultSelected>defaultSelected</code> DOM attribute as
well as the <code title=dom-option-selected>selected</code> DOM
- attribute; for <code>textarea</code> elements this means updating the
- <code title=dom-textarea-defaultValue>defaultValue</code> DOM attribute
- as well as the <code title=dom-textarea-value>value</code> DOM
- attribute. (Updating the <code title="">default*</code> DOM attributes
- causes content attributes to be updated as well.)
+ attribute; for <code><a href="#textarea">textarea</a></code> elements
+ this means updating the <code
+ title=dom-textarea-defaultValue>defaultValue</code> DOM attribute as
+ well as the <code title=dom-textarea-value>value</code> DOM attribute.
+ (Updating the <code title="">default*</code> DOM attributes causes
+ content attributes to be updated as well.)
</dd>
<!-- XXX something about not supporting resizing? -->
</dl>
@@ -42574,8 +42659,8 @@
<dl class=switch>
<dt>If the <a href="#current2">current target element</a> is a text
- field (e.g. <code>textarea</code>, or an <code><a
- href="#input0">input</a></code> element with <code
+ field (e.g. <code><a href="#textarea">textarea</a></code>, or an
+ <code><a href="#input0">input</a></code> element with <code
title="">type="text"</code><!--XXX xref-->)
<dd>The user agent must insert the data associated with the
@@ -42610,8 +42695,8 @@
<dl class=switch>
<dt>If the <a href="#current2">current target element</a> is a text
- field (e.g. <code>textarea</code>, or an <code><a
- href="#input0">input</a></code> element with <code
+ field (e.g. <code><a href="#textarea">textarea</a></code>, or an
+ <code><a href="#input0">input</a></code> element with <code
title="">type="text"</code><!--XXX xref-->), and a <code
title=event-drop><a href="#drop">drop</a></code> event was fired in
the previous step, and the <a href="#current3">current drag
@@ -42622,8 +42707,8 @@
selection from the DOM.
<dt>If the <a href="#current2">current target element</a> is a text
- field (e.g. <code>textarea</code>, or an <code><a
- href="#input0">input</a></code> element with <code
+ field (e.g. <code><a href="#textarea">textarea</a></code>, or an
+ <code><a href="#input0">input</a></code> element with <code
title="">type="text"</code><!--XXX xref-->), and a <code
title=event-drop><a href="#drop">drop</a></code> event was fired in
the previous step, and the <a href="#current3">current drag
@@ -46008,7 +46093,8 @@
<dt>RCDATA elements
- <dd><code><a href="#title1">title</a></code>, <code>textarea</code>
+ <dd><code><a href="#title1">title</a></code>, <code><a
+ href="#textarea">textarea</a></code>
<dt>Foreign elements
@@ -46530,11 +46616,12 @@
<p>A single U+000A LINE FEED (LF) character may be placed immediately after
the <span title=syntax-start-tag>start tag</span> of <code><a
- href="#pre">pre</a></code> and <code>textarea</code> elements. This does
- not affect the processing of the element. The otherwise optional U+000A
- LINE FEED (LF) character <em>must</em> be included if the element's
- contents start with that character (because otherwise the leading newline
- in the contents would be treated like the optional newline, and ignored).
+ href="#pre">pre</a></code> and <code><a
+ href="#textarea">textarea</a></code> elements. This does not affect the
+ processing of the element. The otherwise optional U+000A LINE FEED (LF)
+ character <em>must</em> be included if the element's contents start with
+ that character (because otherwise the leading newline in the contents
+ would be treated like the optional newline, and ignored).
<div class=example>
<p>The following two <code><a href="#pre">pre</a></code> blocks are
@@ -47769,7 +47856,8 @@
<code><a href="#section">section</a></code>, <code><a
href="#select">select</a></code>, <code>spacer</code>, <code><a
href="#style1">style</a></code>, <code><a
- href="#tbody">tbody</a></code>, <code>textarea</code>, <code><a
+ href="#tbody">tbody</a></code>, <code><a
+ href="#textarea">textarea</a></code>, <code><a
href="#tfoot0">tfoot</a></code>, <code><a
href="#thead0">thead</a></code>, <code><a
href="#title1">title</a></code>, <code><a href="#tr">tr</a></code>,
@@ -51939,8 +52027,8 @@
<p>If the <a href="#form-element"><code title="">form</code> element
pointer</a> is not null, then <a href="#associated"
- title=concept-form-association>associate</a> the newly created
- <code>textarea</code> element with the <code><a
+ title=concept-form-association>associate</a> the newly created <code><a
+ href="#textarea">textarea</a></code> element with the <code><a
href="#form">form</a></code> element pointed to by the <a
href="#form-element"><code title="">form</code> element pointer</a>.</p>
@@ -51949,7 +52037,8 @@
<p>If the next token is a U+000A LINE FEED (LF) character token, then
ignore that token and move on to the next one. (Newlines at the start of
- <code>textarea</code> elements are ignored as an authoring convenience.)</p>
+ <code><a href="#textarea">textarea</a></code> elements are ignored as an
+ authoring convenience.)</p>
<p>Then, collect all the character tokens that the tokeniser returns
until it returns a token that is not a character token, or until it
@@ -53873,9 +53962,9 @@
<!-- XXX when we get around to it, add
eventsource -->
<p>If <var title="">current node</var> is a <code><a
- href="#pre">pre</a></code> <code>textarea</code>, or
- <code>listing</code> element, append a U+000A LINE FEED (LF)
- character.</p>
+ href="#pre">pre</a></code> <code><a
+ href="#textarea">textarea</a></code>, or <code>listing</code>
+ element, append a U+000A LINE FEED (LF) character.</p>
<p>Append the value of running the <a href="#html-fragment">HTML
fragment serialization algorithm</a> on the <var title="">current
@@ -53974,10 +54063,11 @@
<p class=note>It is possible that the output of this algorithm, if parsed
with an <a href="#html-0">HTML parser</a>, will not return the original
- tree structure. For instance, if a <code>textarea</code> element to which
- a <code title="">Comment</code> node has been appended is serialized and
- the output is then reparsed, the comment will end up being displayed in
- the text field. Similarly, if, as a result of DOM manipulation, an element
+ tree structure. For instance, if a <code><a
+ href="#textarea">textarea</a></code> element to which a <code
+ title="">Comment</code> node has been appended is serialized and the
+ output is then reparsed, the comment will end up being displayed in the
+ text field. Similarly, if, as a result of DOM manipulation, an element
contains a comment that contains the literal string "<code
title="">--></code>", then when the result of serializing the element
is parsed, the comment will be truncated at that point and the rest of the
@@ -54023,8 +54113,8 @@
title="">context</var> element, as follows:</p>
<dl class=switch>
- <dt>If it is a <code><a href="#title1">title</a></code> or
- <code>textarea</code> element
+ <dt>If it is a <code><a href="#title1">title</a></code> or <code><a
+ href="#textarea">textarea</a></code> element
<dd>Set the <a href="#content4">content model flag</a> to the RCDATA
state.
Received on Thursday, 4 September 2008 22:31:22 UTC