Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
[] (0) Add placeholder= for <textarea>.
git-svn-id: http://svn.whatwg.org/webapps@2921 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
Hixie committed Mar 30, 2009
1 parent 7c6abac commit 5e7187b
Show file tree
Hide file tree
Showing 2 changed files with 69 additions and 7 deletions.
38 changes: 34 additions & 4 deletions index
Expand Up @@ -39,7 +39,7 @@
<div class=head>
<p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG src=/images/logo></a></p>
<h1>HTML 5</h1>
<h2 class="no-num no-toc" id=draft-recommendation-&mdash;-date:-01-jan-1901>Draft Recommendation &mdash; 28 March 2009</h2>
<h2 class="no-num no-toc" id=draft-recommendation-&mdash;-date:-01-jan-1901>Draft Recommendation &mdash; 30 March 2009</h2>
<p>You can take part in this work. <a href=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
<p><strong>Web designers!</strong> We have a <a href=http://blog.whatwg.org/faq/>FAQ</a>, a <a href=http://forums.whatwg.org/>forum</a>, and a <a href=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
<dl><dt>Multiple-page version:</dt>
Expand Down Expand Up @@ -31941,6 +31941,8 @@ You cannot complete this form until the field is correct.</samp></pre>

<h6 id=the-placeholder-attribute><span class=secno>4.10.4.2.11 </span>The <code title=attr-input-placeholder><a href=#attr-input-placeholder>placeholder</a></code> attribute</h6>

<!-- similar text in the <textarea> section -->

<p>The <dfn id=attr-input-placeholder title=attr-input-placeholder><code>placeholder</code></dfn>
attribute represents a <em>short</em> hint (a word or short phrase)
intended to aid the user with data entry. A hint could be a sample
Expand Down Expand Up @@ -33104,6 +33106,7 @@ interface <dfn id=htmloptionelement>HTMLOptionElement</dfn> : <a href=#htmleleme
<dd><code title=attr-fae-form><a href=#attr-fae-form>form</a></code></dd>
<dd><code title=attr-textarea-maxlength><a href=#attr-textarea-maxlength>maxlength</a></code></dd>
<dd><code title=attr-fe-name><a href=#attr-fe-name>name</a></code></dd>
<dd><code title=attr-textarea-placeholder><a href=#attr-textarea-placeholder>placeholder</a></code></dd>
<dd><code title=attr-textarea-readonly><a href=#attr-textarea-readonly>readonly</a></code></dd>
<dd><code title=attr-textarea-required><a href=#attr-textarea-required>required</a></code></dd>
<dd><code title=attr-textarea-rows><a href=#attr-textarea-rows>rows</a></code></dd>
Expand All @@ -33117,6 +33120,7 @@ interface <dfn id=htmloptionelement>HTMLOptionElement</dfn> : <a href=#htmleleme
readonly attribute <a href=#htmlformelement>HTMLFormElement</a> <a href=#dom-fae-form title=dom-fae-form>form</a>;
attribute long <a href=#dom-textarea-maxlength title=dom-textarea-maxLength>maxLength</a>;
attribute DOMString <a href=#dom-fe-name title=dom-fe-name>name</a>;
attribute DOMString <a href=#dom-textarea-placeholder title=dom-textarea-placeholder>placeholder</a>;
attribute boolean <a href=#dom-textarea-readonly title=dom-textarea-readOnly>readOnly</a>;
attribute boolean <a href=#dom-textarea-required title=dom-textarea-required>required</a>;
attribute unsigned long <a href=#dom-textarea-rows title=dom-textarea-rows>rows</a>;
Expand Down Expand Up @@ -33294,6 +33298,33 @@ interface <dfn id=htmloptionelement>HTMLOptionElement</dfn> : <a href=#htmleleme

</div>


<!-- similar text in the <input> section -->

<p>The <dfn id=attr-textarea-placeholder title=attr-textarea-placeholder><code>placeholder</code></dfn>
attribute represents a hint (a word or short phrase) intended to aid
the user with data entry. A hint could be a sample value or a brief
description of the expected format. The attribute, if specified,
must have a value that contains no U+000A LINE FEED (LF) or U+000D
CARRIAGE RETURN (CR) characters.</p>

<p class=note>For a longer hint or other advisory text, the <code title=attr-title><a href=#the-title-attribute>title</a></code> attribute is more appropriate.</p>

<p>The <code title=attr-textarea-placeholder><a href=#attr-textarea-placeholder>placeholder</a></code>
attribute should not be used as an alternative to a
<code><a href=#the-label-element>label</a></code>.</p>

<div class=impl>

<p>User agents should present this hint to the user, after having
<a href=#strip-line-breaks title="strip line breaks">stripped line breaks</a> from it,
when the element's <a href=#concept-fe-value title=concept-fe-value>value</a> is
the empty string and the control is not focused (e.g. by displaying
it inside a blank unfocused control).</p>

</div>


<p>The <code title=attr-fae-form><a href=#attr-fae-form>form</a></code> attribute is used to
explicitly associate the <code><a href=#the-textarea-element>textarea</a></code> element with its
<a href=#form-owner>form owner</a>. The <code title=attr-fe-name><a href=#attr-fe-name>name</a></code>
Expand Down Expand Up @@ -33322,7 +33353,8 @@ interface <dfn id=htmloptionelement>HTMLOptionElement</dfn> : <a href=#htmleleme

</dl><div class=impl>

<p>The <dfn id=dom-textarea-cols title=dom-textarea-cols><code>cols</code></dfn>, <dfn id=dom-textarea-required title=dom-textarea-required><code>required</code></dfn>, <dfn id=dom-textarea-rows title=dom-textarea-rows><code>rows</code></dfn>, and <dfn id=dom-textarea-wrap title=dom-textarea-wrap><code>wrap</code></dfn> attributes must
<p>The <dfn id=dom-textarea-cols title=dom-textarea-cols><code>cols</code></dfn>, <dfn id=dom-textarea-placeholder title=dom-textarea-placeholder><code>placeholder</code></dfn>,
<dfn id=dom-textarea-required title=dom-textarea-required><code>required</code></dfn>, <dfn id=dom-textarea-rows title=dom-textarea-rows><code>rows</code></dfn>, and <dfn id=dom-textarea-wrap title=dom-textarea-wrap><code>wrap</code></dfn> attributes must
<a href=#reflect>reflect</a> the respective content attributes of the same
name. The <code title=dom-textarea-cols><a href=#dom-textarea-cols>cols</a></code> and <code title=dom-textarea-rows><a href=#dom-textarea-rows>rows</a></code> attributes are <a href=#limited-to-only-positive-non-zero-numbers>limited
to only positive non-zero numbers</a>. The <dfn id=dom-textarea-maxlength title=dom-textarea-maxLength><code>maxLength</code></dfn> DOM
Expand Down Expand Up @@ -62914,8 +62946,6 @@ TODO (or delay):
enctype="" one, probably). This would allow forms to be used
with XHR-like systems without having to manually construct the
form data set the way that is done today.
XXX * placeholder="" for <textarea>, e.g. as seen on:
http://code.google.com/p/support/issues/detail?id=1#makechanges
XXX * become more consistent about what markup we use to mark up
productions (nothing? <i>? <code>?)
XXX * expose the value of a radio button group
Expand Down
38 changes: 35 additions & 3 deletions source
Expand Up @@ -35691,6 +35691,8 @@ You cannot complete this form until the field is correct.</samp></pre>

<h6>The <code title="attr-input-placeholder">placeholder</code> attribute</h6>

<!-- similar text in the <textarea> section -->

<p>The <dfn
title="attr-input-placeholder"><code>placeholder</code></dfn>
attribute represents a <em>short</em> hint (a word or short phrase)
Expand Down Expand Up @@ -37131,6 +37133,7 @@ interface <dfn>HTMLOptionElement</dfn> : <span>HTMLElement</span> {
<dd><code title="attr-fae-form">form</code></dd>
<dd><code title="attr-textarea-maxlength">maxlength</code></dd>
<dd><code title="attr-fe-name">name</code></dd>
<dd><code title="attr-textarea-placeholder">placeholder</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>
Expand All @@ -37144,6 +37147,7 @@ interface <dfn>HTMLOptionElement</dfn> : <span>HTMLElement</span> {
readonly attribute <span>HTMLFormElement</span> <span title="dom-fae-form">form</span>;
attribute long <span title="dom-textarea-maxLength">maxLength</span>;
attribute DOMString <span title="dom-fe-name">name</span>;
attribute DOMString <span title="dom-textarea-placeholder">placeholder</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>;
Expand Down Expand Up @@ -37357,6 +37361,35 @@ interface <dfn>HTMLOptionElement</dfn> : <span>HTMLElement</span> {

</div>


<!-- similar text in the <input> section -->

<p>The <dfn
title="attr-textarea-placeholder"><code>placeholder</code></dfn>
attribute represents a hint (a word or short phrase) intended to aid
the user with data entry. A hint could be a sample value or a brief
description of the expected format. The attribute, if specified,
must have a value that contains no U+000A LINE FEED (LF) or U+000D
CARRIAGE RETURN (CR) characters.</p>

<p class="note">For a longer hint or other advisory text, the <code
title="attr-title">title</code> attribute is more appropriate.</p>

<p>The <code title="attr-textarea-placeholder">placeholder</code>
attribute should not be used as an alternative to a
<code>label</code>.</p>

<div class="impl">

<p>User agents should present this hint to the user, after having
<span title="strip line breaks">stripped line breaks</span> from it,
when the element's <span title="concept-fe-value">value</span> is
the empty string and the control is not focused (e.g. by displaying
it inside a blank unfocused control).</p>

</div>


<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>
Expand Down Expand Up @@ -37391,7 +37424,8 @@ interface <dfn>HTMLOptionElement</dfn> : <span>HTMLElement</span> {
<div class="impl">

<p>The <dfn title="dom-textarea-cols"><code>cols</code></dfn>, <dfn
title="dom-textarea-required"><code>required</code></dfn>, <dfn
title="dom-textarea-placeholder"><code>placeholder</code></dfn>,
<dfn title="dom-textarea-required"><code>required</code></dfn>, <dfn
title="dom-textarea-rows"><code>rows</code></dfn>, and <dfn
title="dom-textarea-wrap"><code>wrap</code></dfn> attributes must
<span>reflect</span> the respective content attributes of the same
Expand Down Expand Up @@ -73718,8 +73752,6 @@ TODO (or delay):
enctype="" one, probably). This would allow forms to be used
with XHR-like systems without having to manually construct the
form data set the way that is done today.
XXX * placeholder="" for <textarea>, e.g. as seen on:
http://code.google.com/p/support/issues/detail?id=1#makechanges
XXX * become more consistent about what markup we use to mark up
productions (nothing? <i>? <code>?)
XXX * expose the value of a radio button group
Expand Down

0 comments on commit 5e7187b

Please sign in to comment.