spec/Overview.html 1.2086 2921 Add placeholder= for <textarea>. (whatwg

Add placeholder= for <textarea>. (whatwg r2921)

maxLength
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2086.html#dom-textarea-maxlength
Index
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2086.html#index
Status of this document
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2086.html#status-of-this-document
4.10.10 The textarea element
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2086.html#the-textarea-element
A vocabulary and associated APIs for HTML and XHTML
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2086.html#a-vocabulary-and-associated-apis-for-html-and-xhtml
step base
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2086.html#concept-input-min-zero
cols
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2086.html#dom-textarea-cols
W3C Working Draft 12 February 2009
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2086.html#w3c-working-draft-12-february-year
placeholder
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2086.html#attr-textarea-placeholder
4.10.4.2.11 The placeholder attribute
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2086.html#the-placeholder-attribute
required
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2086.html#attr-textarea-required
HTMLTextAreaElement
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2086.html#htmltextareaelement
required
http://people.w3.org/mike/diffs/html5/spec/Overview.1.2086.html#dom-textarea-required

http://people.w3.org/mike/diffs/html5/spec/Overview.diff.html
http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.2085&r2=1.2086&f=h
http://html5.org/tools/web-apps-tracker?from=2920&to=2921

===================================================================
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:23:30 UTC