- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Mon, 30 Mar 2009 01:21:55 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv22449
Modified Files:
Overview.html
Log Message:
Add placeholder= for <textarea>. (whatwg r2921)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2085
retrieving revision 1.2086
diff -u -d -r1.2085 -r1.2086
--- Overview.html 28 Mar 2009 01:23:58 -0000 1.2085
+++ Overview.html 30 Mar 2009 01:21:52 -0000 1.2086
@@ -146,7 +146,7 @@
<p><a href=http://www.w3.org/><img alt=W3C height=48 src=http://www.w3.org/Icons/w3c_home width=72></a></p>
<h1>HTML 5</h1>
<h2 class="no-num no-toc" id=a-vocabulary-and-associated-apis-for-html-and-xhtml>A vocabulary and associated APIs for HTML and XHTML</h2>
- <h2 class="no-num no-toc" id=w3c-working-draft-12-february-year><!--ZZZ:--> W3C Working Draft 12 February 2009<!-- fix date ZZZ --><!-- Editor's Draft 28 March 2009 --><!--:ZZZ--></h2>
+ <h2 class="no-num no-toc" id=w3c-working-draft-12-february-year><!--ZZZ:--> W3C Working Draft 12 February 2009<!-- fix date ZZZ --><!-- Editor's Draft 30 March 2009 --><!--:ZZZ--></h2>
<dl><!-- ZZZ: update the month/day (twice), uncomment out --><dt>This Version:</dt>
<dd><a href=http://www.w3.org/TR/2009/WD-html5-20090212/>http://www.w3.org/TR/2009/WD-html5-20090212/</a></dd>
<!-- :ZZZ -->
@@ -236,7 +236,7 @@
track.
<!--ZZZ:-->
This specification is the 12 February 2009 Working Draft.
- <!-- This specification is the 28 March 2009 Editor's Draft. -->
+ <!-- This specification is the 30 March 2009 Editor's Draft. -->
<!--:ZZZ-->
</p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- relationship to other work (required) --><p>This specification is also being produced by the <a href=http://www.whatwg.org/>WHATWG</a>. The two specifications are
identical from the table of contents onwards.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- context and rationale (required) --><p>This specification is intended to replace (be a new version of)
@@ -28281,7 +28281,7 @@
base</a> is not an integral multiple of the <a href=#concept-input-step title=concept-input-step>allowed value step</a>, the element is
<a href=#suffering-from-a-step-mismatch>suffering from a step mismatch</a>.</p>
- </div><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><p>The <dfn id=attr-input-placeholder title=attr-input-placeholder><code>placeholder</code></dfn>
+ </div><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
value or a brief description of the expected format. The attribute,
@@ -29335,6 +29335,7 @@
<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>
@@ -29348,6 +29349,7 @@
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>;
@@ -29499,6 +29501,21 @@
<a href=#concept-fe-value title=concept-fe-value>value</a> is the empty string,
then the element is <a href=#suffering-from-being-missing>suffering from being missing</a>.</p>
+ </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 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>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>.<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>
@@ -29525,7 +29542,8 @@
</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
@@ -57215,8 +57233,6 @@
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
Received on Monday, 30 March 2009 01:22:10 UTC