- From: Michael Smith via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 18 Aug 2010 13:10:27 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec-author-view In directory hutz:/tmp/cvs-serv16940 Modified Files: spec.html states-of-the-type-attribute.html the-xhtml-syntax.html Log Message: An idea for <device>. Don't know if we'll go with this, but it's interesting. (whatwg r5312) [updated by splitter] Index: the-xhtml-syntax.html =================================================================== RCS file: /sources/public/html5/spec-author-view/the-xhtml-syntax.html,v retrieving revision 1.690 retrieving revision 1.691 diff -u -d -r1.690 -r1.691 --- the-xhtml-syntax.html 18 Aug 2010 13:02:32 -0000 1.690 +++ the-xhtml-syntax.html 18 Aug 2010 13:10:25 -0000 1.691 @@ -0,0 +1,341 @@ +<!DOCTYPE html> +<!-- when publishing, change bits marked ZZZ --><html lang="en-US-x-Hixie" class="split chapter"><head><meta content="text/html; charset=ascii" http-equiv="Content-Type"><title>9 The XHTML syntax — HTML5 (Edition for Web Authors)</title><link href="whatwg.css" rel="stylesheet"><style type="text/css"> + pre { margin-left: 2em; white-space: pre-wrap; } + h2 { margin: 3em 0 1em 0; } + h3 { margin: 2.5em 0 1em 0; } + h4 { margin: 2.5em 0 0.75em 0; } + h5, h6 { margin: 2.5em 0 1em; } + h1 + h2, h1 + h2 + h2 { margin: 0.75em 0 0.75em; } + h2 + h3, h3 + h4, h4 + h5, h5 + h6 { margin-top: 0.5em; } + p { margin: 1em 0; } + hr:not(.top) { display: block; background: none; border: none; padding: 0; margin: 2em 0; height: auto; } + dl, dd { margin-top: 0; margin-bottom: 0; } + dt { margin-top: 0.75em; margin-bottom: 0.25em; clear: left; } + dt + dt { margin-top: 0; } + dd dt { margin-top: 0.25em; margin-bottom: 0; } + dd p { margin-top: 0; } + dd dl + p { margin-top: 1em; } + dd table + p { margin-top: 1em; } + p + * > li, dd li { margin: 1em 0; } + dt, dfn { font-weight: bold; font-style: normal; } + dt dfn { font-style: italic; } + pre, code { font-size: inherit; font-family: monospace; font-variant: normal; } + pre strong { color: black; font: inherit; font-weight: bold; background: yellow; } + pre em { font-weight: bolder; font-style: normal; } + @media screen { code { color: orangered; } code :link, code :visited { color: inherit; } } + var sub { vertical-align: bottom; font-size: smaller; position: relative; top: 0.1em; } + table { border-collapse: collapse; border-style: hidden hidden none hidden; } + table thead, table tbody { border-bottom: solid; } + table tbody th:first-child { border-left: solid; } + table tbody th { text-align: left; } + table td, table th { border-left: solid; border-right: solid; border-bottom: solid thin; vertical-align: top; padding: 0.2em; } + blockquote { margin: 0 0 0 2em; border: 0; padding: 0; font-style: italic; } + + .bad, .bad *:not(.XXX) { color: gray; border-color: gray; background: transparent; } + .matrix, .matrix td { border: none; text-align: right; } + .matrix { margin-left: 2em; } + .dice-example { border-collapse: collapse; border-style: hidden solid solid hidden; border-width: thin; margin-left: 3em; } + .dice-example caption { width: 30em; font-size: smaller; font-style: italic; padding: 0.75em 0; text-align: left; } + .dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; } + + .toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; } + img.extra { float: right; } + pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; } + pre.idl :link, pre.idl :visited { color: inherit; background: transparent; } + pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; } + pre.css:first-line { color: #AAAA50; } + dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #DDFFDD; } + hr + dl.domintro, div.impl + dl.domintro { margin-top: 2.5em; margin-bottom: 1.5em; } + dl.domintro dt, dl.domintro dt * { color: black; text-decoration: none; } + dl.domintro dd { margin: 0.5em 0 1em 2em; padding: 0; } + dl.domintro dd p { margin: 0.5em 0; } + dl.switch { padding-left: 2em; } + dl.switch > dt { text-indent: -1.5em; } + dl.switch > dt:before { content: '\21AA'; padding: 0 0.5em 0 0; display: inline-block; width: 1em; text-align: right; line-height: 0.5em; } + dl.triple { padding: 0 0 0 1em; } + dl.triple dt, dl.triple dd { margin: 0; display: inline } + dl.triple dt:after { content: ':'; } + dl.triple dd:after { content: '\A'; white-space: pre; } + .diff-old { text-decoration: line-through; color: silver; background: transparent; } + .diff-chg, .diff-new { text-decoration: underline; color: green; background: transparent; } + a .diff-new { border-bottom: 1px blue solid; } + + h2 { page-break-before: always; } + h1, h2, h3, h4, h5, h6 { page-break-after: avoid; } + h1 + h2, hr + h2.no-toc { page-break-before: auto; } + + p > span:not([title=""]):not([class="XXX"]):not([class="impl"]), li > span:not([title=""]):not([class="XXX"]):not([class="impl"]) { border-bottom: solid #9999CC; } + + div.head { margin: 0 0 1em; padding: 1em 0 0 0; } + div.head p { margin: 0; } + div.head h1 { margin: 0; } + div.head .logo { float: right; margin: 0 1em; } + div.head .logo img { border: none } /* remove border from top image */ + div.head dl { margin: 1em 0; } + div.head p.copyright, div.head p.alt { font-size: x-small; font-style: oblique; margin: 0; } + + body > .toc > li { margin-top: 1em; margin-bottom: 1em; } + body > .toc.brief > li { margin-top: 0.35em; margin-bottom: 0.35em; } + body > .toc > li > * { margin-bottom: 0.5em; } + body > .toc > li > * > li > * { margin-bottom: 0.25em; } + .toc, .toc li { list-style: none; } + + .brief { margin-top: 1em; margin-bottom: 1em; line-height: 1.1; } + .brief li { margin: 0; padding: 0; } + .brief li p { margin: 0; padding: 0; } + + .category-list { margin-top: -0.75em; margin-bottom: 1em; line-height: 1.5; } + .category-list::before { content: '\21D2\A0'; font-size: 1.2em; font-weight: 900; } + .category-list li { display: inline; } + .category-list li:not(:last-child)::after { content: ', '; } + .category-list li > span, .category-list li > a { text-transform: lowercase; } + .category-list li * { text-transform: none; } /* don't affect <code> nested in <a> */ + + .XXX { color: #E50000; background: white; border: solid red; padding: 0.5em; margin: 1em 0; } + .XXX > :first-child { margin-top: 0; } + p .XXX { line-height: 3em; } + .annotation { border: solid thin black; background: #0C479D; color: white; position: relative; margin: 8px 0 20px 0; } + .annotation:before { position: absolute; left: 0; top: 0; width: 100%; height: 100%; margin: 6px -6px -6px 6px; background: #333333; z-index: -1; content: ''; } + .annotation :link, .annotation :visited { color: inherit; } + .annotation :link:hover, .annotation :visited:hover { background: transparent; } + .annotation span { border: none ! important; } + .note { color: green; background: transparent; font-family: sans-serif; } + .warning { color: red; background: transparent; } + .note, .warning { font-weight: bolder; font-style: italic; } + p.note, div.note { padding: 0.5em 2em; } + span.note { padding: 0 2em; } + .note p:first-child, .warning p:first-child { margin-top: 0; } + .note p:last-child, .warning p:last-child { margin-bottom: 0; } + .warning:before { font-style: normal; } + p.note:before { content: 'Note: '; } + p.warning:before { content: '\26A0 Warning! '; } + + .bookkeeping:before { display: block; content: 'Bookkeeping details'; font-weight: bolder; font-style: italic; } + .bookkeeping { font-size: 0.8em; margin: 2em 0; } + .bookkeeping p { margin: 0.5em 2em; display: list-item; list-style: square; } + .bookkeeping dt { margin: 0.5em 2em 0; } + .bookkeeping dd { margin: 0 3em 0.5em; } + + h4 { position: relative; z-index: 3; } + h4 + .element, h4 + div + .element { margin-top: -2.5em; padding-top: 2em; } + .element { + background: #EEEEFF; + color: black; + margin: 0 0 1em 0.15em; + padding: 0 1em 0.25em 0.75em; + border-left: solid #9999FF 0.25em; + position: relative; + z-index: 1; + } + .element:before { + position: absolute; + z-index: 2; + top: 0; + left: -1.15em; + height: 2em; + width: 0.9em; + background: #EEEEFF; + content: ' '; + border-style: none none solid solid; + border-color: #9999FF; + border-width: 0.25em; + } + + .example { display: block; color: #222222; background: #FCFCFC; border-left: double; margin-left: 2em; padding-left: 1em; } + td > .example:only-child { margin: 0 0 0 0.1em; } + + ul.domTree, ul.domTree ul { padding: 0 0 0 1em; margin: 0; } + ul.domTree li { padding: 0; margin: 0; list-style: none; position: relative; } + ul.domTree li li { list-style: none; } + ul.domTree li:first-child::before { position: absolute; top: 0; height: 0.6em; left: -0.75em; width: 0.5em; border-style: none none solid solid; content: ''; border-width: 0.1em; } + ul.domTree li:not(:last-child)::after { position: absolute; top: 0; bottom: -0.6em; left: -0.75em; width: 0.5em; border-style: none none solid solid; content: ''; border-width: 0.1em; } + ul.domTree span { font-style: italic; font-family: serif; } + ul.domTree .t1 code { color: purple; font-weight: bold; } + ul.domTree .t2 { font-style: normal; font-family: monospace; } + ul.domTree .t2 .name { color: black; font-weight: bold; } + ul.domTree .t2 .value { color: blue; font-weight: normal; } + ul.domTree .t3 code, .domTree .t4 code, .domTree .t5 code { color: gray; } + ul.domTree .t7 code, .domTree .t8 code { color: green; } + ul.domTree .t10 code { color: teal; } + + body.dfnEnabled dfn { cursor: pointer; } + .dfnPanel { + display: inline; + position: absolute; + z-index: 10; + height: auto; + width: auto; + padding: 0.5em 0.75em; + font: small sans-serif, Droid Sans Fallback; + background: #DDDDDD; + color: black; + border: outset 0.2em; + } + .dfnPanel * { margin: 0; padding: 0; font: inherit; text-indent: 0; } + .dfnPanel :link, .dfnPanel :visited { color: black; } + .dfnPanel p { font-weight: bolder; } + .dfnPanel * + p { margin-top: 0.25em; } + .dfnPanel li { list-style-position: inside; } + + #configUI { position: absolute; z-index: 20; top: 10em; right: 1em; width: 11em; font-size: small; } + #configUI p { margin: 0.5em 0; padding: 0.3em; background: #EEEEEE; color: black; border: inset thin; } + #configUI p label { display: block; } + #configUI #updateUI, #configUI .loginUI { text-align: center; } + #configUI input[type=button] { display: block; margin: auto; } + + </style><style type="text/css"> + + .applies thead th > * { display: block; } + .applies thead code { display: block; } + .applies tbody th { whitespace: nowrap; } + .applies td { text-align: center; } + .applies .yes { background: yellow; } + + .matrix, .matrix td { border: hidden; text-align: right; } + .matrix { margin-left: 2em; } + + .dice-example { border-collapse: collapse; border-style: hidden solid solid hidden; border-width: thin; margin-left: 3em; } + .dice-example caption { width: 30em; font-size: smaller; font-style: italic; padding: 0.75em 0; text-align: left; } + .dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; } + + #table-example-1 { border: solid thin; border-collapse: collapse; margin-left: 3em; } + #table-example-1 * { font-family: "Essays1743", serif; line-height: 1.01em; } + #table-example-1 caption { padding-bottom: 0.5em; } + #table-example-1 thead, #table-example-1 tbody { border: none; } + #table-example-1 th, #table-example-1 td { border: solid thin; } + #table-example-1 th { font-weight: normal; } + #table-example-1 td { border-style: none solid; vertical-align: top; } + #table-example-1 th { padding: 0.5em; vertical-align: middle; text-align: center; } + #table-example-1 tbody tr:first-child td { padding-top: 0.5em; } + #table-example-1 tbody tr:last-child td { padding-bottom: 1.5em; } + #table-example-1 tbody td:first-child { padding-left: 2.5em; padding-right: 0; width: 9em; } + #table-example-1 tbody td:first-child::after { content: leader(". "); } + #table-example-1 tbody td { padding-left: 2em; padding-right: 2em; } + #table-example-1 tbody td:first-child + td { width: 10em; } + #table-example-1 tbody td:first-child + td ~ td { width: 2.5em; } + #table-example-1 tbody td:first-child + td + td + td ~ td { width: 1.25em; } + + .apple-table-examples { border: none; border-collapse: separate; border-spacing: 1.5em 0em; width: 40em; margin-left: 3em; } + .apple-table-examples * { font-family: "Times", serif; } + .apple-table-examples td, .apple-table-examples th { border: none; white-space: nowrap; padding-top: 0; padding-bottom: 0; } + .apple-table-examples tbody th:first-child { border-left: none; width: 100%; } + .apple-table-examples thead th:first-child ~ th { font-size: smaller; font-weight: bolder; border-bottom: solid 2px; text-align: center; } + .apple-table-examples tbody th::after, .apple-table-examples tfoot th::after { content: leader(". ") } + .apple-table-examples tbody th, .apple-table-examples tfoot th { font: inherit; text-align: left; } + .apple-table-examples td { text-align: right; vertical-align: top; } + .apple-table-examples.e1 tbody tr:last-child td { border-bottom: solid 1px; } + .apple-table-examples.e1 tbody + tbody tr:last-child td { border-bottom: double 3px; } + .apple-table-examples.e2 th[scope=row] { padding-left: 1em; } + .apple-table-examples sup { line-height: 0; } + + .details-example img { vertical-align: top; } + + #named-character-references-table { + font-size: 0.6em; + column-width: 28em; + column-gap: 1em; + -moz-column-width: 28em; + -moz-column-gap: 1em; + -webkit-column-width: 28em; + -webkit-column-gap: 1em; + } + #named-character-references-table > table > tbody > tr > td:last-child { text-align: center; } + #named-character-references-table > table > tbody > tr > td:last-child:hover > span { position: absolute; top: auto; left: auto; margin-left: 0.5em; line-height: 1.2; font-size: 5em; border: outset; padding: 0.25em 0.5em; background: white; width: 1.25em; height: auto; text-align: center; } + + .glyph.control { color: red; } + + @font-face { + font-family: 'Essays1743'; + src: url('http://www.whatwg.org/specs/web-apps/current-work/fonts/Essays1743.ttf'); + } + @font-face { + font-family: 'Essays1743'; + font-weight: bold; + src: url('http://www.whatwg.org/specs/web-apps/current-work/fonts/Essays1743-Bold.ttf'); + } + @font-face { + font-family: 'Essays1743'; + font-style: italic; + src: url('http://www.whatwg.org/specs/web-apps/current-work/fonts/Essays1743-Italic.ttf'); + } + @font-face { + font-family: 'Essays1743'; + font-style: italic; + font-weight: bold; + src: url('http://www.whatwg.org/specs/web-apps/current-work/fonts/Essays1743-BoldItalic.ttf'); + } + + </style><link href="data:text/css," id="complete" rel="stylesheet" title="Complete specification"><link href="data:text/css,.impl%20%7B%20display:%20none;%20%7D%0Ahtml%20%7B%20border:%20solid%20yellow;%20%7D%20.domintro:before%20%7B%20display:%20none;%20%7D" id="author" rel="alternate stylesheet" title="Author documentation only"><link href="data:text/css,.impl%20%7B%20background:%20%23FFEEEE;%20%7D%20.domintro:before%20%7B%20background:%20%23FFEEEE;%20%7D" id="highlight" rel="alternate stylesheet" title="Highlight implementation requirements"><script type="text/javascript"> + function getCookie(name) { + var params = location.search.substr(1).split("&"); + for (var index = 0; index < params.length; index++) { + if (params[index] == name) + return "1"; + var data = params[index].split("="); + if (data[0] == name) + return unescape(data[1]); + } + var cookies = document.cookie.split("; "); + for (var index = 0; index < cookies.length; index++) { + var data = cookies[index].split("="); + if (data[0] == name) + return unescape(data[1]); + } + return null; + } + function load(script) { + var e = document.createElement('script'); + e.setAttribute('src', script + '?' + encodeURIComponent(location) + '&' + encodeURIComponent(document.referrer)); + document.body.appendChild(e); + } + function init() { + if (location.search == '?slow-browser') + return; + var configUI = document.createElement('div'); + configUI.id = 'configUI'; + document.body.appendChild(configUI); + if (document.getElementById('head')) + load('toc.js'); + load('dfn.js'); + if (getCookie('profile') == '1') + document.getElementsByTagName('h2')[0].textContent += '; load: ' + (new Date() - loadTimer) + 'ms'; + fixBrokenLink(); + } +</script><link href="http://www.w3.org/StyleSheets/TR/W3C-ED" rel="stylesheet" type="text/css"><link href="style.css" rel="stylesheet"><script src="link-fixup.js"></script><link href="named-character-references.html" title="8.2 Named character references" rel="prev"> + <link href="Overview.html#contents" title="Table of contents" rel="index"> + <link href="obsolete.html" title="10 Obsolete features" rel="next"> + </head><body onload="fixBrokenLink(); init()"><div class="head" id="head"> + <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>HTML5 (Edition for Web Authors)<span class="rcsrevision"> revision 1.4234</span></h1> + </div><div> + <a href="named-character-references.html">← 8.2 Named character references</a> – + <a href="Overview.html#contents">Table of contents</a> – + <a href="obsolete.html">10 Obsolete features →</a> + </div> + + <h2 id="the-xhtml-syntax"><span class="secno">9 </span><dfn id="xhtml">The XHTML syntax</dfn></h2><p class="note">This section only describes the rules for XML + resources. Rules for <code><a href="iana.html#text-html" id="text-html-5">text/html</a></code> resources are discussed + in the section above entitled "<a href="syntax.html#syntax" id="the-html-syntax-7">The HTML syntax</a>".</p><p>The syntax for using HTML with XML, whether in XHTML documents or + embedded in other XML documents, is defined in the XML and + Namespaces in XML specifications. <a href="references.html#refsXML">[XML]</a> <a href="references.html#refsXMLNS">[XMLNS]</a></p><p>This specification does not define any syntax-level requirements + beyond those defined for XML proper.</p><p>XML documents may contain a <code>DOCTYPE</code> if desired, but + this is not required to conform to this specification. This + specification does not define a public or system identifier, nor + provide a format DTD.</p><p class="note">According to the XML specification, XML processors + are not guaranteed to process the external DTD subset referenced in + the DOCTYPE. This means, for example, that using entity references + for characters in XHTML documents is unsafe if they are defined in + an external file (except for <code title="">&lt;</code>, <code title="">&gt;</code>, <code title="">&amp;</code>, <code title="">&quot;</code> and <code title="">&apos;</code>).</p><!--v2DATAGRID + <div class="impl"> + + <h4>The <code>datagrid</code> element</h4> + + This section will probably include details on how to render DATAGRID + (including <span id="datagridPseudos">its pseudo-elements</span>), + drag-and-drop, etc, in a visual medium, in concert with + CSS. Implementation experience is desired before this section is + filled in. + + </div> +--></body></html> \ No newline at end of file Index: states-of-the-type-attribute.html =================================================================== RCS file: /sources/public/html5/spec-author-view/states-of-the-type-attribute.html,v retrieving revision 1.157 retrieving revision 1.158 diff -u -d -r1.157 -r1.158 --- states-of-the-type-attribute.html 18 Aug 2010 13:02:32 -0000 1.157 +++ states-of-the-type-attribute.html 18 Aug 2010 13:10:24 -0000 1.158 @@ -491,4 +491,648 @@ <code class="no-backref" title="dom-input-stepDown"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-stepdown" class="full-spec-link" title='Read about this "stepDown()" reference in the full HTML5 spec.'>stepDown()</a></code> and <code class="no-backref" title="dom-input-stepUp"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-stepup" class="full-spec-link" title='Read about this "stepUp()" reference in the full HTML5 spec.'>stepUp()</a></code> methods.</p> - </div><h6 id="url-state"><span class="secno">4.10.7.1.4 </span><dfn title="attr-input-type-url">URL</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>The <code><a href="the-input-element.html#the-input-element" id="input-65">input</a></code> element \ No newline at end of file + </div><h6 id="url-state"><span class="secno">4.10.7.1.4 </span><dfn title="attr-input-type-url">URL</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>The <code><a href="the-input-element.html#the-input-element" id="input-65">input</a></code> element <a href="http://dev.w3.org/html5/spec/rendering.html#represents" class="full-spec-link" title='Read about this "represents" reference in the full HTML5 spec.'>represents</a> a control + for editing a single <a href="urls.html#absolute-url" id="absolute-url-4">absolute URL</a> given in the + element's <a href="http://dev.w3.org/html5/spec/association-of-controls-and-forms.html#concept-fe-value" title='Read about this "value" reference in the full HTML5 spec.' class="full-spec-link">value</a>.</p><p>The <code title="attr-input-value"><a href="the-input-element.html#attr-input-value" id="value-10">value</a></code> attribute, if + specified, must have a value that is a <a href="urls.html#valid-url-potentially-surrounded-by-spaces" id="valid-url-potentially-surrounded-by-spaces-4">valid URL potentially + surrounded by spaces</a> that is also an <a href="urls.html#absolute-url" id="absolute-url-5">absolute + URL</a>.</p><div class="bookkeeping"> + + <p>The following common <code><a href="the-input-element.html#the-input-element" id="input-66">input</a></code> element content + attributes, IDL attributes, and methods apply to the element: + <code title="attr-input-autocomplete"><a href="common-input-element-attributes.html#attr-input-autocomplete" id="autocomplete-9">autocomplete</a></code>, + <code title="attr-input-list"><a href="common-input-element-attributes.html#attr-input-list" id="list-6">list</a></code>, + <code title="attr-input-maxlength"><a href="common-input-element-attributes.html#attr-input-maxlength" id="maxlength-6">maxlength</a></code>, + <code title="attr-input-pattern"><a href="common-input-element-attributes.html#attr-input-pattern" id="pattern-6">pattern</a></code>, + <code title="attr-input-placeholder"><a href="common-input-element-attributes.html#attr-input-placeholder" id="placeholder-5">placeholder</a></code>, + <code title="attr-input-readonly"><a href="common-input-element-attributes.html#attr-input-readonly" id="readonly-19">readonly</a></code>, + <code title="attr-input-required"><a href="common-input-element-attributes.html#attr-input-required" id="required-6">required</a></code>, and + <code title="attr-input-size"><a href="common-input-element-attributes.html#attr-input-size" id="size-5">size</a></code> content attributes; + <code title="dom-input-list"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-list" class="full-spec-link" title='Read about this "list" reference in the full HTML5 spec.'>list</a></code>, + <code title="dom-input-selectedOption"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-selectedoption" class="full-spec-link" title='Read about this "selectedOption" reference in the full HTML5 spec.'>selectedOption</a></code>, + <code title="dom-textarea/input-selectionStart"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-selectionstart" class="full-spec-link" title='Read about this "selectionStart" reference in the full HTML5 spec.'>selectionStart</a></code>, + <code title="dom-textarea/input-selectionEnd"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-selectionend" class="full-spec-link" title='Read about this "selectionEnd" reference in the full HTML5 spec.'>selectionEnd</a></code>, and + <code title="dom-input-value"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-value" class="full-spec-link" title='Read about this "value" reference in the full HTML5 spec.'>value</a></code> IDL attributes; + <code title="dom-textarea/input-select"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-select" class="full-spec-link" title='Read about this "select()" reference in the full HTML5 spec.'>select()</a></code> and + <code title="dom-textarea/input-setSelectionRange"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-setselectionrange" class="full-spec-link" title='Read about this "setSelectionRange()" reference in the full HTML5 spec.'>setSelectionRange()</a></code> methods.</p> + + <p>The <code title="dom-input-value"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-value" class="full-spec-link" title='Read about this "value" reference in the full HTML5 spec.'>value</a></code> IDL attribute is + in mode <a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-value-value" title='Read about this "value" reference in the full HTML5 spec.' class="full-spec-link">value</a>.</p> + + <p>The <code title="event-input-input"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#event-input-input" class="full-spec-link" title='Read about this "input" reference in the full HTML5 spec.'>input</a></code> and <code title="event-input-change"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#event-input-change" class="full-spec-link" title='Read about this "change" reference in the full HTML5 spec.'>change</a></code> events apply.</p> + + <p>The following content attributes must not be specified and do not + apply to the element: + <code class="no-backref" title="attr-input-accept"><a href="number-state.html#attr-input-accept" id="accept-5">accept</a></code>, + <code class="no-backref" title="attr-input-alt"><a href="number-state.html#attr-input-alt" id="alt-43">alt</a></code>, + <code class="no-backref" title="attr-input-checked"><a href="the-input-element.html#attr-input-checked" id="checked-5">checked</a></code>, + <code class="no-backref" title="attr-fs-formaction"><a href="association-of-controls-and-forms.html#attr-fs-formaction" id="formaction-5">formaction</a></code>, + <code class="no-backref" title="attr-fs-formenctype"><a href="association-of-controls-and-forms.html#attr-fs-formenctype" id="formenctype-5">formenctype</a></code>, + <code class="no-backref" title="attr-fs-formmethod"><a href="association-of-controls-and-forms.html#attr-fs-formmethod" id="formmethod-5">formmethod</a></code>, + <code class="no-backref" title="attr-fs-formnovalidate"><a href="association-of-controls-and-forms.html#attr-fs-formnovalidate" id="formnovalidate-5">formnovalidate</a></code>, + <code class="no-backref" title="attr-fs-formtarget"><a href="association-of-controls-and-forms.html#attr-fs-formtarget" id="formtarget-5">formtarget</a></code>, + <code class="no-backref" title="attr-dim-height"><a href="the-map-element.html#attr-dim-height" id="height-16">height</a></code>, + <code class="no-backref" title="attr-input-max"><a href="common-input-element-attributes.html#attr-input-max" id="max-6">max</a></code>, + <code class="no-backref" title="attr-input-min"><a href="common-input-element-attributes.html#attr-input-min" id="min-6">min</a></code>, + <code class="no-backref" title="attr-input-multiple"><a href="common-input-element-attributes.html#attr-input-multiple" id="multiple-5">multiple</a></code>, + <code class="no-backref" title="attr-input-src"><a href="number-state.html#attr-input-src" id="src-48">src</a></code>, + <code class="no-backref" title="attr-input-step"><a href="common-input-element-attributes.html#attr-input-step" id="step-6">step</a></code>, and + <code class="no-backref" title="attr-dim-width"><a href="the-map-element.html#attr-dim-width" id="width-16">width</a></code>.</p> + + <p>The following IDL attributes and methods do not apply to the + element: + <code class="no-backref" title="dom-input-checked"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-checked" class="full-spec-link" title='Read about this "checked" reference in the full HTML5 spec.'>checked</a></code>, + <code class="no-backref" title="dom-input-files"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-files" class="full-spec-link" title='Read about this "files" reference in the full HTML5 spec.'>files</a></code>, + <code class="no-backref" title="dom-input-valueAsDate"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-valueasdate" class="full-spec-link" title='Read about this "valueAsDate" reference in the full HTML5 spec.'>valueAsDate</a></code>, and + <code class="no-backref" title="dom-input-valueAsNumber"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-valueasnumber" class="full-spec-link" title='Read about this "valueAsNumber" reference in the full HTML5 spec.'>valueAsNumber</a></code> IDL attributes; + <code class="no-backref" title="dom-input-stepDown"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-stepdown" class="full-spec-link" title='Read about this "stepDown()" reference in the full HTML5 spec.'>stepDown()</a></code> and + <code class="no-backref" title="dom-input-stepUp"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-stepup" class="full-spec-link" title='Read about this "stepUp()" reference in the full HTML5 spec.'>stepUp()</a></code> methods.</p> + + </div><div class="example"> + + <p>If a document contained the following markup:</p> + + <pre><input type="url" name="location" list="urls"> +<datalist id="urls"> + <option label="MIME: Format of Internet Message Bodies" value="http://www.ietf.org/rfc/rfc2045"> + <option label="HTML 4.01 Specification" value="http://www.w3.org/TR/html4/"> + <option label="Form Controls" value="http://www.w3.org/TR/xforms/slice8.html#ui-commonelems-hint"> + <option label="Scalable Vector Graphics (SVG) 1.1 Specification" value="http://www.w3.org/TR/SVG/"> + <option label="Feature Sets - SVG 1.1 - 20030114" value="http://www.w3.org/TR/SVG/feature.html"> + <option label="The Single UNIX Specification, Version 3" value="http://www.unix-systems.org/version3/"> +</datalist> +</pre> + + <p>...and the user had typed "<kbd>www.w3</kbd>", and the user + agent had also found that the user had visited + <code>http://www.w3.org/Consortium/#membership</code> and + <code>http://www.w3.org/TR/XForms/</code> in the recent past, then + the rendering might look like this:</p> + + <p><img alt='A text box with an icon on the left followed by the text "www.w3" and a cursor, with a drop down button on the right hand side; with, below, a drop down box containing a list of six URIs on the left, with the first four having grayed out labels on the right; and a scroll bar to the right of the drow down box, indicating further values are available.' src="http://dev.w3.org/html5/spec/images/sample-url.png"></p> + + <p>The first four URIs in this sample consist of the four URIs in + the author-specified list that match the text the user has entered, + sorted lexically. Note how the UA is using the knowledge that the + values are URIs to allow the user to omit the scheme part and + perform intelligent matching on the domain name.</p> + + <p>The last two URIs (and probably many more, given the scrollbar's + indications of more values being available) are the matches from + the user agent's session history data. This data is not made + available to the page DOM. In this particular case, the UA has no + titles to provide for those values.</p> + + </div><h6 id="e-mail-state"><span class="secno">4.10.7.1.5 </span><dfn title="attr-input-type-email">E-mail</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>The <code><a href="the-input-element.html#the-input-element" id="input-67">input</a></code> element <a href="http://dev.w3.org/html5/spec/rendering.html#represents" class="full-spec-link" title='Read about this "represents" reference in the full HTML5 spec.'>represents</a> a control + for editing a list of e-mail addresses given in the element's <a href="http://dev.w3.org/html5/spec/association-of-controls-and-forms.html#concept-fe-value" title='Read about this "value" reference in the full HTML5 spec.' class="full-spec-link">value</a>.</p><p>If the <code title="attr-input-multiple"><a href="common-input-element-attributes.html#attr-input-multiple" id="multiple-6">multiple</a></code> + attribute is specified on the element, then the <code title="attr-input-value"><a href="the-input-element.html#attr-input-value" id="value-11">value</a></code> attribute, if specified, must + have a value that is a <a href="#valid-e-mail-address-list" id="valid-e-mail-address-list-0">valid e-mail address list</a>; + otherwise, the <code title="attr-input-value"><a href="the-input-element.html#attr-input-value" id="value-12">value</a></code> + attribute, if specified, must have a value that is a single + <a href="#valid-e-mail-address" id="valid-e-mail-address-0">valid e-mail address</a>.</p><p>A <dfn id="valid-e-mail-address-list">valid e-mail address list</dfn> is a <a href="common-microsyntaxes.html#set-of-comma-separated-tokens" id="set-of-comma-separated-tokens-2">set of + comma-separated tokens</a>, where each token is itself a + <a href="#valid-e-mail-address" id="valid-e-mail-address-1">valid e-mail address</a>. </p><p>A <dfn id="valid-e-mail-address">valid e-mail address</dfn> is a string that matches the + ABNF production <code title="">1*( atext / "." ) "@" ldh-str 1*( "." ldh-str )</code> + where <code title="">atext</code> is defined in RFC 5322 section + 3.2.3, and <code title="">ldh-str</code> is defined in RFC 1034 + section 3.5. <a href="references.html#refsABNF">[ABNF]</a> <a href="references.html#refsRFC5322">[RFC5322]</a> <a href="references.html#refsRFC1034">[RFC1034]</a></p><!-- Domain syntax based on + section 3.5 of [RFC1034] and section 2.1 of [RFC1123] --><p class="note">This requirement is a <a href="introduction.html#willful-violation" id="willful-violation-1">willful violation</a> + of RFC 5322, which defines a syntax for e-mail addresses that is + simultaneously too strict (before the "@" character), too vague + (after the "@" character), and too lax (allowing comments, white + space characters, and quoted strings in manners unfamiliar to most + users) to be of practical use here.</p><div class="bookkeeping"> + + <p>The following common <code><a href="the-input-element.html#the-input-element" id="input-68">input</a></code> element content + attributes, IDL attributes, and methods apply to the element: + <code title="attr-input-autocomplete"><a href="common-input-element-attributes.html#attr-input-autocomplete" id="autocomplete-10">autocomplete</a></code>, + <code title="attr-input-list"><a href="common-input-element-attributes.html#attr-input-list" id="list-7">list</a></code>, + <code title="attr-input-maxlength"><a href="common-input-element-attributes.html#attr-input-maxlength" id="maxlength-7">maxlength</a></code>, + <code title="attr-input-multiple"><a href="common-input-element-attributes.html#attr-input-multiple" id="multiple-7">multiple</a></code>, + <code title="attr-input-pattern"><a href="common-input-element-attributes.html#attr-input-pattern" id="pattern-7">pattern</a></code>, + <code title="attr-input-placeholder"><a href="common-input-element-attributes.html#attr-input-placeholder" id="placeholder-6">placeholder</a></code>, + <code title="attr-input-readonly"><a href="common-input-element-attributes.html#attr-input-readonly" id="readonly-20">readonly</a></code>, + <code title="attr-input-required"><a href="common-input-element-attributes.html#attr-input-required" id="required-7">required</a></code>, and + <code title="attr-input-size"><a href="common-input-element-attributes.html#attr-input-size" id="size-6">size</a></code> content attributes; + <code title="dom-input-list"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-list" class="full-spec-link" title='Read about this "list" reference in the full HTML5 spec.'>list</a></code>, + <code title="dom-input-selectedOption"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-selectedoption" class="full-spec-link" title='Read about this "selectedOption" reference in the full HTML5 spec.'>selectedOption</a></code>, + <code title="dom-textarea/input-selectionStart"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-selectionstart" class="full-spec-link" title='Read about this "selectionStart" reference in the full HTML5 spec.'>selectionStart</a></code>, + <code title="dom-textarea/input-selectionEnd"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-selectionend" class="full-spec-link" title='Read about this "selectionEnd" reference in the full HTML5 spec.'>selectionEnd</a></code>, and + <code title="dom-input-value"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-value" class="full-spec-link" title='Read about this "value" reference in the full HTML5 spec.'>value</a></code> IDL attributes; + <code title="dom-textarea/input-select"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-select" class="full-spec-link" title='Read about this "select()" reference in the full HTML5 spec.'>select()</a></code> and + <code title="dom-textarea/input-setSelectionRange"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-setselectionrange" class="full-spec-link" title='Read about this "setSelectionRange()" reference in the full HTML5 spec.'>setSelectionRange()</a></code> methods.</p> + + <p>The <code title="dom-input-value"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-value" class="full-spec-link" title='Read about this "value" reference in the full HTML5 spec.'>value</a></code> IDL attribute is + in mode <a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-value-value" title='Read about this "value" reference in the full HTML5 spec.' class="full-spec-link">value</a>.</p> + + <p>The <code title="event-input-input"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#event-input-input" class="full-spec-link" title='Read about this "input" reference in the full HTML5 spec.'>input</a></code> and <code title="event-input-change"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#event-input-change" class="full-spec-link" title='Read about this "change" reference in the full HTML5 spec.'>change</a></code> events apply.</p> + + <p>The following content attributes must not be specified and do not + apply to the element: + <code class="no-backref" title="attr-input-accept"><a href="number-state.html#attr-input-accept" id="accept-6">accept</a></code>, + <code class="no-backref" title="attr-input-alt"><a href="number-state.html#attr-input-alt" id="alt-44">alt</a></code>, + <code class="no-backref" title="attr-input-checked"><a href="the-input-element.html#attr-input-checked" id="checked-6">checked</a></code>, + <code class="no-backref" title="attr-fs-formaction"><a href="association-of-controls-and-forms.html#attr-fs-formaction" id="formaction-6">formaction</a></code>, + <code class="no-backref" title="attr-fs-formenctype"><a href="association-of-controls-and-forms.html#attr-fs-formenctype" id="formenctype-6">formenctype</a></code>, + <code class="no-backref" title="attr-fs-formmethod"><a href="association-of-controls-and-forms.html#attr-fs-formmethod" id="formmethod-6">formmethod</a></code>, + <code class="no-backref" title="attr-fs-formnovalidate"><a href="association-of-controls-and-forms.html#attr-fs-formnovalidate" id="formnovalidate-6">formnovalidate</a></code>, + <code class="no-backref" title="attr-fs-formtarget"><a href="association-of-controls-and-forms.html#attr-fs-formtarget" id="formtarget-6">formtarget</a></code>, + <code class="no-backref" title="attr-dim-height"><a href="the-map-element.html#attr-dim-height" id="height-17">height</a></code>, + <code class="no-backref" title="attr-input-max"><a href="common-input-element-attributes.html#attr-input-max" id="max-7">max</a></code>, + <code class="no-backref" title="attr-input-min"><a href="common-input-element-attributes.html#attr-input-min" id="min-7">min</a></code>, + <code class="no-backref" title="attr-input-src"><a href="number-state.html#attr-input-src" id="src-49">src</a></code>, + <code class="no-backref" title="attr-input-step"><a href="common-input-element-attributes.html#attr-input-step" id="step-7">step</a></code>, and + <code class="no-backref" title="attr-dim-width"><a href="the-map-element.html#attr-dim-width" id="width-17">width</a></code>.</p> + + <p>The following IDL attributes and methods do not apply to the + element: + <code class="no-backref" title="dom-input-checked"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-checked" class="full-spec-link" title='Read about this "checked" reference in the full HTML5 spec.'>checked</a></code>, + <code class="no-backref" title="dom-input-files"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-files" class="full-spec-link" title='Read about this "files" reference in the full HTML5 spec.'>files</a></code>, + <code class="no-backref" title="dom-input-valueAsDate"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-valueasdate" class="full-spec-link" title='Read about this "valueAsDate" reference in the full HTML5 spec.'>valueAsDate</a></code>, and + <code class="no-backref" title="dom-input-valueAsNumber"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-valueasnumber" class="full-spec-link" title='Read about this "valueAsNumber" reference in the full HTML5 spec.'>valueAsNumber</a></code> IDL attributes; + <code class="no-backref" title="dom-input-stepDown"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-stepdown" class="full-spec-link" title='Read about this "stepDown()" reference in the full HTML5 spec.'>stepDown()</a></code> and + <code class="no-backref" title="dom-input-stepUp"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-stepup" class="full-spec-link" title='Read about this "stepUp()" reference in the full HTML5 spec.'>stepUp()</a></code> methods.</p> + + </div><h6 id="password-state"><span class="secno">4.10.7.1.6 </span><dfn title="attr-input-type-password">Password</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>The <code><a href="the-input-element.html#the-input-element" id="input-69">input</a></code> element <a href="http://dev.w3.org/html5/spec/rendering.html#represents" class="full-spec-link" title='Read about this "represents" reference in the full HTML5 spec.'>represents</a> a one line + plain text edit control for the element's <a href="http://dev.w3.org/html5/spec/association-of-controls-and-forms.html#concept-fe-value" title='Read about this "value" reference in the full HTML5 spec.' class="full-spec-link">value</a>. The user agent should obscure + the value so that people other than the user cannot see it.</p><p>The <code title="attr-input-value"><a href="the-input-element.html#attr-input-value" id="value-13">value</a></code> attribute, if + specified, must have a value that contains no U+000A LINE FEED (LF) + or U+000D CARRIAGE RETURN (CR) characters.</p><div class="bookkeeping"> + + <p>The following common <code><a href="the-input-element.html#the-input-element" id="input-70">input</a></code> element content + attributes, IDL attributes, and methods apply to the element: + <code title="attr-input-autocomplete"><a href="common-input-element-attributes.html#attr-input-autocomplete" id="autocomplete-11">autocomplete</a></code>, + <code title="attr-input-maxlength"><a href="common-input-element-attributes.html#attr-input-maxlength" id="maxlength-8">maxlength</a></code>, + <code title="attr-input-pattern"><a href="common-input-element-attributes.html#attr-input-pattern" id="pattern-8">pattern</a></code>, + <code title="attr-input-placeholder"><a href="common-input-element-attributes.html#attr-input-placeholder" id="placeholder-7">placeholder</a></code>, + <code title="attr-input-readonly"><a href="common-input-element-attributes.html#attr-input-readonly" id="readonly-21">readonly</a></code>, + <code title="attr-input-required"><a href="common-input-element-attributes.html#attr-input-required" id="required-8">required</a></code>, and + <code title="attr-input-size"><a href="common-input-element-attributes.html#attr-input-size" id="size-7">size</a></code> content attributes; + <code title="dom-textarea/input-selectionStart"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-selectionstart" class="full-spec-link" title='Read about this "selectionStart" reference in the full HTML5 spec.'>selectionStart</a></code>, + <code title="dom-textarea/input-selectionEnd"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-selectionend" class="full-spec-link" title='Read about this "selectionEnd" reference in the full HTML5 spec.'>selectionEnd</a></code>, and + <code title="dom-input-value"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-value" class="full-spec-link" title='Read about this "value" reference in the full HTML5 spec.'>value</a></code> IDL attributes; + <code title="dom-textarea/input-select"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-select" class="full-spec-link" title='Read about this "select()" reference in the full HTML5 spec.'>select()</a></code>, and + <code title="dom-textarea/input-setSelectionRange"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-setselectionrange" class="full-spec-link" title='Read about this "setSelectionRange()" reference in the full HTML5 spec.'>setSelectionRange()</a></code> methods.</p> + + <p>The <code title="dom-input-value"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-value" class="full-spec-link" title='Read about this "value" reference in the full HTML5 spec.'>value</a></code> IDL attribute is + in mode <a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-value-value" title='Read about this "value" reference in the full HTML5 spec.' class="full-spec-link">value</a>.</p> + + <p>The <code title="event-input-input"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#event-input-input" class="full-spec-link" title='Read about this "input" reference in the full HTML5 spec.'>input</a></code> and <code title="event-input-change"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#event-input-change" class="full-spec-link" title='Read about this "change" reference in the full HTML5 spec.'>change</a></code> events apply.</p> + + <p>The following content attributes must not be specified and do not + apply to the element: + <code class="no-backref" title="attr-input-accept"><a href="number-state.html#attr-input-accept" id="accept-7">accept</a></code>, + <code class="no-backref" title="attr-input-alt"><a href="number-state.html#attr-input-alt" id="alt-45">alt</a></code>, + <code class="no-backref" title="attr-input-checked"><a href="the-input-element.html#attr-input-checked" id="checked-7">checked</a></code>, + <code class="no-backref" title="attr-fs-formaction"><a href="association-of-controls-and-forms.html#attr-fs-formaction" id="formaction-7">formaction</a></code>, + <code class="no-backref" title="attr-fs-formenctype"><a href="association-of-controls-and-forms.html#attr-fs-formenctype" id="formenctype-7">formenctype</a></code>, + <code class="no-backref" title="attr-fs-formmethod"><a href="association-of-controls-and-forms.html#attr-fs-formmethod" id="formmethod-7">formmethod</a></code>, + <code class="no-backref" title="attr-fs-formnovalidate"><a href="association-of-controls-and-forms.html#attr-fs-formnovalidate" id="formnovalidate-7">formnovalidate</a></code>, + <code class="no-backref" title="attr-fs-formtarget"><a href="association-of-controls-and-forms.html#attr-fs-formtarget" id="formtarget-7">formtarget</a></code>, + <code class="no-backref" title="attr-dim-height"><a href="the-map-element.html#attr-dim-height" id="height-18">height</a></code>, + <code class="no-backref" title="attr-input-list"><a href="common-input-element-attributes.html#attr-input-list" id="list-8">list</a></code>, + <code class="no-backref" title="attr-input-max"><a href="common-input-element-attributes.html#attr-input-max" id="max-8">max</a></code>, + <code class="no-backref" title="attr-input-min"><a href="common-input-element-attributes.html#attr-input-min" id="min-8">min</a></code>, + <code class="no-backref" title="attr-input-multiple"><a href="common-input-element-attributes.html#attr-input-multiple" id="multiple-8">multiple</a></code>, + <code class="no-backref" title="attr-input-src"><a href="number-state.html#attr-input-src" id="src-50">src</a></code>, + <code class="no-backref" title="attr-input-step"><a href="common-input-element-attributes.html#attr-input-step" id="step-8">step</a></code>, and + <code class="no-backref" title="attr-dim-width"><a href="the-map-element.html#attr-dim-width" id="width-18">width</a></code>.</p> + + <p>The following IDL attributes and methods do not apply to the + element: + <code class="no-backref" title="dom-input-checked"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-checked" class="full-spec-link" title='Read about this "checked" reference in the full HTML5 spec.'>checked</a></code>, + <code class="no-backref" title="dom-input-files"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-files" class="full-spec-link" title='Read about this "files" reference in the full HTML5 spec.'>files</a></code>, + <code class="no-backref" title="dom-input-list"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-list" class="full-spec-link" title='Read about this "list" reference in the full HTML5 spec.'>list</a></code>, + <code class="no-backref" title="dom-input-selectedOption"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-selectedoption" class="full-spec-link" title='Read about this "selectedOption" reference in the full HTML5 spec.'>selectedOption</a></code>, + <code class="no-backref" title="dom-input-valueAsDate"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-valueasdate" class="full-spec-link" title='Read about this "valueAsDate" reference in the full HTML5 spec.'>valueAsDate</a></code>, and + <code class="no-backref" title="dom-input-valueAsNumber"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-valueasnumber" class="full-spec-link" title='Read about this "valueAsNumber" reference in the full HTML5 spec.'>valueAsNumber</a></code> IDL attributes; + <code class="no-backref" title="dom-input-stepDown"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-stepdown" class="full-spec-link" title='Read about this "stepDown()" reference in the full HTML5 spec.'>stepDown()</a></code> and + <code class="no-backref" title="dom-input-stepUp"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-stepup" class="full-spec-link" title='Read about this "stepUp()" reference in the full HTML5 spec.'>stepUp()</a></code> methods.</p> + + </div><h6 id="date-and-time-state"><span class="secno">4.10.7.1.7 </span><dfn title="attr-input-type-datetime">Date and Time</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>The <code><a href="the-input-element.html#the-input-element" id="input-71">input</a></code> element <a href="http://dev.w3.org/html5/spec/rendering.html#represents" class="full-spec-link" title='Read about this "represents" reference in the full HTML5 spec.'>represents</a> a control + for setting the element's <a href="http://dev.w3.org/html5/spec/association-of-controls-and-forms.html#concept-fe-value" title='Read about this "value" reference in the full HTML5 spec.' class="full-spec-link">value</a> to a string representing a + specific <a href="common-microsyntaxes.html#concept-datetime" id="concept-datetime-0" title="concept-datetime">global date and + time</a>. </p><p>The <code title="attr-input-value"><a href="the-input-element.html#attr-input-value" id="value-14">value</a></code> attribute, if + specified, must have a value that is a <a href="common-microsyntaxes.html#valid-global-date-and-time-string" id="valid-global-date-and-time-string-4">valid global date and + time string</a>.</p><!-- ok to set out-of-range value, we never + know when we might have to represent bogus input --><p>The <code title="attr-input-min"><a href="common-input-element-attributes.html#attr-input-min" id="min-9">min</a></code> attribute, if + specified, must have a value that is a <a href="common-microsyntaxes.html#valid-global-date-and-time-string" id="valid-global-date-and-time-string-5">valid global date and + time string</a>. The <code title="attr-input-max"><a href="common-input-element-attributes.html#attr-input-max" id="max-9">max</a></code> + attribute, if specified, must have a value that is a <a href="common-microsyntaxes.html#valid-global-date-and-time-string" id="valid-global-date-and-time-string-6">valid + global date and time string</a>.</p><p>The <code title="attr-input-step"><a href="common-input-element-attributes.html#attr-input-step" id="step-9">step</a></code> attribute is + expressed in seconds. The <a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#concept-input-step-default" title='Read about this "default step" reference in the full HTML5 spec.' class="full-spec-link">default step</a> is 60 + seconds.</p><div class="bookkeeping"> + + <p>The following common <code><a href="the-input-element.html#the-input-element" id="input-72">input</a></code> element content + attributes, IDL attributes, and methods apply to the element: + <code title="attr-input-autocomplete"><a href="common-input-element-attributes.html#attr-input-autocomplete" id="autocomplete-12">autocomplete</a></code>, + <code title="attr-input-list"><a href="common-input-element-attributes.html#attr-input-list" id="list-9">list</a></code>, + <code title="attr-input-max"><a href="common-input-element-attributes.html#attr-input-max" id="max-10">max</a></code>, + <code title="attr-input-min"><a href="common-input-element-attributes.html#attr-input-min" id="min-10">min</a></code>, + <code title="attr-input-readonly"><a href="common-input-element-attributes.html#attr-input-readonly" id="readonly-22">readonly</a></code>, + <code title="attr-input-required"><a href="common-input-element-attributes.html#attr-input-required" id="required-9">required</a></code>, and + <code title="attr-input-step"><a href="common-input-element-attributes.html#attr-input-step" id="step-10">step</a></code> content attributes; + <code title="dom-input-list"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-list" class="full-spec-link" title='Read about this "list" reference in the full HTML5 spec.'>list</a></code>, + <code title="dom-input-value"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-value" class="full-spec-link" title='Read about this "value" reference in the full HTML5 spec.'>value</a></code>, + <code title="dom-input-valueAsDate"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-valueasdate" class="full-spec-link" title='Read about this "valueAsDate" reference in the full HTML5 spec.'>valueAsDate</a></code>, + <code title="dom-input-valueAsNumber"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-valueasnumber" class="full-spec-link" title='Read about this "valueAsNumber" reference in the full HTML5 spec.'>valueAsNumber</a></code>, and + <code title="dom-input-selectedOption"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-selectedoption" class="full-spec-link" title='Read about this "selectedOption" reference in the full HTML5 spec.'>selectedOption</a></code> IDL attributes; + <code title="dom-input-stepDown"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-stepdown" class="full-spec-link" title='Read about this "stepDown()" reference in the full HTML5 spec.'>stepDown()</a></code> and + <code title="dom-input-stepUp"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-stepup" class="full-spec-link" title='Read about this "stepUp()" reference in the full HTML5 spec.'>stepUp()</a></code> methods.</p> + + <p>The <code title="dom-input-value"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-value" class="full-spec-link" title='Read about this "value" reference in the full HTML5 spec.'>value</a></code> IDL attribute is + in mode <a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-value-value" title='Read about this "value" reference in the full HTML5 spec.' class="full-spec-link">value</a>.</p> + + <p>The <code title="event-input-input"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#event-input-input" class="full-spec-link" title='Read about this "input" reference in the full HTML5 spec.'>input</a></code> and <code title="event-input-change"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#event-input-change" class="full-spec-link" title='Read about this "change" reference in the full HTML5 spec.'>change</a></code> events apply.</p> + + <p>The following content attributes must not be specified and do not + apply to the element: + <code class="no-backref" title="attr-input-accept"><a href="number-state.html#attr-input-accept" id="accept-8">accept</a></code>, + <code class="no-backref" title="attr-input-alt"><a href="number-state.html#attr-input-alt" id="alt-46">alt</a></code>, + <code class="no-backref" title="attr-input-checked"><a href="the-input-element.html#attr-input-checked" id="checked-8">checked</a></code>, + <code class="no-backref" title="attr-fs-formaction"><a href="association-of-controls-and-forms.html#attr-fs-formaction" id="formaction-8">formaction</a></code>, + <code class="no-backref" title="attr-fs-formenctype"><a href="association-of-controls-and-forms.html#attr-fs-formenctype" id="formenctype-8">formenctype</a></code>, + <code class="no-backref" title="attr-fs-formmethod"><a href="association-of-controls-and-forms.html#attr-fs-formmethod" id="formmethod-8">formmethod</a></code>, + <code class="no-backref" title="attr-fs-formnovalidate"><a href="association-of-controls-and-forms.html#attr-fs-formnovalidate" id="formnovalidate-8">formnovalidate</a></code>, + <code class="no-backref" title="attr-fs-formtarget"><a href="association-of-controls-and-forms.html#attr-fs-formtarget" id="formtarget-8">formtarget</a></code>, + <code class="no-backref" title="attr-dim-height"><a href="the-map-element.html#attr-dim-height" id="height-19">height</a></code>, + <code class="no-backref" title="attr-input-maxlength"><a href="common-input-element-attributes.html#attr-input-maxlength" id="maxlength-9">maxlength</a></code>, + <code class="no-backref" title="attr-input-multiple"><a href="common-input-element-attributes.html#attr-input-multiple" id="multiple-9">multiple</a></code>, + <code class="no-backref" title="attr-input-pattern"><a href="common-input-element-attributes.html#attr-input-pattern" id="pattern-9">pattern</a></code>, + <code class="no-backref" title="attr-input-placeholder"><a href="common-input-element-attributes.html#attr-input-placeholder" id="placeholder-8">placeholder</a></code>, + <code class="no-backref" title="attr-input-size"><a href="common-input-element-attributes.html#attr-input-size" id="size-8">size</a></code>, + <code class="no-backref" title="attr-input-src"><a href="number-state.html#attr-input-src" id="src-51">src</a></code>, and + <code class="no-backref" title="attr-dim-width"><a href="the-map-element.html#attr-dim-width" id="width-19">width</a></code>.</p> + + <p>The following IDL attributes and methods do not apply to the + element: + <code class="no-backref" title="dom-input-checked"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-checked" class="full-spec-link" title='Read about this "checked" reference in the full HTML5 spec.'>checked</a></code>, + <code class="no-backref" title="dom-input-files"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-files" class="full-spec-link" title='Read about this "files" reference in the full HTML5 spec.'>files</a></code>, + <code class="no-backref" title="dom-textarea/input-selectionStart"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-selectionstart" class="full-spec-link" title='Read about this "selectionStart" reference in the full HTML5 spec.'>selectionStart</a></code>, and + <code class="no-backref" title="dom-textarea/input-selectionEnd"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-selectionend" class="full-spec-link" title='Read about this "selectionEnd" reference in the full HTML5 spec.'>selectionEnd</a></code> IDL attributes; + <code class="no-backref" title="dom-textarea/input-select"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-select" class="full-spec-link" title='Read about this "select()" reference in the full HTML5 spec.'>select()</a></code> and + <code class="no-backref" title="dom-textarea/input-setSelectionRange"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-setselectionrange" class="full-spec-link" title='Read about this "setSelectionRange()" reference in the full HTML5 spec.'>setSelectionRange()</a></code> methods.</p> + + </div><div class="example"> + + <p>The following fragment shows part of a calendar application. A + user can specify a date and time for a meeting (in his local time + zone, probably, though the user agent can allow the user to change + that), and since the submitted data includes the time-zone offset, + the application can ensure that the meeting is shown at the correct + time regardless of the time zones used by all the participants.</p> + + <pre><fieldset> + <legend>Add Meeting</legend> + <p><label>Meeting name: <input type=text name="meeting.label"></label> + <p><label>Meeting time: <input type=datetime name="meeting.start"></label> +</fieldset></pre> + + <p>Had the application used the <code title="attr-input-type-datetime-local"><a href="#local-date-and-time-state" id="datetime-local">datetime-local</a></code> type + instead, the calendar application would have also had to explicitly + determine which time zone the user intended.</p> + + </div><h6 id="date-state"><span class="secno">4.10.7.1.8 </span><dfn title="attr-input-type-date">Date</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>The <code><a href="the-input-element.html#the-input-element" id="input-73">input</a></code> element <a href="http://dev.w3.org/html5/spec/rendering.html#represents" class="full-spec-link" title='Read about this "represents" reference in the full HTML5 spec.'>represents</a> a control + for setting the element's <a href="http://dev.w3.org/html5/spec/association-of-controls-and-forms.html#concept-fe-value" title='Read about this "value" reference in the full HTML5 spec.' class="full-spec-link">value</a> to a string representing a + specific <a href="common-microsyntaxes.html#concept-date" id="concept-date-0" title="concept-date">date</a>.</p><p>The <code title="attr-input-value"><a href="the-input-element.html#attr-input-value" id="value-15">value</a></code> attribute, if + specified, must have a value that is a <a href="common-microsyntaxes.html#valid-date-string" id="valid-date-string-4">valid date + string</a>.</p><!-- ok to set out-of-range value, we never know + when we might have to represent bogus input --><p>The <code title="attr-input-min"><a href="common-input-element-attributes.html#attr-input-min" id="min-11">min</a></code> attribute, if + specified, must have a value that is a <a href="common-microsyntaxes.html#valid-date-string" id="valid-date-string-5">valid date + string</a>. The <code title="attr-input-max"><a href="common-input-element-attributes.html#attr-input-max" id="max-11">max</a></code> + attribute, if specified, must have a value that is a <a href="common-microsyntaxes.html#valid-date-string" id="valid-date-string-6">valid + date string</a>.</p><p>The <code title="attr-input-step"><a href="common-input-element-attributes.html#attr-input-step" id="step-11">step</a></code> attribute is + expressed in days. The <a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#concept-input-step-default" title='Read about this "default step" reference in the full HTML5 spec.' class="full-spec-link">default step</a> is 1 day.</p><div class="bookkeeping"> + + <p>The following common <code><a href="the-input-element.html#the-input-element" id="input-74">input</a></code> element content + attributes, IDL attributes, and methods apply to the element: + <code title="attr-input-autocomplete"><a href="common-input-element-attributes.html#attr-input-autocomplete" id="autocomplete-13">autocomplete</a></code>, + <code title="attr-input-list"><a href="common-input-element-attributes.html#attr-input-list" id="list-10">list</a></code>, + <code title="attr-input-max"><a href="common-input-element-attributes.html#attr-input-max" id="max-12">max</a></code>, + <code title="attr-input-min"><a href="common-input-element-attributes.html#attr-input-min" id="min-12">min</a></code>, + <code title="attr-input-readonly"><a href="common-input-element-attributes.html#attr-input-readonly" id="readonly-23">readonly</a></code>, + <code title="attr-input-required"><a href="common-input-element-attributes.html#attr-input-required" id="required-10">required</a></code>, and + <code title="attr-input-step"><a href="common-input-element-attributes.html#attr-input-step" id="step-12">step</a></code> content attributes; + <code title="dom-input-list"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-list" class="full-spec-link" title='Read about this "list" reference in the full HTML5 spec.'>list</a></code>, + <code title="dom-input-value"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-value" class="full-spec-link" title='Read about this "value" reference in the full HTML5 spec.'>value</a></code>, + <code title="dom-input-valueAsDate"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-valueasdate" class="full-spec-link" title='Read about this "valueAsDate" reference in the full HTML5 spec.'>valueAsDate</a></code>, + <code title="dom-input-valueAsNumber"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-valueasnumber" class="full-spec-link" title='Read about this "valueAsNumber" reference in the full HTML5 spec.'>valueAsNumber</a></code>, and + <code title="dom-input-selectedOption"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-selectedoption" class="full-spec-link" title='Read about this "selectedOption" reference in the full HTML5 spec.'>selectedOption</a></code> IDL attributes; + <code title="dom-input-stepDown"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-stepdown" class="full-spec-link" title='Read about this "stepDown()" reference in the full HTML5 spec.'>stepDown()</a></code> and + <code title="dom-input-stepUp"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-stepup" class="full-spec-link" title='Read about this "stepUp()" reference in the full HTML5 spec.'>stepUp()</a></code> methods.</p> + + <p>The <code title="dom-input-value"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-value" class="full-spec-link" title='Read about this "value" reference in the full HTML5 spec.'>value</a></code> IDL attribute is + in mode <a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-value-value" title='Read about this "value" reference in the full HTML5 spec.' class="full-spec-link">value</a>.</p> + + <p>The <code title="event-input-input"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#event-input-input" class="full-spec-link" title='Read about this "input" reference in the full HTML5 spec.'>input</a></code> and <code title="event-input-change"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#event-input-change" class="full-spec-link" title='Read about this "change" reference in the full HTML5 spec.'>change</a></code> events apply.</p> + + <p>The following content attributes must not be specified and do not + apply to the element: + <code class="no-backref" title="attr-input-accept"><a href="number-state.html#attr-input-accept" id="accept-9">accept</a></code>, + <code class="no-backref" title="attr-input-alt"><a href="number-state.html#attr-input-alt" id="alt-47">alt</a></code>, + <code class="no-backref" title="attr-input-checked"><a href="the-input-element.html#attr-input-checked" id="checked-9">checked</a></code>, + <code class="no-backref" title="attr-fs-formaction"><a href="association-of-controls-and-forms.html#attr-fs-formaction" id="formaction-9">formaction</a></code>, + <code class="no-backref" title="attr-fs-formenctype"><a href="association-of-controls-and-forms.html#attr-fs-formenctype" id="formenctype-9">formenctype</a></code>, + <code class="no-backref" title="attr-fs-formmethod"><a href="association-of-controls-and-forms.html#attr-fs-formmethod" id="formmethod-9">formmethod</a></code>, + <code class="no-backref" title="attr-fs-formnovalidate"><a href="association-of-controls-and-forms.html#attr-fs-formnovalidate" id="formnovalidate-9">formnovalidate</a></code>, + <code class="no-backref" title="attr-fs-formtarget"><a href="association-of-controls-and-forms.html#attr-fs-formtarget" id="formtarget-9">formtarget</a></code>, + <code class="no-backref" title="attr-dim-height"><a href="the-map-element.html#attr-dim-height" id="height-20">height</a></code>, + <code class="no-backref" title="attr-input-maxlength"><a href="common-input-element-attributes.html#attr-input-maxlength" id="maxlength-10">maxlength</a></code>, + <code class="no-backref" title="attr-input-multiple"><a href="common-input-element-attributes.html#attr-input-multiple" id="multiple-10">multiple</a></code>, + <code class="no-backref" title="attr-input-pattern"><a href="common-input-element-attributes.html#attr-input-pattern" id="pattern-10">pattern</a></code>, + <code class="no-backref" title="attr-input-placeholder"><a href="common-input-element-attributes.html#attr-input-placeholder" id="placeholder-9">placeholder</a></code>, + <code class="no-backref" title="attr-input-size"><a href="common-input-element-attributes.html#attr-input-size" id="size-9">size</a></code>, + <code class="no-backref" title="attr-input-src"><a href="number-state.html#attr-input-src" id="src-52">src</a></code>, and + <code class="no-backref" title="attr-dim-width"><a href="the-map-element.html#attr-dim-width" id="width-20">width</a></code>.</p> + + <p>The following IDL attributes and methods do not apply to the + element: + <code class="no-backref" title="dom-input-checked"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-checked" class="full-spec-link" title='Read about this "checked" reference in the full HTML5 spec.'>checked</a></code>, + <code class="no-backref" title="dom-textarea/input-selectionStart"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-selectionstart" class="full-spec-link" title='Read about this "selectionStart" reference in the full HTML5 spec.'>selectionStart</a></code>, and + <code class="no-backref" title="dom-textarea/input-selectionEnd"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-selectionend" class="full-spec-link" title='Read about this "selectionEnd" reference in the full HTML5 spec.'>selectionEnd</a></code> IDL attributes; + <code class="no-backref" title="dom-textarea/input-select"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-select" class="full-spec-link" title='Read about this "select()" reference in the full HTML5 spec.'>select()</a></code> and + <code class="no-backref" title="dom-textarea/input-setSelectionRange"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-setselectionrange" class="full-spec-link" title='Read about this "setSelectionRange()" reference in the full HTML5 spec.'>setSelectionRange()</a></code> methods.</p> + + </div><h6 id="month-state"><span class="secno">4.10.7.1.9 </span><dfn title="attr-input-type-month">Month</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>The <code><a href="the-input-element.html#the-input-element" id="input-75">input</a></code> element <a href="http://dev.w3.org/html5/spec/rendering.html#represents" class="full-spec-link" title='Read about this "represents" reference in the full HTML5 spec.'>represents</a> a control + for setting the element's <a href="http://dev.w3.org/html5/spec/association-of-controls-and-forms.html#concept-fe-value" title='Read about this "value" reference in the full HTML5 spec.' class="full-spec-link">value</a> to a string representing a + specific <a href="common-microsyntaxes.html#concept-month" id="concept-month-0" title="concept-month">month</a>.</p><p>The <code title="attr-input-value"><a href="the-input-element.html#attr-input-value" id="value-16">value</a></code> attribute, if + specified, must have a value that is a <a href="common-microsyntaxes.html#valid-month-string" id="valid-month-string-1">valid month + string</a>.</p><!-- ok to set out-of-range value, we never know + when we might have to represent bogus input --><p>The <code title="attr-input-min"><a href="common-input-element-attributes.html#attr-input-min" id="min-13">min</a></code> attribute, if + specified, must have a value that is a <a href="common-microsyntaxes.html#valid-month-string" id="valid-month-string-2">valid month + string</a>. The <code title="attr-input-max"><a href="common-input-element-attributes.html#attr-input-max" id="max-13">max</a></code> + attribute, if specified, must have a value that is a <a href="common-microsyntaxes.html#valid-month-string" id="valid-month-string-3">valid + month string</a>.</p><p>The <code title="attr-input-step"><a href="common-input-element-attributes.html#attr-input-step" id="step-13">step</a></code> attribute is + expressed in months. + The <a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#concept-input-step-default" title='Read about this "default step" reference in the full HTML5 spec.' class="full-spec-link">default step</a> is + 1 month.</p><div class="bookkeeping"> + + <p>The following common <code><a href="the-input-element.html#the-input-element" id="input-76">input</a></code> element content + attributes, IDL attributes, and methods apply to the element: + <code title="attr-input-autocomplete"><a href="common-input-element-attributes.html#attr-input-autocomplete" id="autocomplete-14">autocomplete</a></code>, + <code title="attr-input-list"><a href="common-input-element-attributes.html#attr-input-list" id="list-11">list</a></code>, + <code title="attr-input-max"><a href="common-input-element-attributes.html#attr-input-max" id="max-14">max</a></code>, + <code title="attr-input-min"><a href="common-input-element-attributes.html#attr-input-min" id="min-14">min</a></code>, + <code title="attr-input-readonly"><a href="common-input-element-attributes.html#attr-input-readonly" id="readonly-24">readonly</a></code>, + <code title="attr-input-required"><a href="common-input-element-attributes.html#attr-input-required" id="required-11">required</a></code>, and + <code title="attr-input-step"><a href="common-input-element-attributes.html#attr-input-step" id="step-14">step</a></code> content attributes; + <code title="dom-input-list"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-list" class="full-spec-link" title='Read about this "list" reference in the full HTML5 spec.'>list</a></code>, + <code title="dom-input-value"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-value" class="full-spec-link" title='Read about this "value" reference in the full HTML5 spec.'>value</a></code>, + <code title="dom-input-valueAsDate"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-valueasdate" class="full-spec-link" title='Read about this "valueAsDate" reference in the full HTML5 spec.'>valueAsDate</a></code>, + <code title="dom-input-valueAsNumber"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-valueasnumber" class="full-spec-link" title='Read about this "valueAsNumber" reference in the full HTML5 spec.'>valueAsNumber</a></code>, and + <code title="dom-input-selectedOption"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-selectedoption" class="full-spec-link" title='Read about this "selectedOption" reference in the full HTML5 spec.'>selectedOption</a></code> IDL attributes; + <code title="dom-input-stepDown"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-stepdown" class="full-spec-link" title='Read about this "stepDown()" reference in the full HTML5 spec.'>stepDown()</a></code> and + <code title="dom-input-stepUp"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-stepup" class="full-spec-link" title='Read about this "stepUp()" reference in the full HTML5 spec.'>stepUp()</a></code> methods.</p> + + <p>The <code title="dom-input-value"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-value" class="full-spec-link" title='Read about this "value" reference in the full HTML5 spec.'>value</a></code> IDL attribute is + in mode <a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-value-value" title='Read about this "value" reference in the full HTML5 spec.' class="full-spec-link">value</a>.</p> + + <p>The <code title="event-input-input"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#event-input-input" class="full-spec-link" title='Read about this "input" reference in the full HTML5 spec.'>input</a></code> and <code title="event-input-change"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#event-input-change" class="full-spec-link" title='Read about this "change" reference in the full HTML5 spec.'>change</a></code> events apply.</p> + + <p>The following content attributes must not be specified and do not + apply to the element: + <code class="no-backref" title="attr-input-accept"><a href="number-state.html#attr-input-accept" id="accept-10">accept</a></code>, + <code class="no-backref" title="attr-input-alt"><a href="number-state.html#attr-input-alt" id="alt-48">alt</a></code>, + <code class="no-backref" title="attr-input-checked"><a href="the-input-element.html#attr-input-checked" id="checked-10">checked</a></code>, + <code class="no-backref" title="attr-fs-formaction"><a href="association-of-controls-and-forms.html#attr-fs-formaction" id="formaction-10">formaction</a></code>, + <code class="no-backref" title="attr-fs-formenctype"><a href="association-of-controls-and-forms.html#attr-fs-formenctype" id="formenctype-10">formenctype</a></code>, + <code class="no-backref" title="attr-fs-formmethod"><a href="association-of-controls-and-forms.html#attr-fs-formmethod" id="formmethod-10">formmethod</a></code>, + <code class="no-backref" title="attr-fs-formnovalidate"><a href="association-of-controls-and-forms.html#attr-fs-formnovalidate" id="formnovalidate-10">formnovalidate</a></code>, + <code class="no-backref" title="attr-fs-formtarget"><a href="association-of-controls-and-forms.html#attr-fs-formtarget" id="formtarget-10">formtarget</a></code>, + <code class="no-backref" title="attr-dim-height"><a href="the-map-element.html#attr-dim-height" id="height-21">height</a></code>, + <code class="no-backref" title="attr-input-maxlength"><a href="common-input-element-attributes.html#attr-input-maxlength" id="maxlength-11">maxlength</a></code>, + <code class="no-backref" title="attr-input-multiple"><a href="common-input-element-attributes.html#attr-input-multiple" id="multiple-11">multiple</a></code>, + <code class="no-backref" title="attr-input-pattern"><a href="common-input-element-attributes.html#attr-input-pattern" id="pattern-11">pattern</a></code>, + <code class="no-backref" title="attr-input-placeholder"><a href="common-input-element-attributes.html#attr-input-placeholder" id="placeholder-10">placeholder</a></code>, + <code class="no-backref" title="attr-input-size"><a href="common-input-element-attributes.html#attr-input-size" id="size-10">size</a></code>, + <code class="no-backref" title="attr-input-src"><a href="number-state.html#attr-input-src" id="src-53">src</a></code>, and + <code class="no-backref" title="attr-dim-width"><a href="the-map-element.html#attr-dim-width" id="width-21">width</a></code>.</p> + + <p>The following IDL attributes and methods do not apply to the + element: + <code class="no-backref" title="dom-input-checked"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-checked" class="full-spec-link" title='Read about this "checked" reference in the full HTML5 spec.'>checked</a></code>, + <code class="no-backref" title="dom-input-files"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-files" class="full-spec-link" title='Read about this "files" reference in the full HTML5 spec.'>files</a></code>, + <code class="no-backref" title="dom-textarea/input-selectionStart"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-selectionstart" class="full-spec-link" title='Read about this "selectionStart" reference in the full HTML5 spec.'>selectionStart</a></code>, and + <code class="no-backref" title="dom-textarea/input-selectionEnd"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-selectionend" class="full-spec-link" title='Read about this "selectionEnd" reference in the full HTML5 spec.'>selectionEnd</a></code> IDL attributes; + <code class="no-backref" title="dom-textarea/input-select"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-select" class="full-spec-link" title='Read about this "select()" reference in the full HTML5 spec.'>select()</a></code> and + <code class="no-backref" title="dom-textarea/input-setSelectionRange"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-setselectionrange" class="full-spec-link" title='Read about this "setSelectionRange()" reference in the full HTML5 spec.'>setSelectionRange()</a></code> methods.</p> + + </div><h6 id="week-state"><span class="secno">4.10.7.1.10 </span><dfn title="attr-input-type-week">Week</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>The <code><a href="the-input-element.html#the-input-element" id="input-77">input</a></code> element <a href="http://dev.w3.org/html5/spec/rendering.html#represents" class="full-spec-link" title='Read about this "represents" reference in the full HTML5 spec.'>represents</a> a control + for setting the element's <a href="http://dev.w3.org/html5/spec/association-of-controls-and-forms.html#concept-fe-value" title='Read about this "value" reference in the full HTML5 spec.' class="full-spec-link">value</a> to a string representing a + specific <a href="common-microsyntaxes.html#concept-week" id="concept-week-0" title="concept-week">week</a>.</p><p>The <code title="attr-input-value"><a href="the-input-element.html#attr-input-value" id="value-17">value</a></code> attribute, if + specified, must have a value that is a <a href="common-microsyntaxes.html#valid-week-string" id="valid-week-string-0">valid week + string</a>.</p><!-- ok to set out-of-range value, we never know + when we might have to represent bogus input --><p>The <code title="attr-input-min"><a href="common-input-element-attributes.html#attr-input-min" id="min-15">min</a></code> attribute, if + specified, must have a value that is a <a href="common-microsyntaxes.html#valid-week-string" id="valid-week-string-1">valid week + string</a>. The <code title="attr-input-max"><a href="common-input-element-attributes.html#attr-input-max" id="max-15">max</a></code> + attribute, if specified, must have a value that is a <a href="common-microsyntaxes.html#valid-week-string" id="valid-week-string-2">valid + week string</a>.</p><p>The <code title="attr-input-step"><a href="common-input-element-attributes.html#attr-input-step" id="step-15">step</a></code> attribute is + expressed in weeks. The <a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#concept-input-step-default" title='Read about this "default step" reference in the full HTML5 spec.' class="full-spec-link">default step</a> is 1 + week. </p><div class="bookkeeping"> + + <p>The following common <code><a href="the-input-element.html#the-input-element" id="input-78">input</a></code> element content + attributes, IDL attributes, and methods apply to the element: + <code title="attr-input-autocomplete"><a href="common-input-element-attributes.html#attr-input-autocomplete" id="autocomplete-15">autocomplete</a></code>, + <code title="attr-input-list"><a href="common-input-element-attributes.html#attr-input-list" id="list-12">list</a></code>, + <code title="attr-input-max"><a href="common-input-element-attributes.html#attr-input-max" id="max-16">max</a></code>, + <code title="attr-input-min"><a href="common-input-element-attributes.html#attr-input-min" id="min-16">min</a></code>, + <code title="attr-input-readonly"><a href="common-input-element-attributes.html#attr-input-readonly" id="readonly-25">readonly</a></code>, + <code title="attr-input-required"><a href="common-input-element-attributes.html#attr-input-required" id="required-12">required</a></code>, and + <code title="attr-input-step"><a href="common-input-element-attributes.html#attr-input-step" id="step-16">step</a></code> content attributes; + <code title="dom-input-list"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-list" class="full-spec-link" title='Read about this "list" reference in the full HTML5 spec.'>list</a></code>, + <code title="dom-input-value"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-value" class="full-spec-link" title='Read about this "value" reference in the full HTML5 spec.'>value</a></code>, + <code title="dom-input-valueAsDate"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-valueasdate" class="full-spec-link" title='Read about this "valueAsDate" reference in the full HTML5 spec.'>valueAsDate</a></code>, + <code title="dom-input-valueAsNumber"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-valueasnumber" class="full-spec-link" title='Read about this "valueAsNumber" reference in the full HTML5 spec.'>valueAsNumber</a></code>, and + <code title="dom-input-selectedOption"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-selectedoption" class="full-spec-link" title='Read about this "selectedOption" reference in the full HTML5 spec.'>selectedOption</a></code> IDL attributes; + <code title="dom-input-stepDown"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-stepdown" class="full-spec-link" title='Read about this "stepDown()" reference in the full HTML5 spec.'>stepDown()</a></code> and + <code title="dom-input-stepUp"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-stepup" class="full-spec-link" title='Read about this "stepUp()" reference in the full HTML5 spec.'>stepUp()</a></code> methods.</p> + + <p>The <code title="dom-input-value"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-value" class="full-spec-link" title='Read about this "value" reference in the full HTML5 spec.'>value</a></code> IDL attribute is + in mode <a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-value-value" title='Read about this "value" reference in the full HTML5 spec.' class="full-spec-link">value</a>.</p> + + <p>The <code title="event-input-input"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#event-input-input" class="full-spec-link" title='Read about this "input" reference in the full HTML5 spec.'>input</a></code> and <code title="event-input-change"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#event-input-change" class="full-spec-link" title='Read about this "change" reference in the full HTML5 spec.'>change</a></code> events apply.</p> + + <p>The following content attributes must not be specified and do not + apply to the element: + <code class="no-backref" title="attr-input-accept"><a href="number-state.html#attr-input-accept" id="accept-11">accept</a></code>, + <code class="no-backref" title="attr-input-alt"><a href="number-state.html#attr-input-alt" id="alt-49">alt</a></code>, + <code class="no-backref" title="attr-input-checked"><a href="the-input-element.html#attr-input-checked" id="checked-11">checked</a></code>, + <code class="no-backref" title="attr-fs-formaction"><a href="association-of-controls-and-forms.html#attr-fs-formaction" id="formaction-11">formaction</a></code>, + <code class="no-backref" title="attr-fs-formenctype"><a href="association-of-controls-and-forms.html#attr-fs-formenctype" id="formenctype-11">formenctype</a></code>, + <code class="no-backref" title="attr-fs-formmethod"><a href="association-of-controls-and-forms.html#attr-fs-formmethod" id="formmethod-11">formmethod</a></code>, + <code class="no-backref" title="attr-fs-formnovalidate"><a href="association-of-controls-and-forms.html#attr-fs-formnovalidate" id="formnovalidate-11">formnovalidate</a></code>, + <code class="no-backref" title="attr-fs-formtarget"><a href="association-of-controls-and-forms.html#attr-fs-formtarget" id="formtarget-11">formtarget</a></code>, + <code class="no-backref" title="attr-dim-height"><a href="the-map-element.html#attr-dim-height" id="height-22">height</a></code>, + <code class="no-backref" title="attr-input-maxlength"><a href="common-input-element-attributes.html#attr-input-maxlength" id="maxlength-12">maxlength</a></code>, + <code class="no-backref" title="attr-input-multiple"><a href="common-input-element-attributes.html#attr-input-multiple" id="multiple-12">multiple</a></code>, + <code class="no-backref" title="attr-input-pattern"><a href="common-input-element-attributes.html#attr-input-pattern" id="pattern-12">pattern</a></code>, + <code class="no-backref" title="attr-input-placeholder"><a href="common-input-element-attributes.html#attr-input-placeholder" id="placeholder-11">placeholder</a></code>, + <code class="no-backref" title="attr-input-size"><a href="common-input-element-attributes.html#attr-input-size" id="size-11">size</a></code>, + <code class="no-backref" title="attr-input-src"><a href="number-state.html#attr-input-src" id="src-54">src</a></code>, and + <code class="no-backref" title="attr-dim-width"><a href="the-map-element.html#attr-dim-width" id="width-22">width</a></code>.</p> + + <p>The following IDL attributes and methods do not apply to the + element: + <code class="no-backref" title="dom-input-checked"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-checked" class="full-spec-link" title='Read about this "checked" reference in the full HTML5 spec.'>checked</a></code>, + <code class="no-backref" title="dom-input-files"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-files" class="full-spec-link" title='Read about this "files" reference in the full HTML5 spec.'>files</a></code>, + <code class="no-backref" title="dom-textarea/input-selectionStart"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-selectionstart" class="full-spec-link" title='Read about this "selectionStart" reference in the full HTML5 spec.'>selectionStart</a></code>, and + <code class="no-backref" title="dom-textarea/input-selectionEnd"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-selectionend" class="full-spec-link" title='Read about this "selectionEnd" reference in the full HTML5 spec.'>selectionEnd</a></code> IDL attributes; + <code class="no-backref" title="dom-textarea/input-select"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-select" class="full-spec-link" title='Read about this "select()" reference in the full HTML5 spec.'>select()</a></code> and + <code class="no-backref" title="dom-textarea/input-setSelectionRange"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-setselectionrange" class="full-spec-link" title='Read about this "setSelectionRange()" reference in the full HTML5 spec.'>setSelectionRange()</a></code> methods.</p> + + </div><h6 id="time-state"><span class="secno">4.10.7.1.11 </span><dfn title="attr-input-type-time">Time</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><!-- v2: allow min="" and max="" to be set such that the range + crosses midnight, as in <input type=time min="23:00" max="02:00"> + (from http://www.w3.org/Bugs/Public/show_bug.cgi?id=7688) --><p>The <code><a href="the-input-element.html#the-input-element" id="input-79">input</a></code> element <a href="http://dev.w3.org/html5/spec/rendering.html#represents" class="full-spec-link" title='Read about this "represents" reference in the full HTML5 spec.'>represents</a> a control + for setting the element's <a href="http://dev.w3.org/html5/spec/association-of-controls-and-forms.html#concept-fe-value" title='Read about this "value" reference in the full HTML5 spec.' class="full-spec-link">value</a> to a string representing a + specific <a href="common-microsyntaxes.html#concept-time" id="concept-time-0" title="concept-time">time</a>.</p><p>The <code title="attr-input-value"><a href="the-input-element.html#attr-input-value" id="value-18">value</a></code> attribute, if + specified, must have a value that is a <a href="common-microsyntaxes.html#valid-time-string" id="valid-time-string-3">valid time + string</a>.</p><!-- ok to set out-of-range value, we never know + when we might have to represent bogus input --><p>The <code title="attr-input-min"><a href="common-input-element-attributes.html#attr-input-min" id="min-17">min</a></code> attribute, if + specified, must have a value that is a <a href="common-microsyntaxes.html#valid-time-string" id="valid-time-string-4">valid time + string</a>. The <code title="attr-input-max"><a href="common-input-element-attributes.html#attr-input-max" id="max-17">max</a></code> + attribute, if specified, must have a value that is a <a href="common-microsyntaxes.html#valid-time-string" id="valid-time-string-5">valid + time string</a>.</p><p>The <code title="attr-input-step"><a href="common-input-element-attributes.html#attr-input-step" id="step-17">step</a></code> attribute is + expressed in seconds. The <a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#concept-input-step-default" title='Read about this "default step" reference in the full HTML5 spec.' class="full-spec-link">default step</a> is 60 + seconds.</p><div class="bookkeeping"> + + <p>The following common <code><a href="the-input-element.html#the-input-element" id="input-80">input</a></code> element content + attributes, IDL attributes, and methods apply to the element: + <code title="attr-input-autocomplete"><a href="common-input-element-attributes.html#attr-input-autocomplete" id="autocomplete-16">autocomplete</a></code>, + <code title="attr-input-list"><a href="common-input-element-attributes.html#attr-input-list" id="list-13">list</a></code>, + <code title="attr-input-max"><a href="common-input-element-attributes.html#attr-input-max" id="max-18">max</a></code>, + <code title="attr-input-min"><a href="common-input-element-attributes.html#attr-input-min" id="min-18">min</a></code>, + <code title="attr-input-readonly"><a href="common-input-element-attributes.html#attr-input-readonly" id="readonly-26">readonly</a></code>, + <code title="attr-input-required"><a href="common-input-element-attributes.html#attr-input-required" id="required-13">required</a></code>, and + <code title="attr-input-step"><a href="common-input-element-attributes.html#attr-input-step" id="step-18">step</a></code> content attributes; + <code title="dom-input-list"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-list" class="full-spec-link" title='Read about this "list" reference in the full HTML5 spec.'>list</a></code>, + <code title="dom-input-value"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-value" class="full-spec-link" title='Read about this "value" reference in the full HTML5 spec.'>value</a></code>, + <code title="dom-input-valueAsDate"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-valueasdate" class="full-spec-link" title='Read about this "valueAsDate" reference in the full HTML5 spec.'>valueAsDate</a></code>, + <code title="dom-input-valueAsNumber"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-valueasnumber" class="full-spec-link" title='Read about this "valueAsNumber" reference in the full HTML5 spec.'>valueAsNumber</a></code>, and + <code title="dom-input-selectedOption"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-selectedoption" class="full-spec-link" title='Read about this "selectedOption" reference in the full HTML5 spec.'>selectedOption</a></code> IDL attributes; + <code title="dom-input-stepDown"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-stepdown" class="full-spec-link" title='Read about this "stepDown()" reference in the full HTML5 spec.'>stepDown()</a></code> and + <code title="dom-input-stepUp"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-stepup" class="full-spec-link" title='Read about this "stepUp()" reference in the full HTML5 spec.'>stepUp()</a></code> methods.</p> + + <p>The <code title="dom-input-value"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-value" class="full-spec-link" title='Read about this "value" reference in the full HTML5 spec.'>value</a></code> IDL attribute is + in mode <a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-value-value" title='Read about this "value" reference in the full HTML5 spec.' class="full-spec-link">value</a>.</p> + + <p>The <code title="event-input-input"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#event-input-input" class="full-spec-link" title='Read about this "input" reference in the full HTML5 spec.'>input</a></code> and <code title="event-input-change"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#event-input-change" class="full-spec-link" title='Read about this "change" reference in the full HTML5 spec.'>change</a></code> events apply.</p> + + <p>The following content attributes must not be specified and do not + apply to the element: + <code class="no-backref" title="attr-input-accept"><a href="number-state.html#attr-input-accept" id="accept-12">accept</a></code>, + <code class="no-backref" title="attr-input-alt"><a href="number-state.html#attr-input-alt" id="alt-50">alt</a></code>, + <code class="no-backref" title="attr-input-checked"><a href="the-input-element.html#attr-input-checked" id="checked-12">checked</a></code>, + <code class="no-backref" title="attr-fs-formaction"><a href="association-of-controls-and-forms.html#attr-fs-formaction" id="formaction-12">formaction</a></code>, + <code class="no-backref" title="attr-fs-formenctype"><a href="association-of-controls-and-forms.html#attr-fs-formenctype" id="formenctype-12">formenctype</a></code>, + <code class="no-backref" title="attr-fs-formmethod"><a href="association-of-controls-and-forms.html#attr-fs-formmethod" id="formmethod-12">formmethod</a></code>, + <code class="no-backref" title="attr-fs-formnovalidate"><a href="association-of-controls-and-forms.html#attr-fs-formnovalidate" id="formnovalidate-12">formnovalidate</a></code>, + <code class="no-backref" title="attr-fs-formtarget"><a href="association-of-controls-and-forms.html#attr-fs-formtarget" id="formtarget-12">formtarget</a></code>, + <code class="no-backref" title="attr-dim-height"><a href="the-map-element.html#attr-dim-height" id="height-23">height</a></code>, + <code class="no-backref" title="attr-input-maxlength"><a href="common-input-element-attributes.html#attr-input-maxlength" id="maxlength-13">maxlength</a></code>, + <code class="no-backref" title="attr-input-multiple"><a href="common-input-element-attributes.html#attr-input-multiple" id="multiple-13">multiple</a></code>, + <code class="no-backref" title="attr-input-pattern"><a href="common-input-element-attributes.html#attr-input-pattern" id="pattern-13">pattern</a></code>, + <code class="no-backref" title="attr-input-placeholder"><a href="common-input-element-attributes.html#attr-input-placeholder" id="placeholder-12">placeholder</a></code>, + <code class="no-backref" title="attr-input-size"><a href="common-input-element-attributes.html#attr-input-size" id="size-12">size</a></code>, + <code class="no-backref" title="attr-input-src"><a href="number-state.html#attr-input-src" id="src-55">src</a></code>, and + <code class="no-backref" title="attr-dim-width"><a href="the-map-element.html#attr-dim-width" id="width-23">width</a></code>.</p> + + <p>The following IDL attributes and methods do not apply to the + element: + <code class="no-backref" title="dom-input-checked"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-checked" class="full-spec-link" title='Read about this "checked" reference in the full HTML5 spec.'>checked</a></code>, + <code class="no-backref" title="dom-input-files"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-files" class="full-spec-link" title='Read about this "files" reference in the full HTML5 spec.'>files</a></code>, + <code class="no-backref" title="dom-textarea/input-selectionStart"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-selectionstart" class="full-spec-link" title='Read about this "selectionStart" reference in the full HTML5 spec.'>selectionStart</a></code>, and + <code class="no-backref" title="dom-textarea/input-selectionEnd"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-selectionend" class="full-spec-link" title='Read about this "selectionEnd" reference in the full HTML5 spec.'>selectionEnd</a></code> IDL attributes; + <code class="no-backref" title="dom-textarea/input-select"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-select" class="full-spec-link" title='Read about this "select()" reference in the full HTML5 spec.'>select()</a></code> and + <code class="no-backref" title="dom-textarea/input-setSelectionRange"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-setselectionrange" class="full-spec-link" title='Read about this "setSelectionRange()" reference in the full HTML5 spec.'>setSelectionRange()</a></code> methods.</p> + + </div><h6 id="local-date-and-time-state"><span class="secno">4.10.7.1.12 </span><dfn title="attr-input-type-datetime-local">Local Date and Time</dfn> state</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>The <code><a href="the-input-element.html#the-input-element" id="input-81">input</a></code> element <a href="http://dev.w3.org/html5/spec/rendering.html#represents" class="full-spec-link" title='Read about this "represents" reference in the full HTML5 spec.'>represents</a> a control + for setting the element's <a href="http://dev.w3.org/html5/spec/association-of-controls-and-forms.html#concept-fe-value" title='Read about this "value" reference in the full HTML5 spec.' class="full-spec-link">value</a> to a string representing a + <a href="common-microsyntaxes.html#concept-datetime-local" id="concept-datetime-local-0" title="concept-datetime-local">local date and time</a>, + with no time-zone offset information.</p><p>The <code title="attr-input-value"><a href="the-input-element.html#attr-input-value" id="value-19">value</a></code> attribute, if + specified, must have a value that is a <a href="common-microsyntaxes.html#valid-local-date-and-time-string" id="valid-local-date-and-time-string-0">valid local date and + time string</a>.</p><!-- ok to set out-of-range value, we never + know when we might have to represent bogus input --><p>The <code title="attr-input-min"><a href="common-input-element-attributes.html#attr-input-min" id="min-19">min</a></code> attribute, if + specified, must have a value that is a <a href="common-microsyntaxes.html#valid-local-date-and-time-string" id="valid-local-date-and-time-string-1">valid local date and + time string</a>. The <code title="attr-input-max"><a href="common-input-element-attributes.html#attr-input-max" id="max-19">max</a></code> + attribute, if specified, must have a value that is a <a href="common-microsyntaxes.html#valid-local-date-and-time-string" id="valid-local-date-and-time-string-2">valid + local date and time string</a>.</p><p>The <code title="attr-input-step"><a href="common-input-element-attributes.html#attr-input-step" id="step-19">step</a></code> attribute is + expressed in seconds. The <a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#concept-input-step-default" title='Read about this "default step" reference in the full HTML5 spec.' class="full-spec-link">default step</a> is 60 + seconds.</p><div class="bookkeeping"> + + <p>The following common <code><a href="the-input-element.html#the-input-element" id="input-82">input</a></code> element content + attributes, IDL attributes, and methods apply to the element: + <code title="attr-input-autocomplete"><a href="common-input-element-attributes.html#attr-input-autocomplete" id="autocomplete-17">autocomplete</a></code>, + <code title="attr-input-list"><a href="common-input-element-attributes.html#attr-input-list" id="list-14">list</a></code>, + <code title="attr-input-max"><a href="common-input-element-attributes.html#attr-input-max" id="max-20">max</a></code>, + <code title="attr-input-min"><a href="common-input-element-attributes.html#attr-input-min" id="min-20">min</a></code>, + <code title="attr-input-readonly"><a href="common-input-element-attributes.html#attr-input-readonly" id="readonly-27">readonly</a></code>, + <code title="attr-input-required"><a href="common-input-element-attributes.html#attr-input-required" id="required-14">required</a></code>, and + <code title="attr-input-step"><a href="common-input-element-attributes.html#attr-input-step" id="step-20">step</a></code> content attributes; + <code title="dom-input-list"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-list" class="full-spec-link" title='Read about this "list" reference in the full HTML5 spec.'>list</a></code>, + <code title="dom-input-value"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-value" class="full-spec-link" title='Read about this "value" reference in the full HTML5 spec.'>value</a></code>, + <code title="dom-input-valueAsNumber"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-valueasnumber" class="full-spec-link" title='Read about this "valueAsNumber" reference in the full HTML5 spec.'>valueAsNumber</a></code>, and + <code title="dom-input-selectedOption"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-selectedoption" class="full-spec-link" title='Read about this "selectedOption" reference in the full HTML5 spec.'>selectedOption</a></code> IDL attributes; + <code title="dom-input-stepDown"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-stepdown" class="full-spec-link" title='Read about this "stepDown()" reference in the full HTML5 spec.'>stepDown()</a></code> and + <code title="dom-input-stepUp"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-stepup" class="full-spec-link" title='Read about this "stepUp()" reference in the full HTML5 spec.'>stepUp()</a></code> methods.</p> + + <p>The <code title="dom-input-value"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-value" class="full-spec-link" title='Read about this "value" reference in the full HTML5 spec.'>value</a></code> IDL attribute is + in mode <a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-value-value" title='Read about this "value" reference in the full HTML5 spec.' class="full-spec-link">value</a>.</p> + + <p>The <code title="event-input-input"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#event-input-input" class="full-spec-link" title='Read about this "input" reference in the full HTML5 spec.'>input</a></code> and <code title="event-input-change"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#event-input-change" class="full-spec-link" title='Read about this "change" reference in the full HTML5 spec.'>change</a></code> events apply.</p> + + <p>The following content attributes must not be specified and do not + apply to the element: + <code class="no-backref" title="attr-input-accept"><a href="number-state.html#attr-input-accept" id="accept-13">accept</a></code>, + <code class="no-backref" title="attr-input-alt"><a href="number-state.html#attr-input-alt" id="alt-51">alt</a></code>, + <code class="no-backref" title="attr-input-checked"><a href="the-input-element.html#attr-input-checked" id="checked-13">checked</a></code>, + <code class="no-backref" title="attr-fs-formaction"><a href="association-of-controls-and-forms.html#attr-fs-formaction" id="formaction-13">formaction</a></code>, + <code class="no-backref" title="attr-fs-formenctype"><a href="association-of-controls-and-forms.html#attr-fs-formenctype" id="formenctype-13">formenctype</a></code>, + <code class="no-backref" title="attr-fs-formmethod"><a href="association-of-controls-and-forms.html#attr-fs-formmethod" id="formmethod-13">formmethod</a></code>, + <code class="no-backref" title="attr-fs-formnovalidate"><a href="association-of-controls-and-forms.html#attr-fs-formnovalidate" id="formnovalidate-13">formnovalidate</a></code>, + <code class="no-backref" title="attr-fs-formtarget"><a href="association-of-controls-and-forms.html#attr-fs-formtarget" id="formtarget-13">formtarget</a></code>, + <code class="no-backref" title="attr-dim-height"><a href="the-map-element.html#attr-dim-height" id="height-24">height</a></code>, + <code class="no-backref" title="attr-input-maxlength"><a href="common-input-element-attributes.html#attr-input-maxlength" id="maxlength-14">maxlength</a></code>, + <code class="no-backref" title="attr-input-multiple"><a href="common-input-element-attributes.html#attr-input-multiple" id="multiple-14">multiple</a></code>, + <code class="no-backref" title="attr-input-pattern"><a href="common-input-element-attributes.html#attr-input-pattern" id="pattern-14">pattern</a></code>, + <code class="no-backref" title="attr-input-placeholder"><a href="common-input-element-attributes.html#attr-input-placeholder" id="placeholder-13">placeholder</a></code>, + <code class="no-backref" title="attr-input-size"><a href="common-input-element-attributes.html#attr-input-size" id="size-13">size</a></code>, + <code class="no-backref" title="attr-input-src"><a href="number-state.html#attr-input-src" id="src-56">src</a></code>, and + <code class="no-backref" title="attr-dim-width"><a href="the-map-element.html#attr-dim-width" id="width-24">width</a></code>.</p> + + <p>The following IDL attributes and methods do not apply to the + element: + <code class="no-backref" title="dom-input-checked"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-checked" class="full-spec-link" title='Read about this "checked" reference in the full HTML5 spec.'>checked</a></code>, + <code class="no-backref" title="dom-input-files"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-files" class="full-spec-link" title='Read about this "files" reference in the full HTML5 spec.'>files</a></code>, + <code class="no-backref" title="dom-textarea/input-selectionStart"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-selectionstart" class="full-spec-link" title='Read about this "selectionStart" reference in the full HTML5 spec.'>selectionStart</a></code>, + <code class="no-backref" title="dom-textarea/input-selectionEnd"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-selectionend" class="full-spec-link" title='Read about this "selectionEnd" reference in the full HTML5 spec.'>selectionEnd</a></code>, and + <code class="no-backref" title="dom-input-valueAsDate"><a href="http://dev.w3.org/html5/spec/common-input-element-attributes.html#dom-input-valueasdate" class="full-spec-link" title='Read about this "valueAsDate" reference in the full HTML5 spec.'>valueAsDate</a></code> IDL attributes; + <code class="no-backref" title="dom-textarea/input-select"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-select" class="full-spec-link" title='Read about this "select()" reference in the full HTML5 spec.'>select()</a></code> and + <code class="no-backref" title="dom-textarea/input-setSelectionRange"><a href="http://dev.w3.org/html5/spec/editing.html#dom-textarea-input-setselectionrange" class="full-spec-link" title='Read about this "setSelectionRange()" reference in the full HTML5 spec.'>setSelectionRange()</a></code> methods.</p> + + </div><div class="example"> + + <p>The following example shows part of a flight booking + application. The application uses an <code><a href="the-input-element.html#the-input-element" id="input-83">input</a></code> element + with its <code title="attr-input-type"><a href="the-input-element.html#attr-input-type" id="type-62">type</a></code> attribute set to + <code title="attr-input-type-datetime-local"><a href="#local-date-and-time-state" id="datetime-local-0">datetime-local</a></code>, + and it then interprets the given date and time in the time zone of + the selected airport.</p> + + <pre><fieldset> + <legend>Destination</legend> + <p><label>Airport: <input type=text name=to list=airports></label></p> + <p><label>Departure time: <input type=datetime-local name=totime step=3600></label></p> +</fieldset> +<datalist id=airports> + <option value=ATL label="Atlanta"> + <option value=MEM label="Memphis"> + <option value=LHR label="London Heathrow"> + <option value=LAX label="Los Angeles"> + <option value=FRA label="Frankfurt"> +</datalist></pre> + + <p>If the application instead used the <code title="attr-input-type-datetime"><a href="#date-and-time-state" id="datetime">datetime</a></code> type, then the + user would have to work out the time-zone conversions himself, + which is clearly not a good user experience!</p> + + </div></body></html> \ No newline at end of file Index: spec.html =================================================================== RCS file: /sources/public/html5/spec-author-view/spec.html,v retrieving revision 1.1075 retrieving revision 1.1076 diff -u -d -r1.1075 -r1.1076 --- spec.html 18 Aug 2010 13:02:29 -0000 1.1075 +++ spec.html 18 Aug 2010 13:10:23 -0000 1.1076 @@ -45160,4 +45160,6380 @@ <a href="#required-23"><span class="secno">4.10.7.1.21 </span><span title="attr-input-type-reset">Reset Button</span> state</a> </dd> <dd> -<a href="#required-24"><span class="secno">4.10.7.1.22 </span><span title="attr-input-type-button">B \ No newline at end of file +<a href="#required-24"><span class="secno">4.10.7.1.22 </span><span title="attr-input-type-button">Button</span> state</a> +</dd> +<dd> +<a href="#required-25"><span class="secno">4.10.7.2.5 </span>The <code title="attr-input-required"><span>required</span></code> attribute</a> +</dd> +<dd> [...6351 lines suppressed...] + ("<code title="">foo</code>" vs <code>foo</code>) + v2 * make the spec consistent about whether the word "algorithm" is part of + an algorithm's name or not ("</dfn> algorithm", "</span> algorithm") + v2 * make the spec more consistent about its use of "hexadecimal" + and "base-sixteen", the order that 0-9 A-Z a-z is mentioned, + and the detail to which the spec explains how to interpret a + string as a hexadecimal number. + v2 * become more consistent about what markup we use to mark up + productions (nothing? <i>? <code>?) + v2 * use <code>Document</code> consistently instead of 'document'. + v2 * s/raise/throw/g + v2 * be clearer about arrays/lists/collections being zero-based + despite using the term "/index/th". + v2 * use the sample widgets: + <li><img alt="A text field with editable sections for each + value, with a button to pop up a dialog showing a calendar or + clock." src="sample-datetime-ui-2"></li> + <li><img alt="A calendar grid with a clock in the upper right + hand corner." src="sample-datetime-ui-3"></li> +--></body></html>
Received on Wednesday, 18 August 2010 13:10:34 UTC