Skip to content

Commit

Permalink
[] (0) WF2: <textarea> element summary.
Browse files Browse the repository at this point in the history 
git-svn-id: http://svn.whatwg.org/webapps@2153 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
@Hixie
Hixie committed Sep 4, 2008
1 parent bf9bca6 commit b8e5126
Show file tree
Hide file tree
Showing 2 changed files with 196 additions and 45 deletions.
176 changes: 133 additions & 43 deletions index
View file
Expand Up @@ -7535,9 +7535,10 @@ http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C%21DOCTYPE%20html%3E..
<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>.

Expand Down Expand Up @@ -26707,7 +26708,6 @@ function AddCloud(data, x, y) { ... }</pre>

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);

Expand Down Expand Up @@ -27031,8 +27031,90 @@ interface <dfn id=htmloptionelement>HTMLOptionElement</dfn> : <a href="#htmlelem
<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>
Expand Down Expand Up @@ -41085,7 +41167,8 @@ onActivate, onBeforeDeactivate, onDeactivate, document.hasFocus):

<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>.
Expand Down Expand Up @@ -41319,9 +41402,9 @@ onActivate, onBeforeDeactivate, onDeactivate, document.hasFocus):
<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>();
Expand All @@ -41331,8 +41414,8 @@ onActivate, onBeforeDeactivate, onDeactivate, document.hasFocus):
<!-- 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
Expand Down Expand Up @@ -41393,7 +41476,8 @@ onActivate, onBeforeDeactivate, onDeactivate, document.hasFocus):
<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,
Expand Down Expand Up @@ -41675,11 +41759,12 @@ onActivate, onBeforeDeactivate, onDeactivate, document.hasFocus):
<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>
Expand Down Expand Up @@ -42566,8 +42651,8 @@ http://developer.apple.com/documentation/AppleApplications/Conceptual/SafariJSPr

<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
Expand Down Expand Up @@ -42602,8 +42687,8 @@ http://developer.apple.com/documentation/AppleApplications/Conceptual/SafariJSPr

<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
Expand All @@ -42614,8 +42699,8 @@ http://developer.apple.com/documentation/AppleApplications/Conceptual/SafariJSPr
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
Expand Down Expand Up @@ -46000,7 +46085,8 @@ interface <dfn id=messagechannel>MessageChannel</dfn> {

<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

Expand Down Expand Up @@ -46522,11 +46608,12 @@ interface <dfn id=messagechannel>MessageChannel</dfn> {

<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
Expand Down Expand Up @@ -47761,7 +47848,8 @@ interface <dfn id=messagechannel>MessageChannel</dfn> {
<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>,
Expand Down Expand Up @@ -51931,8 +52019,8 @@ interface <dfn id=messagechannel>MessageChannel</dfn> {

<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>

Expand All @@ -51941,7 +52029,8 @@ interface <dfn id=messagechannel>MessageChannel</dfn> {

<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
Expand Down Expand Up @@ -53865,9 +53954,9 @@ http://lxr.mozilla.org/seamonkey/search?string=nested
<!-- 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
Expand Down Expand Up @@ -53966,10 +54055,11 @@ http://lxr.mozilla.org/seamonkey/search?string=nested

<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="">--&gt;</code>", then when the result of serializing the element
is parsed, the comment will be truncated at that point and the rest of the
Expand Down Expand Up @@ -54015,8 +54105,8 @@ http://lxr.mozilla.org/seamonkey/search?string=nested
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.
Expand Down
65 changes: 63 additions & 2 deletions source
View file
Expand Up @@ -24031,7 +24031,6 @@ function AddCloud(data, x, y) { ... }</pre>

readonly attribute <span>HTMLCollection</span> <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);

Expand Down Expand Up @@ -24277,7 +24276,69 @@ interface <dfn>HTMLOptionElement</dfn> : <span>HTMLElement</span> {
</p>


<h4>The <code>textarea</code> element</h4>
<h4>The <dfn><code>textarea</code></dfn> element</h4>

<dl class="element">
<dt>Categories</dt>
<dd><span>Phrasing content</span>.</dd>
<dd><span>Interactive content</span>.</dd>
<dt>Contexts in which this element may be used:</dt>
<dd>Where <span>phrasing content</span> is expected.</dd>
<dt>Content model:</dt>
<dd>Text.</dd>
<dt>Element-specific attributes:</dt>
<dd><code title="attr-textarea-accept">accept</code></dd>
<dd><code title="attr-textarea-autofocus">autofocus</code></dd>
<dd><code title="attr-textarea-cols">cols</code></dd>
<dd><code title="attr-textarea-disabled">disabled</code></dd>
<dd><code title="attr-textarea-form">form</code></dd>
<dd><code title="attr-textarea-inputmode">inputmode</code></dd>
<dd><code title="attr-textarea-maxlength">maxlength</code></dd>
<dd><code title="attr-textarea-name">name</code></dd>
<dd><code title="attr-textarea-pattern">pattern</code></dd>
<dd><code title="attr-textarea-readonly">readonly</code></dd>
<dd><code title="attr-textarea-required">required</code></dd>
<dd><code title="attr-textarea-rows">rows</code></dd>
<dd><code title="attr-textarea-wrap">wrap</code></dd>
<dt>DOM interface:</dt>
<dd>
<pre class="idl">interface <dfn>HTMLTextAreaElement</dfn> : <span>HTMLElement</span> {
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 <span>HTMLFormElement</span> <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 <span>HTMLCollection</span> <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>
</dd>
</dl>

<!-- XXX add selectionStart and company -->

<p class="big-issue">...</p>


<h4>The <code>output</code> element</h4>

Expand Down

0 comments on commit b8e5126

Please sign in to comment.