- From: Michael Smith via cvs-syncmail <cvsmail@w3.org>
- Date: Sun, 03 Jan 2010 15:10:33 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec-author-view In directory hutz:/tmp/cvs-serv28163 Modified Files: Overview.html acknowledgements.html apis-in-html-documents.html common-microsyntaxes.html content-models.html dom.html elements.html embedded-content-1.html history.html index.html infrastructure.html introduction.html microdata.html named-character-references.html no.html obsolete.html semantics.html spec.html Log Message: typo (whatwg r4456) [updated by splitter] [updated by splitter] Index: infrastructure.html =================================================================== RCS file: /sources/public/html5/spec-author-view/infrastructure.html,v retrieving revision 1.555 retrieving revision 1.556 diff -u -d -r1.555 -r1.556 --- infrastructure.html 1 Jan 2010 06:10:28 -0000 1.555 +++ infrastructure.html 3 Jan 2010 15:10:30 -0000 1.556 @@ -1,439 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"> -<!DOCTYPE html> -<!-- when publishing, change bits marked ZZZ --><html lang="en-US-x-Hixie" class="split chapter"><head><title>2 Common infrastructure — HTML5 (Author Edition)</title><script src="link-fixup.js"></script><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 { 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: #EEFFEE; } - 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; } - - 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; } - - .tall-and-narrow { - font-size: 0.6em; - column-width: 25em; - column-gap: 1em; - -moz-column-width: 25em; - -moz-column-gap: 1em; - -webkit-column-width: 25em; - -webkit-column-gap: 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; } - - #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: 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; } - - #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; } - - </style><link href="data:text/css," rel="stylesheet" title="Complete specification"><link href="data:text/css,.impl%20%7B%20display:%20none;%20%7D" rel="alternate stylesheet" title="Author documentation only"><link href="data:text/css,.impl%20%7B%20background:%20%23FFEEEE;%20%7D" rel="alternate stylesheet" title="Highlight implementation requirements"><link href="data:text/css," id="complete" rel="stylesheet" title="Complete specification"><link href="data:text/css,.impl%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" id="highlight" rel="alternate stylesheet" title="Highlight implementation requirements"><script> - 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', 'http://www.whatwg.org/specs/web-apps/current-work/' + 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); - // load('reviewer.js'); // would need cross-site XHR - if (document.getElementById('head')) - load('toc.js'); - - // load('updater.js'); // would need cross-site XHR - load('dfn.js'); - // load('status.js'); // would need cross-site XHR - 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="introduction.html" title="1 Introduction" rel="prev"> - <link href="Overview.html#contents" title="Table of contents" rel="index"> - <link href="common-microsyntaxes.html" title="2.4 Common microsyntaxes" 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 (Author Edition)</h1> - </div><div> - <a href="introduction.html">← 1 Introduction</a> – - <a href="Overview.html#contents">Table of contents</a> – - <a href="common-microsyntaxes.html">2.4 Common microsyntaxes →</a> - <ol class="toc"><li><a href="infrastructure.html#infrastructure"><span class="secno">2 </span>Common infrastructure</a> - <ol><li><a href="infrastructure.html#terminology"><span class="secno">2.1 </span>Terminology</a> - <ol><li><a href="infrastructure.html#resources"><span class="secno">2.1.1 </span>Resources</a></li><li><a href="infrastructure.html#xml"><span class="secno">2.1.2 </span>XML</a></li><li><a href="infrastructure.html#dom-trees"><span class="secno">2.1.3 </span>DOM trees</a></li><li><a href="infrastructure.html#scripting-0"><span class="secno">2.1.4 </span>Scripting</a></li><li><a href="infrastructure.html#plugins"><span class="secno">2.1.5 </span>Plugins</a></li><li><a href="infrastructure.html#character-encodings"><span class="secno">2.1.6 </span>Character encodings</a></li></ol></li><li><a href="infrastructure.html#conformance-requirements"><span class="secno">2.2 </span>Conformance requirements</a></li><li><a href="infrastructure.html#case-sensitivity-and-string-comparison"><span class="secno">2.3 </span>Case-sensitivity and string comparison</a></li></ol></li></ol></div> - - <h2 id="infrastructure"><span class="secno">2 </span>Common infrastructure</h2><h3 id="terminology"><span class="secno">2.1 </span>Terminology</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>This specification refers to both HTML and XML attributes and IDL - attributes, often in the same context. When it is not clear which is - being referred to, they are referred to as <dfn title="">content - attributes</dfn> for HTML and XML attributes, and <dfn title="">IDL - attributes</dfn> for those defined on IDL interfaces. Similarly, the - term "properties" is used for both JavaScript object properties and - CSS properties. When these are ambiguous they are qualified as <dfn title="">object properties</dfn> and <dfn title="">CSS - properties</dfn> respectively.</p><p>Generally, when the specification states that a feature applies - to <a href="syntax.html#syntax">the HTML syntax</a> or <a href="the-xhtml-syntax.html#the-xhtml-syntax">the XHTML syntax</a>, it - also includes the other. When a feature specifically only applies to - one of the two languages, it is called out by explicitly stating - that it does not apply to the other format, as in "for HTML, - ... (this does not apply to XHTML)".</p><p>This specification uses the term <dfn title="">document</dfn> to - refer to any use of HTML, ranging from short static documents to - long essays or reports with rich multimedia, as well as to - fully-fledged interactive applications.</p><p>For simplicity, terms such as <dfn title="">shown</dfn>, <dfn title="">displayed</dfn>, and <dfn title="">visible</dfn> might - sometimes be used when referring to the way a document is rendered - to the user. These terms are not meant to imply a visual medium; - they must be considered to apply to other media in equivalent - ways.</p><p>When an algorithm B says to return to another algorithm A, it - implies that A called B. Upon returning to A, the implementation - must continue from where it left off in calling B.</p><h4 id="resources"><span class="secno">2.1.1 </span>Resources</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>The specification uses the term <dfn title="">supported</dfn> - when referring to whether a user agent has an implementation capable - of decoding the semantics of an external resource. A format or type - is said to be <i>supported</i> if the implementation can process an - external resource of that format or type without critical aspects of - the resource being ignored. Whether a specific resource is - <i>supported</i> can depend on what features of the resource's - format are in use.</p><p class="example">For example, a PNG image would be considered to - be in a supported format if its pixel data could be decoded and - rendered, even if, unbeknownst to the implementation, the image also - contained animation data.</p><p class="example">A MPEG4 video file would not be considered to be - in a supported format if the compression format used was not - supported, even if the implementation could determine the dimensions - of the movie from the file's metadata.</p><p>The term <dfn id="mime-type">MIME type</dfn> is used to refer to what is - sometimes called an <i>Internet media type</i> in protocol - literature. The term <i>media type</i> in this specification is used - to refer to the type of media intended for presentation, as used by - the CSS specifications. <a href="references.html#refsRFC2046">[RFC2046]</a> <a href="references.html#refsMQ">[MQ]</a></p><p>A string is a <dfn id="valid-mime-type">valid MIME type</dfn> if it matches the <code title="">media-type</code> rule defined in section 3.7 "Media - Types" of RFC 2616. <a href="references.html#refsHTTP">[HTTP]</a></p><h4 id="xml"><span class="secno">2.1.2 </span>XML</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p id="html-namespace">To ease migration from HTML to XHTML, UAs - conforming to this specification will place elements in HTML in the - <code>http://www.w3.org/1999/xhtml</code> namespace, at least for - the purposes of the DOM and CSS. The term "<dfn id="html-elements">HTML - elements</dfn>", when used in this specification, refers to any - element in that namespace, and thus refers to both HTML and XHTML - elements.</p><p>Except where otherwise stated, all elements defined or mentioned - in this specification are in the - <code>http://www.w3.org/1999/xhtml</code> namespace, and all - attributes defined or mentioned in this specification have no - namespace.</p><p>Attribute names are said to be <dfn id="xml-compatible">XML-compatible</dfn> if they - match the <a href="http://www.w3.org/TR/REC-xml/#NT-Name"><code title="">Name</code></a> production defined in XML, they contain no - U+003A COLON characters (:), and their first three characters are - not an <a href="#ascii-case-insensitive">ASCII case-insensitive</a> match for the string - "<code title="">xml</code>". <a href="references.html#refsXML">[XML]</a></p><p>The term <dfn id="xml-mime-type">XML MIME type</dfn> is used to refer to the <a href="#mime-type" title="MIME type">MIME types</a> <code title="">text/xml</code>, - <code title="">application/xml</code>, and any <a href="#mime-type">MIME - type</a> whose subtype ends with the four characters "<code title="">+xml</code>". <a href="references.html#refsRFC3023">[RFC3023]</a></p><h4 id="dom-trees"><span class="secno">2.1.3 </span>DOM trees</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>The term <dfn id="root-element">root element</dfn>, when not explicitly qualified - as referring to the document's root element, means the furthest - ancestor element node of whatever node is being discussed, or the - node itself if it has no ancestors. When the node is a part of the - document, then that is indeed the document's root element; however, - if the node is not currently part of the document tree, the root - element will be an orphaned node.</p><p>A node's <dfn id="home-subtree">home subtree</dfn> is the subtree rooted at that - node's <a href="#root-element">root element</a>.</p><p>The <code>Document</code> of a <code>Node</code> (such as an - element) is the <code>Document</code> that the <code>Node</code>'s - <code title="">ownerDocument</code> IDL attribute returns.</p><p>When an element's <a href="#root-element">root element</a> is the <a href="#root-element">root - element</a> of a <code>Document</code>, it is said to be <dfn id="in-a-document">in - a <code>Document</code></dfn>. An element is said to have been <dfn id="insert-an-element-into-a-document" title="insert an element into a document">inserted into a - document</dfn> when its <a href="#root-element">root element</a> changes and is now - the document's <a href="#root-element">root element</a>. Analogously, an element is - said to have been <dfn id="remove-an-element-from-a-document" title="remove an element from a - document">removed from a document</dfn> when its <a href="#root-element">root - element</a> changes from being the document's <a href="#root-element">root - element</a> to being another element.</p><p>If a <code>Node</code> is <a href="#in-a-document">in a <code>Document</code></a> - then that <code>Document</code> is always the <code>Node</code>'s - <code>Document</code>, and the <code>Node</code>'s <code title="">ownerDocument</code> IDL attribute thus always returns that - <code>Document</code>.</p><p>The term <dfn id="tree-order">tree order</dfn> means a pre-order, depth-first - traversal of DOM nodes involved (through the <code title="">parentNode</code>/<code title="">childNodes</code> - relationship).</p><p>When it is stated that some element or attribute is <dfn id="ignore" title="ignore">ignored</dfn>, or treated as some other value, or - handled as if it was something else, this refers only to the - processing of the node after it is in the DOM. </p><p>The term <dfn id="text-node">text node</dfn> refers to any <code>Text</code> - node, including <code>CDATASection</code> nodes; specifically, any - <code>Node</code> with node type <code title="">TEXT_NODE</code> (3) - or <code title="">CDATA_SECTION_NODE</code> (4). <a href="references.html#refsDOMCORE">[DOMCORE]</a></p><p>A content attribute is said to <dfn title="">change</dfn> value - only if its new value is different than its previous value; setting - an attribute to a value it already has does not change it.</p><h4 id="scripting-0"><span class="secno">2.1.4 </span>Scripting</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>The construction "a <code>Foo</code> object", where - <code>Foo</code> is actually an interface, is sometimes used instead - of the more accurate "an object implementing the interface - <code>Foo</code>".</p><p>An IDL attribute is said to be <dfn title="">getting</dfn> when - its value is being retrieved (e.g. by author script), and is said to - be <dfn title="">setting</dfn> when a new value is assigned to - it.</p><p>If a DOM object is said to be <dfn id="live">live</dfn>, then that means - that any attributes returning that object always return the same object (not a new - object each time), and the attributes and methods on that object - operate on the actual underlying - data, not a snapshot of the data.</p><p>The terms <dfn title="">fire</dfn> and <dfn title="">dispatch</dfn> are used interchangeably in the context of - events, as in the DOM Events specifications. The term <dfn id="concept-events-trusted" title="concept-events-trusted">trusted event</dfn> is used as - defined by the DOM Events specification. <!-- - http://krijnhoetmer.nl/irc-logs/webapps/20091218 --> <a href="references.html#refsDOMEVENTS">[DOMEVENTS]</a></p><h4 id="plugins"><span class="secno">2.1.5 </span>Plugins</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>The term <dfn id="plugin">plugin</dfn> is used to mean any content handler - for Web content types that are either not supported by the user - agent natively or that do not expose a DOM, which supports rendering - the content as part of the user agent's interface.</p><p>Typically such content handlers are provided by third - parties.</p><p class="example">One example of a plugin would be a PDF viewer - that is instantiated in a <a href="browsers.html#browsing-context">browsing context</a> when the - user navigates to a PDF file. This would count as a plugin - regardless of whether the party that implemented the PDF viewer - component was the same as that which implemented the user agent - itself. However, a PDF viewer application that launches separate - from the user agent (as opposed to using the same interface) is not - a plugin by this definition.</p><p class="note">This specification does not define a mechanism for - interacting with plugins, as it is expected to be user-agent- and - platform-specific. Some UAs might opt to support a plugin mechanism - such as the Netscape Plugin API; others might use remote content - converters or have built-in support for certain types. <a href="references.html#refsNPAPI">[NPAPI]</a></p><p class="warning">Browsers should take extreme care when - interacting with external content intended for <a href="#plugin" title="plugin">plugins</a>. When third-party software is run with - the same privileges as the user agent itself, vulnerabilities in the - third-party software become as dangerous as those in the user - agent.</p><h4 id="character-encodings"><span class="secno">2.1.6 </span>Character encodings</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>The <dfn id="preferred-mime-name">preferred MIME name</dfn> of a character encoding is the - name or alias labeled as "preferred MIME name" in the IANA - <cite>Character Sets</cite> registry, if there is one, or the - encoding's name, if none of the aliases are so labeled. <a href="references.html#refsIANACHARSET">[IANACHARSET]</a></p><p>An <dfn id="ascii-compatible-character-encoding">ASCII-compatible character encoding</dfn> is a - single-byte or variable-length encoding in which the bytes 0x09, - 0x0A, 0x0C, 0x0D, 0x20 - 0x22, 0x26, 0x27, 0x2C - 0x3F, 0x41 - 0x5A, - and 0x61 - 0x7A<!-- is that list ok? do any character sets we want - to support do things outside that range? -->, ignoring bytes that - are the second and later bytes of multibyte sequences, all - correspond to single-byte sequences that map to the same Unicode - characters as those bytes in ANSI_X3.4-1968 (US-ASCII). <a href="references.html#refsRFC1345">[RFC1345]</a></p><p class="note">This includes such encodings as Shift_JIS, - HZ-GB-2312, and variants of ISO-2022, even though it is possible in - these encodings for bytes like 0x70 to be part of longer sequences - that are unrelated to their interpretation as ASCII. It excludes - such encodings as UTF-7, UTF-16, GSM03.38, and EBCDIC variants.</p><!-- - We'll have to change that if anyone comes up with a way to have a - document that is valid as two different encodings at once, with - different <meta charset> elements applying in each case. - --><p>The term <dfn title="">Unicode character</dfn> is used to mean a - <i title="">Unicode scalar value</i> (i.e. any Unicode code point - that is not a surrogate code point). <a href="references.html#refsUNICODE">[UNICODE]</a></p><h3 id="conformance-requirements"><span class="secno">2.2 </span>Conformance requirements</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>All diagrams, examples, and notes in this specification are - non-normative, as are all sections explicitly marked non-normative. - Everything else in this specification is normative.</p><p>The key words "MUST", "MUST NOT", "REQUIRED", <!--"SHALL", "SHALL - NOT",--> "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and - "OPTIONAL" in the normative parts of this document are to be - interpreted as described in RFC2119. For readability, these words do - not appear in all uppercase letters in this specification. <a href="references.html#refsRFC2119">[RFC2119]</a></p><p>This specification describes the conformance criteria for user agents (relevant to implementors) and (relevant to authors and authoring tool - implementors)</p><p>For compatibility with existing content and prior specifications, - this specification describes two authoring formats: one based on XML - (referred to as <a href="the-xhtml-syntax.html#the-xhtml-syntax">the XHTML syntax</a>), and one using a <a href="syntax.html#writing">custom format</a> inspired by SGML (referred to as - <a href="syntax.html#syntax">the HTML syntax</a>). </p><p id="authors-using-xhtml">XML documents that use elements or - attributes from the <a href="#html-namespace-0">HTML namespace</a> and that are served - over the wire (e.g. by HTTP) must be sent using an <a href="#xml-mime-type">XML MIME - type</a> such as <code>application/xml</code> or - <code><a href="iana.html#application-xhtml-xml">application/xhtml+xml</a></code> and must not be served as - <code><a href="iana.html#text-html">text/html</a></code>. <a href="references.html#refsRFC3023">[RFC3023]</a></p><p id="authors-using-html">Documents that use <a href="syntax.html#syntax">the HTML - syntax</a>, if they are served over the wire (e.g. by HTTP) must - be labeled with the <code><a href="iana.html#text-html">text/html</a></code> <a href="#mime-type">MIME - type</a>.</p><h3 id="case-sensitivity-and-string-comparison"><span class="secno">2.3 </span>Case-sensitivity and string comparison</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>Comparing two strings in a <dfn id="case-sensitive">case-sensitive</dfn> manner means - comparing them exactly, code point for code point.</p><p>Comparing two strings in an <dfn id="ascii-case-insensitive">ASCII case-insensitive</dfn> - manner means comparing them exactly, code point for code point, except - that the characters in the range U+0041 to U+005A (i.e. LATIN - CAPITAL LETTER A to LATIN CAPITAL LETTER Z) and the corresponding - characters in the range U+0061 to U+007A (i.e. LATIN SMALL LETTER A - to LATIN SMALL LETTER Z) are considered to also match.</p><p>Comparing two strings in a <dfn id="compatibility-caseless">compatibility caseless</dfn> - manner means using the Unicode <i>compatibility caseless match</i> - operation to compare the two strings. <a href="references.html#refsUNICODE">[UNICODE]</a></p><p>A string <var title="">pattern</var> is a <dfn id="prefix-match">prefix match</dfn> - for a string <var title="">s</var> when <var title="">pattern</var> - is not longer than <var title="">s</var> and truncating <var title="">s</var> to <var title="">pattern</var>'s length leaves the - two strings as matches of each other.</p></body></html> \ No newline at end of file Index: microdata.html =================================================================== RCS file: /sources/public/html5/spec-author-view/microdata.html,v retrieving revision 1.553 retrieving revision 1.554 diff -u -d -r1.553 -r1.554 --- microdata.html 3 Jan 2010 15:08:15 -0000 1.553 +++ microdata.html 3 Jan 2010 15:10:30 -0000 1.554 @@ -1,216 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"> -<!DOCTYPE html> -<!-- when publishing, change bits marked ZZZ --><html lang="en-US-x-Hixie" class="split chapter"><head><title>5 Microdata — HTML5 (Author Edition)</title><script src="link-fixup.js"></script><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 { 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: #EEFFEE; } - 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; } - - 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; } - - .tall-and-narrow { - font-size: 0.6em; - column-width: 25em; - column-gap: 1em; - -moz-column-width: 25em; - -moz-column-gap: 1em; - -webkit-column-width: 25em; - -webkit-column-gap: 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; } - - #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: 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; } - - #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 \ No newline at end of file Index: Overview.html =================================================================== RCS file: /sources/public/html5/spec-author-view/Overview.html,v retrieving revision 1.555 retrieving revision 1.556 diff -u -d -r1.555 -r1.556 --- Overview.html 3 Jan 2010 15:08:13 -0000 1.555 +++ Overview.html 3 Jan 2010 15:10:30 -0000 1.556 @@ -1,216 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"> -<!DOCTYPE html> -<!-- when publishing, change bits marked ZZZ --><html lang="en-US-x-Hixie" class="split index"><head><title>HTML5 (Author Edition)</title><script src="link-fixup.js"></script><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 { 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: #EEFFEE; } - 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; } - - 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; } - - .tall-and-narrow { - font-size: 0.6em; - column-width: 25em; - column-gap: 1em; - -moz-column-width: 25em; - -moz-column-gap: 1em; - -webkit-column-width: 25em; - -webkit-column-gap: 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; } - - #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: 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; } - - #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 \ No newline at end of file Index: history.html =================================================================== RCS file: /sources/public/html5/spec-author-view/history.html,v retrieving revision 1.556 retrieving revision 1.557 diff -u -d -r1.556 -r1.557 --- history.html 3 Jan 2010 15:08:14 -0000 1.556 +++ history.html 3 Jan 2010 15:10:30 -0000 1.557 @@ -1,216 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"> -<!DOCTYPE html> -<!-- when publishing, change bits marked ZZZ --><html lang="en-US-x-Hixie" class="split chapter"><head><title>6.8 Session history and navigation — HTML5 (Author Edition)</title><script src="link-fixup.js"></script><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 { 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: #EEFFEE; } - 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; } - - 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; } - - .tall-and-narrow { - font-size: 0.6em; - column-width: 25em; - column-gap: 1em; - -moz-column-width: 25em; - -moz-column-gap: 1em; - -webkit-column-width: 25em; - -webkit-column-gap: 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; } - - #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: 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; } - - #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; } - . \ No newline at end of file Index: dom.html =================================================================== RCS file: /sources/public/html5/spec-author-view/dom.html,v retrieving revision 1.557 retrieving revision 1.558 diff -u -d -r1.557 -r1.558 --- dom.html 1 Jan 2010 06:10:28 -0000 1.557 +++ dom.html 3 Jan 2010 15:10:30 -0000 1.558 @@ -1,636 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"> -<!DOCTYPE html> -<!-- when publishing, change bits marked ZZZ --><html lang="en-US-x-Hixie" class="split chapter"><head><title>3 Semantics, structure, and APIs of HTML documents — HTML5 (Author Edition)</title><script src="link-fixup.js"></script><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 { 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: #EEFFEE; } - 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; } - - 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; } - - .tall-and-narrow { - font-size: 0.6em; - column-width: 25em; - column-gap: 1em; - -moz-column-width: 25em; - -moz-column-gap: 1em; - -webkit-column-width: 25em; - -webkit-column-gap: 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; } - - #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: 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; } - - #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; } - - </style><link href="data:text/css," rel="stylesheet" title="Complete specification"><link href="data:text/css,.impl%20%7B%20display:%20none;%20%7D" rel="alternate stylesheet" title="Author documentation only"><link href="data:text/css,.impl%20%7B%20background:%20%23FFEEEE;%20%7D" rel="alternate stylesheet" title="Highlight implementation requirements"><link href="data:text/css," id="complete" rel="stylesheet" title="Complete specification"><link href="data:text/css,.impl%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" id="highlight" rel="alternate stylesheet" title="Highlight implementation requirements"><script> - 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', 'http://www.whatwg.org/specs/web-apps/current-work/' + 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); - // load('reviewer.js'); // would need cross-site XHR - if (document.getElementById('head')) - load('toc.js'); - - // load('updater.js'); // would need cross-site XHR - load('dfn.js'); - // load('status.js'); // would need cross-site XHR - 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="urls.html" title="2.5 URLs" rel="prev"> - <link href="Overview.html#contents" title="Table of contents" rel="index"> - <link href="elements.html" title="3.2 Elements" 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 (Author Edition)</h1> - </div><div> - <a href="urls.html">← 2.5 URLs</a> – - <a href="Overview.html#contents">Table of contents</a> – - <a href="elements.html">3.2 Elements →</a> - <ol class="toc"><li><a href="dom.html#dom"><span class="secno">3 </span>Semantics, structure, and APIs of HTML documents</a> - <ol><li><a href="dom.html#documents"><span class="secno">3.1 </span>Documents</a> - <ol><li><a href="dom.html#documents-in-the-dom"><span class="secno">3.1.1 </span>Documents in the DOM</a></li><li><a href="dom.html#security"><span class="secno">3.1.2 </span>Security</a></li><li><a href="dom.html#resource-metadata-management"><span class="secno">3.1.3 </span>Resource metadata management</a></li><li><a href="dom.html#dom-tree-accessors"><span class="secno">3.1.4 </span>DOM tree accessors</a></li><li><a href="dom.html#creating-documents"><span class="secno">3.1.5 </span>Creating documents</a></li></ol></li></ol></li></ol></div> - - <h2 id="dom"><span class="secno">3 </span>Semantics, structure, and APIs of HTML documents</h2><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><h3 id="documents"><span class="secno">3.1 </span>Documents</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>Every XML and HTML document in an HTML UA is represented by a - <code>Document</code> object. <a href="references.html#refsDOMCORE">[DOMCORE]</a></p><p><dfn id="the-document-s-address">The document's address</dfn> is an <a href="urls.html#absolute-url">absolute URL</a> - that is set when the <code>Document</code> is created. <dfn id="the-document-s-current-address">The - document's current address</dfn> is an <a href="urls.html#absolute-url">absolute URL</a> - that can change during the lifetime of the <code>Document</code>, - for example when the user <a href="#navigate" title="navigate">navigates</a> to - a <a href="#scroll-to-fragid" title="navigate-fragid">fragment identifier</a> on the - page. </p><p class="note">Interactive user agents typically expose <a href="#the-document-s-current-address">the - document's current address</a> in their user interface.</p><p>When a <code>Document</code> is created by a <a href="#concept-script" title="concept-script">script</a> using the <code title="dom-DOMImplementation-createDocument">createDocument()</code> - or <code title="dom-DOMHTMLImplementation-createHTMLDocument"><a href="#dom-domhtmlimplementation-createhtmldocument">createHTMLDocument()</a></code> - APIs, <a href="#the-document-s-address">the document's address</a> is the same as <a href="#the-document-s-address">the - document's address</a> of the <a href="browsers.html#active-document">active document</a> of the - <a href="#script-s-browsing-context">script's browsing context</a>.</p><p><code>Document</code> objects are assumed to be <dfn id="xml-documents">XML - documents</dfn> unless they are flagged as being <dfn id="html-documents">HTML - documents</dfn> when they are created. Whether a document is an - <a href="#html-documents" title="HTML documents">HTML document</a> or an <a href="#xml-documents" title="XML documents">XML document</a> affects the behavior of - certain APIs and the case-sensitivity of some selectors.</p><h4 id="documents-in-the-dom"><span class="secno">3.1.1 </span>Documents in the DOM</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>All <code>Document</code> objects (in user agents implementing - this specification) also implement - the <code><a href="#htmldocument">HTMLDocument</a></code> interface, available using - binding-specific methods. (This is the case whether or not the - document in question is an <a href="#html-documents" title="HTML documents">HTML - document</a> or indeed whether it contains any <a href="infrastructure.html#html-elements">HTML - elements</a> at all.) <code>Document</code> objects also implement the document-level interface - of any other namespaces that the UA supports.</p><p class="example">For example, if an HTML implementation also - supports SVG, then the <code>Document</code> object implements both - <code><a href="#htmldocument">HTMLDocument</a></code> and <code>SVGDocument</code>.</p><p class="note">Because the <code><a href="#htmldocument">HTMLDocument</a></code> interface is - now obtained using binding-specific casting methods instead of - simply being the primary interface of the document object, it is no - longer defined as inheriting from <code>Document</code>.</p><pre class="idl">[OverrideBuiltins] -interface <dfn id="htmldocument">HTMLDocument</dfn> { - // <a href="#resource-metadata-management">resource metadata management</a> - [PutForwards=href] readonly attribute <a href="history.html#location">Location</a> <a href="#dom-document-location" title="dom-document-location">location</a>; - readonly attribute DOMString <a href="#dom-document-url" title="dom-document-URL">URL</a>; - attribute DOMString <a href="#dom-document-domain" title="dom-document-domain">domain</a>; - readonly attribute DOMString <a href="#dom-document-referrer" title="dom-document-referrer">referrer</a>; - attribute DOMString <a href="#dom-document-cookie" title="dom-document-cookie">cookie</a>; - readonly attribute DOMString <a href="#dom-document-lastmodified" title="dom-document-lastModified">lastModified</a>; - readonly attribute DOMString <a href="#dom-document-compatmode" title="dom-document-compatMode">compatMode</a>; - attribute DOMString <a href="#dom-document-charset" title="dom-document-charset">charset</a>; - readonly attribute DOMString <a href="#dom-document-characterset" title="dom-document-characterSet">characterSet</a>; - readonly attribute DOMString <a href="#dom-document-defaultcharset" title="dom-document-defaultCharset">defaultCharset</a>; - readonly attribute DOMString <a href="#dom-document-readystate" title="dom-document-readyState">readyState</a>; - - // <a href="#dom-tree-accessors">DOM tree accessors</a> - attribute DOMString <a href="#document.title" title="dom-document-title">title</a>; - attribute DOMString <a href="#dom-document-dir" title="dom-document-dir">dir</a>; - attribute <a href="elements.html#htmlelement">HTMLElement</a> <a href="#dom-document-body" title="dom-document-body">body</a>; - readonly attribute <a href="semantics.html#htmlheadelement">HTMLHeadElement</a> <a href="#dom-document-head" title="dom-document-head">head</a>; - readonly attribute <a href="urls.html#htmlcollection">HTMLCollection</a> <a href="#dom-document-images" title="dom-document-images">images</a>; - readonly attribute <a href="urls.html#htmlcollection">HTMLCollection</a> <a href="#dom-document-embeds" title="dom-document-embeds">embeds</a>; - readonly attribute <a href="urls.html#htmlcollection">HTMLCollection</a> <a href="#dom-document-plugins" title="dom-document-plugins">plugins</a>; - readonly attribute <a href="urls.html#htmlcollection">HTMLCollection</a> <a href="#dom-document-links" title="dom-document-links">links</a>; - readonly attribute <a href="urls.html#htmlcollection">HTMLCollection</a> <a href="#dom-document-forms" title="dom-document-forms">forms</a>; - readonly attribute <a href="urls.html#htmlcollection">HTMLCollection</a> <a href="#dom-document-scripts" title="dom-document-scripts">scripts</a>; - NodeList <a href="#dom-document-getelementsbyname" title="dom-document-getElementsByName">getElementsByName</a>(in DOMString elementName); - NodeList <a href="#dom-document-getelementsbyclassname" title="dom-document-getElementsByClassName">getElementsByClassName</a>(in DOMString classNames); - NodeList <a href="#dom-document-getitems" title="dom-document-getItems">getItems</a>(in optional DOMString typeNames); - <a href="#dom-document-nameditem" title="dom-document-namedItem">getter</a> any (in DOMString name); - - // <a href="apis-in-html-documents.html#dynamic-markup-insertion">dynamic markup insertion</a> - attribute DOMString <a href="apis-in-html-documents.html#dom-innerhtml" title="dom-innerHTML">innerHTML</a>; - <a href="#htmldocument">HTMLDocument</a> <a href="apis-in-html-documents.html#dom-document-open" title="dom-document-open">open</a>(in optional DOMString type, in optional DOMString replace); - <a href="#windowproxy">WindowProxy</a> <a href="apis-in-html-documents.html#dom-document-open" title="dom-document-open">open</a>(in DOMString url, in DOMString name, in DOMString features, in optional boolean replace); - void <a href="#dom-document-close" title="dom-document-close">close</a>(); - void <a href="#dom-document-write" title="dom-document-write">write</a>(in DOMString... text); - void <a href="#dom-document-writeln" title="dom-document-writeln">writeln</a>(in DOMString... text); - - // <a href="editing.html#editing">user interaction</a> - <a href="editing.html#selection-0">Selection</a> <a href="#dom-document-getselection" title="dom-document-getSelection">getSelection</a>(); - readonly attribute <span>Element</span> <a href="#dom-document-activeelement" title="dom-document-activeElement">activeElement</a>; - boolean <a href="#dom-document-hasfocus" title="dom-document-hasFocus">hasFocus</a>(); - attribute DOMString <a href="#designMode" title="dom-document-designMode">designMode</a>; - boolean <a href="#execCommand" title="dom-document-execCommand">execCommand</a>(in DOMString commandId); - boolean <a href="#execCommand" title="dom-document-execCommand">execCommand</a>(in DOMString commandId, in boolean showUI); - boolean <a href="#execCommand" title="dom-document-execCommand">execCommand</a>(in DOMString commandId, in boolean showUI, in DOMString value); - boolean <a href="#dom-document-querycommandenabled" title="dom-document-queryCommandEnabled">queryCommandEnabled</a>(in DOMString commandId); - boolean <a href="#dom-document-querycommandindeterm" title="dom-document-queryCommandIndeterm">queryCommandIndeterm</a>(in DOMString commandId); - boolean <a href="#dom-document-querycommandstate" title="dom-document-queryCommandState">queryCommandState</a>(in DOMString commandId); - boolean <a href="#dom-document-querycommandsupported" title="dom-document-queryCommandSupported">queryCommandSupported</a>(in DOMString commandId); - DOMString <a href="#dom-document-querycommandvalue" title="dom-document-queryCommandValue">queryCommandValue</a>(in DOMString commandId); - readonly attribute <a href="urls.html#htmlcollection">HTMLCollection</a> <a href="#dom-document-commands" title="dom-document-commands">commands</a>; - - // <a href="#event-handler-idl-attributes">event handler IDL attributes</a> - attribute <a href="#function">Function</a> <a href="#handler-onabort" title="handler-onabort">onabort</a>; - attribute <a href="#function">Function</a> <a href="#handler-onblur" title="handler-onblur">onblur</a>; - attribute <a href="#function">Function</a> <a href="#handler-oncanplay" title="handler-oncanplay">oncanplay</a>; - attribute <a href="#function">Function</a> <a href="#handler-oncanplaythrough" title="handler-oncanplaythrough">oncanplaythrough</a>; - attribute <a href="#function">Function</a> <a href="#handler-onchange" title="handler-onchange">onchange</a>; - attribute <a href="#function">Function</a> <a href="#handler-onclick" title="handler-onclick">onclick</a>; - attribute <a href="#function">Function</a> <a href="#handler-oncontextmenu" title="handler-oncontextmenu">oncontextmenu</a>; - attribute <a href="#function">Function</a> <a href="#handler-ondblclick" title="handler-ondblclick">ondblclick</a>; - attribute <a href="#function">Function</a> <a href="#handler-ondrag" title="handler-ondrag">ondrag</a>; - attribute <a href="#function">Function</a> <a href="#handler-ondragend" title="handler-ondragend">ondragend</a>; - attribute <a href="#function">Function</a> <a href="#handler-ondragenter" title="handler-ondragenter">ondragenter</a>; - attribute <a href="#function">Function</a> <a href="#handler-ondragleave" title="handler-ondragleave">ondragleave</a>; - attribute <a href="#function">Function</a> <a href="#handler-ondragover" title="handler-ondragover">ondragover</a>; - attribute <a href="#function">Function</a> <a href="#handler-ondragstart" title="handler-ondragstart">ondragstart</a>; - attribute <a href="#function">Function</a> <a href="#handler-ondrop" title="handler-ondrop">ondrop</a>; - attribute <a href="#function">Function</a> <a href="#handler-ondurationchange" title="handler-ondurationchange">ondurationchange</a>; - attribute <a href="#function">Function</a> <a href="#handler-onemptied" title="handler-onemptied">onemptied</a>; - attribute <a href="#function">Function</a> <a href="#handler-onended" title="handler-onended">onended</a>; - attribute <a href="#function">Function</a> <a href="#handler-onerror" title="handler-onerror">onerror</a>; - attribute <a href="#function">Function</a> <a href="#handler-onfocus" title="handler-onfocus">onfocus</a>; - attribute <a href="#function">Function</a> <a href="#handler-onformchange" title="handler-onformchange">onformchange</a>; - attribute <a href="#function">Function</a> <a href="#handler-onforminput" title="handler-onforminput">onforminput</a>; - attribute <a href="#function">Function</a> <a href="#handler-oninput" title="handler-oninput">oninput</a>; - attribute <a href="#function">Function</a> <a href="#handler-oninvalid" title="handler-oninvalid">oninvalid</a>; - attribute <a href="#function">Function</a> <a href="#handler-onkeydown" title="handler-onkeydown">onkeydown</a>; - attribute <a href="#function">Function</a> <a href="#handler-onkeypress" title="handler-onkeypress">onkeypress</a>; - attribute <a href="#function">Function</a> <a href="#handler-onkeyup" title="handler-onkeyup">onkeyup</a>; - attribute <a href="#function">Function</a> <a href="#handler-onload" title="handler-onload">onload</a>; - attribute <a href="#function">Function</a> <a href="#handler-onloadeddata" title="handler-onloadeddata">onloadeddata</a>; - attribute <a href="#function">Function</a> <a href="#handler-onloadedmetadata" title="handler-onloadedmetadata">onloadedmetadata</a>; - attribute <a href="#function">Function</a> <a href="#handler-onloadstart" title="handler-onloadstart">onloadstart</a>; - attribute <a href="#function">Function</a> <a href="#handler-onmousedown" title="handler-onmousedown">onmousedown</a>; - attribute <a href="#function">Function</a> <a href="#handler-onmousemove" title="handler-onmousemove">onmousemove</a>; - attribute <a href="#function">Function</a> <a href="#handler-onmouseout" title="handler-onmouseout">onmouseout</a>; - attribute <a href="#function">Function</a> <a href="#handler-onmouseover" title="handler-onmouseover">onmouseover</a>; - attribute <a href="#function">Function</a> <a href="#handler-onmouseup" title="handler-onmouseup">onmouseup</a>; - attribute <a href="#function">Function</a> <a href="#handler-onmousewheel" title="handler-onmousewheel">onmousewheel</a>; - attribute <a href="#function">Function</a> <a href="#handler-onpause" title="handler-onpause">onpause</a>; - attribute <a href="#function">Function</a> <a href="#handler-onplay" title="handler-onplay">onplay</a>; - attribute <a href="#function">Function</a> <a href="#handler-onplaying" title="handler-onplaying">onplaying</a>; - attribute <a href="#function">Function</a> <a href="#handler-onprogress" title="handler-onprogress">onprogress</a>; - attribute <a href="#function">Function</a> <a href="#handler-onratechange" title="handler-onratechange">onratechange</a>; - attribute <a href="#function">Function</a> <a href="#handler-onreadystatechange" title="handler-onreadystatechange">onreadystatechange</a>; - attribute <a href="#function">Function</a> <a href="#handler-onscroll" title="handler-onscroll">onscroll</a>; - attribute <a href="#function">Function</a> <a href="#handler-onseeked" title="handler-onseeked">onseeked</a>; - attribute <a href="#function">Function</a> <a href="#handler-onseeking" title="handler-onseeking">onseeking</a>; - attribute <a href="#function">Function</a> <a href="#handler-onselect" title="handler-onselect">onselect</a>; - attribute <a href="#function">Function</a> <a href="#handler-onshow" title="handler-onshow">onshow</a>; - attribute <a href="#function">Function</a> <a href="#handler-onstalled" title="handler-onstalled">onstalled</a>; - attribute <a href="#function">Function</a> <a href="#handler-onsubmit" title="handler-onsubmit">onsubmit</a>; - attribute <a href="#function">Function</a> <a href="#handler-onsuspend" title="handler-onsuspend">onsuspend</a>; - attribute <a href="#function">Function</a> <a href="#handler-ontimeupdate" title="handler-ontimeupdate">ontimeupdate</a>; - attribute <a href="#function">Function</a> <a href="#handler-onvolumechange" title="handler-onvolumechange">onvolumechange</a>; - attribute <a href="#function">Function</a> <a href="#handler-onwaiting" title="handler-onwaiting">onwaiting</a>; -}; -<span>Document</span> implements <a href="#htmldocument">HTMLDocument</a>;</pre><p>Since the <code><a href="#htmldocument">HTMLDocument</a></code> interface holds methods and - attributes related to a number of disparate features, the members of - this interface are described in various different sections.</p><h4 id="security"><span class="secno">3.1.2 </span>Security</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>User agents must<code><a href="urls.html#security_err">SECURITY_ERR</a></code> exception whenever any of the members of - an <code><a href="#htmldocument">HTMLDocument</a></code> object are accessed by scripts whose - <a href="#effective-script-origin">effective script origin</a> is not the <a href="#same-origin" title="same - origin">same</a> as the <code>Document</code>'s <a href="#effective-script-origin">effective - script origin</a>.</p><h4 id="resource-metadata-management"><span class="secno">3.1.3 </span><dfn>Resource metadata management</dfn></h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-URL"><a href="#dom-document-url">URL</a></code></dt> - <dd> - <p>Returns <a href="#the-document-s-address">the document's address</a>.</p> - </dd> - - <dt><var title="">document</var> . <code title="dom-document-referrer"><a href="#dom-document-referrer">referrer</a></code></dt> - <dd> - <p>Returns <a href="#the-document-s-current-address" title="the document's current address">the - address</a> of the <code>Document</code> from which the user - navigated to this one, unless it was blocked or there was no such - document, in which case it returns the empty string.</p> - <p>The <code title="rel-noreferrer"><a href="links.html#link-type-noreferrer">noreferrer</a></code> link - type can be used to block the referrer.</p> - </dd> - - </dl><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-cookie"><a href="#dom-document-cookie">cookie</a></code> [ = <var title="">value</var> ]</dt> - <dd> - <p>Returns the HTTP cookies that apply to the - <code>Document</code>. If there are no cookies or cookies can't be - applied to this resource, the empty string will be returned.</p> - <p>Can be set, to add a new cookie to the element's set of HTTP - cookies.</p> - <p>If the <code>Document</code> has no <a href="browsers.html#browsing-context">browsing - context</a> an <code><a href="urls.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception will be - thrown. If the contents are <a href="#sandboxed-origin-browsing-context-flag" title="sandboxed origin browsing - context flag">sandboxed into a unique origin</a>, a - <code><a href="urls.html#security_err">SECURITY_ERR</a></code> exception will be thrown.</p> - </dd> - - </dl><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-lastmodified"><a href="#dom-document-lastmodified">lastModified</a></code></dt> - <dd> - <p>Returns the date of the last modification to the document, as - reported by the server, in the form "<code title="">MM/DD/YYYY hh:mm:ss</code>".</p> - <p>If the last modification date is not known, the current time is - returned instead.</p> - </dd> - - </dl><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-compatmode"><a href="#dom-document-compatmode">compatMode</a></code></dt> - <dd> - <p>In a conforming document, returns the string "<code title="">CSS1Compat</code>". (In <a href="#quirks-mode">quirks mode</a> - documents, returns the string "<code title="">BackCompat</code>", - but a conforming document can never trigger <a href="#quirks-mode">quirks - mode</a>.)</p> - </dd> - - </dl><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-charset"><a href="#dom-document-charset">charset</a></code> [ = <var title="">value</var> ]</dt> - <dd> - <p>Returns the <a href="#document-s-character-encoding">document's character encoding</a>.</p> - <p>Can be set, to dynamically change the <a href="#document-s-character-encoding">document's - character encoding</a>.</p> - <p>New values that are not IANA-registered aliases supported by the user agent are ignored.</p> - </dd> - - <dt><var title="">document</var> . <code title="dom-document-characterSet"><a href="#dom-document-characterset">characterSet</a></code></dt> - <dd> - <p>Returns the <a href="#document-s-character-encoding">document's character encoding</a>.</p> - </dd> - - <dt><var title="">document</var> . <code title="dom-document-defaultCharset"><a href="#dom-document-defaultcharset">defaultCharset</a></code></dt> - <dd> - <p>Returns what might be the user agent's default character encoding.</p> - </dd> - - </dl><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-readyState"><a href="#dom-document-readystate">readyState</a></code></dt> - <dd> - <p>Returns "loading" while the <code>Document</code> is loading, and "complete" once it has loaded.</p> - <p>The <code title="event-readystatechange">readystatechange</code> event fires on the <code>Document</code> object when this value changes.</p> - </dd> - - </dl><h4 id="dom-tree-accessors"><span class="secno">3.1.4 </span><dfn>DOM tree accessors</dfn></h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p><dfn id="the-html-element">The <code>html</code> element</dfn> of a document is the - document's root element, if there is one and it's an - <code><a href="semantics.html#the-html-element-0">html</a></code> element, or null otherwise.</p><hr><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-head"><a href="#dom-document-head">head</a></code></dt> - <dd> - <p>Returns <a href="#the-head-element">the <code>head</code> element</a>.</p> - </dd> - - </dl><p><dfn id="the-head-element">The <code>head</code> element</dfn> of a document is the - first <code><a href="semantics.html#the-head-element-0">head</a></code> element that is a child of <a href="#the-html-element">the - <code>html</code> element</a>, if there is one, or null - otherwise.</p><hr><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-title"><a href="#document.title">title</a></code> [ = <var title="">value</var> ]</dt> - <dd> - <p>Returns the document's title, as given by <a href="#the-title-element">the - <code>title</code> element</a>.</p> - <p>Can be set, to update the document's title. If there is no - <a href="#the-head-element" title="the head element"><code>head</code> element</a>, - the new value is ignored.</p> - <p>In SVG documents, the <code>SVGDocument</code> interface's - <code title="dom-svg-title">title</code> attribute takes - precedence.</p> - </dd> - - </dl><p><dfn id="the-title-element">The <code>title</code> element</dfn> of a document is the - first <code><a href="semantics.html#the-title-element-0">title</a></code> element in the document (in tree order), if - there is one, or null otherwise.</p><hr><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-body"><a href="#dom-document-body">body</a></code> [ = <var title="">value</var> ]</dt> - <dd> - <p>Returns <a href="#the-body-element">the body element</a>.</p> - <p>Can be set, to replace <a href="#the-body-element">the body element</a>.</p> - <p>If the new value is not a <code><a href="sections.html#the-body-element-0">body</a></code> or <code><a href="#frameset">frameset</a></code> element, this will throw a <code><a href="urls.html#hierarchy_request_err">HIERARCHY_REQUEST_ERR</a></code> exception.</p> - </dd> - - </dl><p><dfn id="the-body-element">The body element</dfn> of a document is the first child of - <a href="#the-html-element">the <code>html</code> element</a> that is either a - <code><a href="sections.html#the-body-element-0">body</a></code> element or a <code><a href="#frameset">frameset</a></code> element. If - there is no such element, it is null. </p><hr><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-images"><a href="#dom-document-images">images</a></code></dt> - <dd> - <p>Returns an <code><a href="urls.html#htmlcollection">HTMLCollection</a></code> of the <code><a href="embedded-content-1.html#the-img-element">img</a></code> elements in the <code>Document</code>.</p> - </dd> - - <dt><var title="">document</var> . <code title="dom-document-embeds"><a href="#dom-document-embeds">embeds</a></code></dt> - <dt><var title="">document</var> . <code title="dom-document-plugins"><a href="#dom-document-plugins">plugins</a></code></dt> - <dd> - <p>Return an <code><a href="urls.html#htmlcollection">HTMLCollection</a></code> of the <code><a href="the-iframe-element.html#the-embed-element">embed</a></code> elements in the <code>Document</code>.</p> - </dd> - - <dt><var title="">document</var> . <code title="dom-document-links"><a href="#dom-document-links">links</a></code></dt> - <dd> - <p>Returns an <code><a href="urls.html#htmlcollection">HTMLCollection</a></code> of the <code><a href="text-level-semantics.html#the-a-element">a</a></code> and <code><a href="the-map-element.html#the-area-element">area</a></code> elements in the <code>Document</code> that have <code title="attr-hyperlink-href"><a href="links.html#attr-hyperlink-href">href</a></code> attributes.</p> - </dd> - - <dt><var title="">document</var> . <code title="dom-document-forms"><a href="#dom-document-forms">forms</a></code></dt> - <dd> - <p>Return an <code><a href="urls.html#htmlcollection">HTMLCollection</a></code> of the <code><a href="forms.html#the-form-element">form</a></code> elements in the <code>Document</code>.</p> - </dd> - - <dt><var title="">document</var> . <code title="dom-document-scripts"><a href="#dom-document-scripts">scripts</a></code></dt> - <dd> - <p>Return an <code><a href="urls.html#htmlcollection">HTMLCollection</a></code> of the <code><a href="scripting-1.html#script">script</a></code> elements in the <code>Document</code>.</p> - </dd> - - </dl><dl class="domintro"><dt><var title="">collection</var> = <var title="">document</var> . <code title="dom-document-getElementsByName"><a href="#dom-document-getelementsbyname">getElementsByName</a></code>(<var title="">name</var>)</dt> - <dd> - <p>Returns a <code>NodeList</code> of elements in the - <code>Document</code> that have a <code title="">name</code> - attribute with the value <var title="">name</var>.</p> - </dd> - - <dt><var title="">collection</var> = <var title="">document</var> . <code title="dom-document-getElementsByClassName"><a href="#dom-document-getelementsbyclassname">getElementsByClassName(<var title="">classes</var>)</a></code></dt> - <dt><var title="">collection</var> = <var title="">element</var> . <code title="dom-getElementsByClassName"><a href="#dom-getelementsbyclassname">getElementsByClassName(<var title="">classes</var>)</a></code></dt> - <dd> - <p>Returns a <code>NodeList</code> of the elements in the object - on which the method was invoked (a <code>Document</code> or an - <code>Element</code>) that have all the classes given by <var title="">classes</var>.</p> - <p>The <var title="">classes</var> argument is interpreted as a - space-separated list of classes.</p> - </dd> - - </dl><p>HTML, SVG, and MathML elements define which classes they are in - by having an attribute with no namespace with the name <code title="">class</code> containing a space-separated list of classes - to which the element belongs. Other specifications may also allow - elements in their namespaces to be labeled as being in specific - classes.</p><div class="example"> - - <p>Given the following XHTML fragment:</p> - - <pre><div id="example"> - <p id="p1" class="aaa bbb"/> - <p id="p2" class="aaa ccc"/> - <p id="p3" class="bbb ccc"/> -</div></pre> - - <p>A call to - <code>document.getElementById('example').getElementsByClassName('aaa')</code> - would return a <code>NodeList</code> with the two paragraphs - <code>p1</code> and <code>p2</code> in it.</p> - - <p>A call to <code>getElementsByClassName('ccc bbb')</code> - would only return one node, however, namely <code>p3</code>. A call - to - <code>document.getElementById('example').getElementsByClassName('bbb  ccc ')</code> - would return the same thing.</p> - - <p>A call to <code>getElementsByClassName('aaa,bbb')</code> would - return no nodes; none of the elements above are in the "aaa,bbb" - class.</p> - - </div><!-- v2: -> * xGetParentElementByClassName(rootElement, className, tagName) - -> Navigates upwards until we hit a parent element with the given class name and -> optional tag name. ---><hr><p class="note">The <code title="dom-document-dir"><a href="#dom-document-dir">dir</a></code> - attribute on the <code><a href="#htmldocument">HTMLDocument</a></code> interface is defined - along with the <code title="attr-dir"><a href="elements.html#the-dir-attribute">dir</a></code> content - attribute.</p><h4 id="creating-documents"><span class="secno">3.1.5 </span>Creating documents</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p><a href="#xml-documents">XML documents</a> can be created from script using the - <code title="dom-DOMImplementation-createDocument">createDocument()</code> - method on the <code>DOMImplementation</code> interface.</p><p><a href="#html-documents">HTML documents</a> can be created using the <code title="dom-DOMHTMLImplementation-createHTMLDocument"><a href="#dom-domhtmlimplementation-createhtmldocument">createHTMLDocument()</a></code> - method:</p><pre class="idl">[Supplemental, NoInterfaceObject] -interface <dfn id="domhtmlimplementation">DOMHTMLImplementation</dfn> { - <span>Document</span> <a href="#dom-domhtmlimplementation-createhtmldocument" title="dom-DOMHTMLImplementation-createHTMLDocument">createHTMLDocument</a>(in DOMString title); -}; -<span>DOMImplementation</span> implements <a href="#domhtmlimplementation">DOMHTMLImplementation</a>;</pre><p>The <dfn id="dom-domhtmlimplementation-createhtmldocument" title="dom-DOMHTMLImplementation-createHTMLDocument"><code>createHTMLDocument(<var title="">title</var>)</code></dfn> method, when invoked, must run the - following steps:</p><ol><li><p>Let <var title="">doc</var> be a newly created - <code>Document</code> object.</p></li> - - <li><p>Mark <var title="">doc</var> as being an <a href="#html-documents" title="HTML - documents">HTML document</a>.</p></li> - - <li><p>Create a <code>DocumentType</code> node with the <code title="">name</code> attribute set to the string "<code title="">html</code>", and the other attributes specific to - <code>DocumentType</code> objects set to the empty string, null, - and empty lists, as appropriate. Append the newly created node to - <var title="">doc</var>.</p></li> - - <li><p>Create an <code><a href="semantics.html#the-html-element-0">html</a></code> element, and append it to <var title="">doc</var>.</p></li> - - <li><p>Create a <code><a href="semantics.html#the-head-element-0">head</a></code> element, and append it to the - <code><a href="semantics.html#the-html-element-0">html</a></code> element created in the previous step.</p> - - </li><li><p>Create a <code><a href="semantics.html#the-title-element-0">title</a></code> element, and append it to the - <code><a href="semantics.html#the-head-element-0">head</a></code> element created in the previous step.</p> - - </li><li><p>Create a <code>Text</code> node, and set its <code title="">data</code> attribute to the string given by the method's - argument (which could be the empty string). Append it to the - <code><a href="semantics.html#the-title-element-0">title</a></code> element created in the previous step.</p> - - </li><li><p>Create a <code><a href="sections.html#the-body-element-0">body</a></code> element, and append it to the - <code><a href="semantics.html#the-html-element-0">html</a></code> element created in the earlier step.</p> - - </li><li><p>Return <var title="">doc</var>.</p></li> - - </ol></body></html> \ No newline at end of file Index: embedded-content-1.html =================================================================== RCS file: /sources/public/html5/spec-author-view/embedded-content-1.html,v retrieving revision 1.8 retrieving revision 1.9 diff -u -d -r1.8 -r1.9 --- embedded-content-1.html 3 Jan 2010 15:08:14 -0000 1.8 +++ embedded-content-1.html 3 Jan 2010 15:10:30 -0000 1.9 @@ -1,216 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"> -<!DOCTYPE html> -<!-- when publishing, change bits marked ZZZ --><html lang="en-US-x-Hixie" class="split chapter"><head><title>4.8 Embedded content — HTML5 (Author Edition)</title><script src="link-fixup.js"></script><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 { 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: #EEFFEE; } - 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; } - - 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; } - - .tall-and-narrow { - font-size: 0.6em; - column-width: 25em; - column-gap: 1em; - -moz-column-width: 25em; - -moz-column-gap: 1em; - -webkit-column-width: 25em; - -webkit-column-gap: 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; } - - #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: 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; } - - #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-ex \ No newline at end of file Index: no.html =================================================================== RCS file: /sources/public/html5/spec-author-view/no.html,v retrieving revision 1.230 retrieving revision 1.231 diff -u -d -r1.230 -r1.231 --- no.html 1 Jan 2010 05:48:49 -0000 1.230 +++ no.html 3 Jan 2010 15:10:31 -0000 1.231 @@ -1,264 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"> -<!DOCTYPE html> -<!-- when publishing, change bits marked ZZZ --><html lang="en-US-x-Hixie"><head><title>12 Things that you can't do with this specification because they are better handled using other technologies that are further described herein — HTML 5</title><script src="link-fixup.js"></script><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 { border-bottom: solid; } - table tbody th:first-child { border-left: solid; } - 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: #EEFFEE; } - 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; } - p.copyright { 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; } - - 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; } - - .tall-and-narrow { - font-size: 0.6em; - column-width: 25em; - column-gap: 1em; - -moz-column-width: 25em; - -moz-column-gap: 1em; - -webkit-column-width: 25em; - -webkit-column-gap: 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; } - - </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: 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; } - - #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; } - - </style><link href="data:text/css," rel="stylesheet" title="Complete specification"><link href="data:text/css,.impl%20%7B%20display:%20none;%20%7D" rel="alternate stylesheet" title="Author documentation only"><link href="data:text/css,.impl%20%7B%20background:%20%23FFEEEE;%20%7D" rel="alternate stylesheet" title="Highlight implementation requirements"><link href="http://www.w3.org/StyleSheets/TR/W3C-ED" rel="stylesheet" type="text/css"><!-- ZZZ ED vs WD --><link href="obsolete.html" title="11 Obsolete features" rel="prev"> - <link href="Overview.html#contents" title="Table of contents" rel="index"> - <link href="iana-considerations.html" title="IANA considerations" rel="next"> - </head><body onload="fixBrokenLink(); fixBrokenLink()"><div class="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 (Author Edition)</h1> - <h2 class="no-num no-toc" id="a-vocabulary-and-associated-apis-for-html-and-xhtml">A vocabulary and associated APIs for HTML and XHTML</h2> -<p>This is revision 1.3142.</p> - </div><div> - <a href="obsolete.html">← 11 Obsolete features</a> – - <a href="Overview.html#contents">Table of contents</a> – - <a href="iana-considerations.html">IANA considerations →</a> - </div> - - <h2 id="no"><span class="secno">12 </span>Things that you can't do with this specification because - they are better handled using other technologies that are further - described herein</h2><p><i>This section is non-normative.</i></p><p>There are certain features that are not handled by this - specification because a client side markup language is not the right - level for them, or because the features exist in other languages - that can be integrated into this one. This section covers some of - the more common requests.</p><!-- There are also certain features that are not handled by this - specification or any other, but that SHOULD be handled by another - specification: - - * find object at (x,y) - http://msdn.microsoft.com/workshop/author/dhtml/reference/methods/elementfrompoint.asp - * find mouse position - * screen object: top left width height pixelDepth colorDepth - availWidth availHeight availLeft availTop - * methods/properties for managing scrolling, especially in <textarea>, - such as .scrollTop and .scrollHeight in Mozilla - * support access Array element via () instead of [] (IEism) - https://bugzilla.mozilla.org/show_bug.cgi?id=289876 - * Need to say that NodeList's items are enumerable, so that - for (var x in myNodeList) { } - ...works. (ack Dethe Elza) - * a way to show icons for file types - e.g. http://www.gadgetopia.com/2004/05/04/FileIconTag.html - (this should probably be a function for the 'content', - 'background-image' and 'list-style-image' properties in CSS) - * custom syntax highlighting in <textarea>, <pre> (ack Ryan Johnson) - (this would probably best be done as some sort of output filter - at the CSS level, rather than anything HTML-specific. It would - have to support both <textarea>, where the data isn't in the - DOM proper, and <pre>, where it is.) - - XXX should ensure these are filed with the relevant people and groups - --><h3 id="localization"><span class="secno">12.1 </span>Localization</h3><p>If you wish to create localized versions of an HTML application, - the best solution is to preprocess the files on the server, and then - use HTTP content negotiation to serve the appropriate language.</p><!-- <p>XXX example here</p> --><h3 id="declarative-3d-scenes"><span class="secno">12.2 </span>Declarative 3D scenes</h3><p>Embedding 3D imagery into XHTML documents is the domain of X3D, - or technologies based on X3D that are namespace-aware.</p><!-- <p>XXX example here</p> --></body></html> \ No newline at end of file Index: elements.html =================================================================== RCS file: /sources/public/html5/spec-author-view/elements.html,v retrieving revision 1.7 retrieving revision 1.8 diff -u -d -r1.7 -r1.8 --- elements.html 1 Jan 2010 06:10:28 -0000 1.7 +++ elements.html 3 Jan 2010 15:10:30 -0000 1.8 @@ -1,808 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"> -<!DOCTYPE html> -<!-- when publishing, change bits marked ZZZ --><html lang="en-US-x-Hixie" class="split chapter"><head><title>3.2 Elements — HTML5 (Author Edition)</title><script src="link-fixup.js"></script><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 { 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: #EEFFEE; } - 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; } - - 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; } - - .tall-and-narrow { - font-size: 0.6em; - column-width: 25em; - column-gap: 1em; - -moz-column-width: 25em; - -moz-column-gap: 1em; - -webkit-column-width: 25em; - -webkit-column-gap: 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; } - - #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: 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; } - - #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; } - - </style><link href="data:text/css," rel="stylesheet" title="Complete specification"><link href="data:text/css,.impl%20%7B%20display:%20none;%20%7D" rel="alternate stylesheet" title="Author documentation only"><link href="data:text/css,.impl%20%7B%20background:%20%23FFEEEE;%20%7D" rel="alternate stylesheet" title="Highlight implementation requirements"><link href="data:text/css," id="complete" rel="stylesheet" title="Complete specification"><link href="data:text/css,.impl%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" id="highlight" rel="alternate stylesheet" title="Highlight implementation requirements"><script> - 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', 'http://www.whatwg.org/specs/web-apps/current-work/' + 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); - // load('reviewer.js'); // would need cross-site XHR - if (document.getElementById('head')) - load('toc.js'); - - // load('updater.js'); // would need cross-site XHR - load('dfn.js'); - // load('status.js'); // would need cross-site XHR - 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="dom.html" title="3 Semantics, structure, and APIs of HTML documents" rel="prev"> - <link href="Overview.html#contents" title="Table of contents" rel="index"> - <link href="content-models.html" title="3.2.5 Content models" 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 (Author Edition)</h1> - </div><div> - <a href="dom.html">← 3 Semantics, structure, and APIs of HTML documents</a> – - <a href="Overview.html#contents">Table of contents</a> – - <a href="content-models.html">3.2.5 Content models →</a> - <ol class="toc"><li><ol><li><a href="elements.html#elements"><span class="secno">3.2 </span>Elements</a> - <ol><li><a href="elements.html#semantics-0"><span class="secno">3.2.1 </span>Semantics</a></li><li><a href="elements.html#elements-in-the-dom"><span class="secno">3.2.2 </span>Elements in the DOM</a></li><li><a href="elements.html#global-attributes"><span class="secno">3.2.3 </span>Global attributes</a> - <ol><li><a href="elements.html#the-id-attribute"><span class="secno">3.2.3.1 </span>The <code>id</code> attribute</a></li><li><a href="elements.html#the-title-attribute"><span class="secno">3.2.3.2 </span>The <code>title</code> attribute</a></li><li><a href="elements.html#the-lang-and-xml:lang-attributes"><span class="secno">3.2.3.3 </span>The <code title="attr-lang">lang</code> and <code title="attr-xml-lang">xml:lang</code> attributes</a></li><li><a href="elements.html#the-xml:base-attribute-xml-only"><span class="secno">3.2.3.4 </span>The <code>xml:base</code> - attribute (XML only)</a></li><li><a href="elements.html#the-dir-attribute"><span class="secno">3.2.3.5 </span>The <code>dir</code> attribute</a></li><li><a href="elements.html#classes"><span class="secno">3.2.3.6 </span>The <code>class</code> attribute</a></li><li><a href="elements.html#the-style-attribute"><span class="secno">3.2.3.7 </span>The <code>style</code> attribute</a></li><li><a href="elements.html#embedding-custom-non-visible-data"><span class="secno">3.2.3.8 </span>Embedding custom non-visible data</a></li></ol></li><li><a href="elements.html#element-definitions"><span class="secno">3.2.4 </span>Element definitions</a></li></ol></li></ol></li></ol></div> - - <h3 id="elements"><span class="secno">3.2 </span>Elements</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><h4 id="semantics-0"><span class="secno">3.2.1 </span>Semantics</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments. </i><span><a href="http://www.w3.org/html/wg/tracker/issues/41">ISSUE-41</a> (Decentralized-extensibility) blocks progress to Last Call</span></p><p>Elements, attributes, and attribute values in HTML are defined - (by this specification) to have certain meanings (semantics). For - example, the <code><a href="grouping-content.html#the-ol-element">ol</a></code> element represents an ordered list, and - the <code title="attr-lang"><a href="#attr-lang">lang</a></code> attribute represents the - language of the content.</p><p>Authors must not use elements, attributes, and attribute values - for purposes other than their appropriate intended semantic - purpose. Authors must not use elements, attributes, and attribute - values that are not permitted by this specification or <a href="#other-applicable-specifications">other - applicable specifications</a>.</p><div class="example"> - <p>For example, the following document is non-conforming, despite - being syntactically correct:</p> - - <pre class="bad"><!DOCTYPE HTML> -<html lang="en-GB"> - <head> <title> Demonstration </title> </head> - <body> - <table> - <tr> <td> My favourite animal is the cat. </td> </tr> - <tr> - <td> - —<a href="http://example.org/~ernest/"><cite>Ernest</cite></a>, - in an essay from 1992 - </td> - </tr> - </table> - </body> -</html></pre> - - <p>...because the data placed in the cells is clearly not tabular - data (and the <code><a href="text-level-semantics.html#the-cite-element">cite</a></code> element mis-used). A corrected - version of this document might be:</p> - - <pre><!DOCTYPE HTML> -<html lang="en-GB"> - <head> <title> Demonstration </title> </head> - <body> - <blockquote> - <p> My favourite animal is the cat. </p> - </blockquote> - <p> - —<a href="http://example.org/~ernest/">Ernest</a>, - in an essay from 1992 - </p> - </body> -</html></pre> - - <p>This next document fragment, intended to represent the heading - of a corporate site, is similarly non-conforming because the second - line is not intended to be a heading of a subsection, but merely a - subheading or subtitle (a subordinate heading for the same - section).</p> - - <pre class="bad"><body> - <h1>ABC Company</h1> - <h2>Leading the way in widget design since 1432</h2> - ...</pre> - - <p>The <code><a href="sections.html#the-hgroup-element">hgroup</a></code> element is intended for these kinds of - situations:</p> - - <pre><body> - <hgroup> - <h1>ABC Company</h1> - <h2>Leading the way in widget design since 1432</h2> - </hgroup> - ...</pre> - - <p>In the next example, there is a non-conforming attribute value - ("carpet") and a non-conforming attribute ("texture"), which - is not permitted by this specification:</p> - - <pre class="bad"><label>Carpet: <input type="carpet" name="c" texture="deep pile"></label></pre> - - <p>Here would be an alternative and correct way to mark this up:</p> - - <pre><label>Carpet: <input type="text" class="carpet" name="c" data-texture="deep pile"></label></pre> - - </div><p>Through scripting and using other mechanisms, the values of - attributes, text, and indeed the entire structure of the document - may change dynamically while a user agent is processing it. The - semantics of a document at an instant in time are those represented - by the state of the document at that instant in time, and the - semantics of a document can therefore change over time. User agents - must</p><p class="example">HTML has a <code><a href="text-level-semantics.html#the-progress-element">progress</a></code> element that - describes a progress bar. If its "value" attribute is dynamically - updated by a script, the UA would update the rendering to show the - progress changing.</p><h4 id="elements-in-the-dom"><span class="secno">3.2.2 </span>Elements in the DOM</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>The nodes representing <a href="infrastructure.html#html-elements">HTML elements</a> in the DOM - implement, and expose to scripts, the - interfaces listed for them in the relevant sections of this - specification. This includes <a href="infrastructure.html#html-elements">HTML elements</a> in <a href="dom.html#xml-documents">XML - documents</a>, even when those documents are in another context - (e.g. inside an XSLT transform).</p><p>Elements in the DOM <a href="#represents" title="represents">represent</a> - things; that is, they have intrinsic <em>meaning</em>, also known as - semantics.</p><p class="example">For example, an <code><a href="grouping-content.html#the-ol-element">ol</a></code> element - represents an ordered list.</p><p>The basic interface, from which all the <a href="infrastructure.html#html-elements">HTML - elements</a>' interfaces inherit, is the <code><a href="#htmlelement">HTMLElement</a></code> interface.</p><pre class="idl">interface <dfn id="htmlelement">HTMLElement</dfn> : <span>Element</span> { - // <a href="dom.html#dom-tree-accessors">DOM tree accessors</a> - NodeList <a href="#dom-getelementsbyclassname" title="dom-getElementsByClassName">getElementsByClassName</a>(in DOMString classNames); - - // <a href="apis-in-html-documents.html#dynamic-markup-insertion">dynamic markup insertion</a> - attribute DOMString <a href="apis-in-html-documents.html#dom-innerhtml" title="dom-innerHTML">innerHTML</a>; - attribute DOMString <a href="apis-in-html-documents.html#dom-outerhtml" title="dom-outerHTML">outerHTML</a>; - void <a href="#dom-insertadjacenthtml" title="dom-insertAdjacentHTML">insertAdjacentHTML</a>(in DOMString position, in DOMString text); - - // <span>metadata attributes</span> - attribute DOMString <a href="#dom-id" title="dom-id">id</a>; - attribute DOMString <a href="#dom-title" title="dom-title">title</a>; - attribute DOMString <a href="#dom-lang" title="dom-lang">lang</a>; - attribute DOMString <a href="#dom-dir" title="dom-dir">dir</a>; - attribute <span>DOMString</span> <a href="#dom-classname" title="dom-className">className</a>; - readonly attribute <a href="urls.html#domtokenlist">DOMTokenList</a> <a href="#dom-classlist" title="dom-classList">classList</a>; - readonly attribute <a href="#domstringmap">DOMStringMap</a> <a href="#dom-dataset" title="dom-dataset">dataset</a>; - - // <a href="microdata.html#microdata">microdata</a> - attribute boolean <a href="#dom-itemscope" title="dom-itemScope">itemScope</a>; - attribute DOMString <a href="#dom-itemtype" title="dom-itemType">itemType</a>; - attribute DOMString <a href="#dom-itemid" title="dom-itemId">itemId</a>; - attribute DOMString <a href="#dom-itemref" title="dom-itemRef">itemRef</a>; - [PutForwards=<a href="#dom-domsettabletokenlist-value" title="dom-DOMSettableTokenList-value">value</a>] readonly attribute <a href="urls.html#domsettabletokenlist">DOMSettableTokenList</a> <a href="#dom-itemprop" title="dom-itemProp">itemProp</a>; - readonly attribute <a href="urls.html#htmlpropertiescollection">HTMLPropertiesCollection</a> <a href="#dom-properties" title="dom-properties">properties</a>; - attribute any <a href="#dom-itemvalue" title="dom-itemValue">itemValue</a>; - - // <a href="editing.html#editing">user interaction</a> - attribute boolean <a href="#dom-hidden" title="dom-hidden">hidden</a>; - void <a href="#dom-click" title="dom-click">click</a>(); - void <a href="#dom-scrollintoview" title="dom-scrollIntoView">scrollIntoView</a>(); - void <a href="#dom-scrollintoview" title="dom-scrollIntoView">scrollIntoView</a>(in boolean top); - attribute long <a href="#dom-tabindex" title="dom-tabindex">tabIndex</a>; - void <a href="#dom-focus" title="dom-focus">focus</a>(); - void <a href="#dom-blur" title="dom-blur">blur</a>(); - attribute DOMString <a href="#dom-accesskey" title="dom-accessKey">accessKey</a>; - readonly attribute DOMString <a href="#dom-accesskeylabel" title="dom-accessKeyLabel">accessKeyLabel</a>; - attribute boolean <a href="#dom-draggable" title="dom-draggable">draggable</a>; - attribute DOMString <a href="#dom-contenteditable" title="dom-contentEditable">contentEditable</a>; - readonly attribute boolean <a href="#dom-iscontenteditable" title="dom-isContentEditable">isContentEditable</a>; - attribute <a href="interactive-elements.html#htmlmenuelement">HTMLMenuElement</a> <a href="#dom-contextmenu" title="dom-contextMenu">contextMenu</a>; - attribute DOMString <a href="#dom-spellcheck" title="dom-spellcheck">spellcheck</a>; - - // <a href="commands.html#command-api">command API</a> - readonly attribute DOMString <a href="#dom-command-ro-commandtype" title="dom-command-ro-commandType">commandType</a>; - readonly attribute DOMString <a href="#dom-command-ro-label" title="dom-command-ro-label">label</a>; - readonly attribute DOMString <a href="#dom-command-ro-icon" title="dom-command-ro-icon">icon</a>; - readonly attribute boolean <a href="#dom-command-ro-disabled" title="dom-command-ro-disabled">disabled</a>; - readonly attribute boolean <a href="#dom-command-ro-checked" title="dom-command-ro-checked">checked</a>;<!-- v2COMMAND - readonly attribute <span>HTMLCollection</span> <span title="dom-command-ro-triggers">triggers</span>;--> - - // <span>styling</span> - readonly attribute <span>CSSStyleDeclaration</span> <a href="#dom-style" title="dom-style">style</a>; - - // <a href="#event-handler-idl-attributes">event handler IDL attributes</a> - attribute <a href="#function">Function</a> <a href="#handler-onabort" title="handler-onabort">onabort</a>; - attribute <a href="#function">Function</a> <a href="#handler-onblur" title="handler-onblur">onblur</a>; - attribute <a href="#function">Function</a> <a href="#handler-oncanplay" title="handler-oncanplay">oncanplay</a>; - attribute <a href="#function">Function</a> <a href="#handler-oncanplaythrough" title="handler-oncanplaythrough">oncanplaythrough</a>; - attribute <a href="#function">Function</a> <a href="#handler-onchange" title="handler-onchange">onchange</a>; - attribute <a href="#function">Function</a> <a href="#handler-onclick" title="handler-onclick">onclick</a>; - attribute <a href="#function">Function</a> <a href="#handler-oncontextmenu" title="handler-oncontextmenu">oncontextmenu</a>; - attribute <a href="#function">Function</a> <a href="#handler-ondblclick" title="handler-ondblclick">ondblclick</a>; - attribute <a href="#function">Function</a> <a href="#handler-ondrag" title="handler-ondrag">ondrag</a>; - attribute <a href="#function">Function</a> <a href="#handler-ondragend" title="handler-ondragend">ondragend</a>; - attribute <a href="#function">Function</a> <a href="#handler-ondragenter" title="handler-ondragenter">ondragenter</a>; - attribute <a href="#function">Function</a> <a href="#handler-ondragleave" title="handler-ondragleave">ondragleave</a>; - attribute <a href="#function">Function</a> <a href="#handler-ondragover" title="handler-ondragover">ondragover</a>; - attribute <a href="#function">Function</a> <a href="#handler-ondragstart" title="handler-ondragstart">ondragstart</a>; - attribute <a href="#function">Function</a> <a href="#handler-ondrop" title="handler-ondrop">ondrop</a>; - attribute <a href="#function">Function</a> <a href="#handler-ondurationchange" title="handler-ondurationchange">ondurationchange</a>; - attribute <a href="#function">Function</a> <a href="#handler-onemptied" title="handler-onemptied">onemptied</a>; - attribute <a href="#function">Function</a> <a href="#handler-onended" title="handler-onended">onended</a>; - attribute <a href="#function">Function</a> <a href="#handler-onerror" title="handler-onerror">onerror</a>; - attribute <a href="#function">Function</a> <a href="#handler-onfocus" title="handler-onfocus">onfocus</a>; - attribute <a href="#function">Function</a> <a href="#handler-onformchange" title="handler-onformchange">onformchange</a>; - attribute <a href="#function">Function</a> <a href="#handler-onforminput" title="handler-onforminput">onforminput</a>; - attribute <a href="#function">Function</a> <a href="#handler-oninput" title="handler-oninput">oninput</a>; - attribute <a href="#function">Function</a> <a href="#handler-oninvalid" title="handler-oninvalid">oninvalid</a>; - attribute <a href="#function">Function</a> <a href="#handler-onkeydown" title="handler-onkeydown">onkeydown</a>; - attribute <a href="#function">Function</a> <a href="#handler-onkeypress" title="handler-onkeypress">onkeypress</a>; - attribute <a href="#function">Function</a> <a href="#handler-onkeyup" title="handler-onkeyup">onkeyup</a>; - attribute <a href="#function">Function</a> <a href="#handler-onload" title="handler-onload">onload</a>; - attribute <a href="#function">Function</a> <a href="#handler-onloadeddata" title="handler-onloadeddata">onloadeddata</a>; - attribute <a href="#function">Function</a> <a href="#handler-onloadedmetadata" title="handler-onloadedmetadata">onloadedmetadata</a>; - attribute <a href="#function">Function</a> <a href="#handler-onloadstart" title="handler-onloadstart">onloadstart</a>; - attribute <a href="#function">Function</a> <a href="#handler-onmousedown" title="handler-onmousedown">onmousedown</a>; - attribute <a href="#function">Function</a> <a href="#handler-onmousemove" title="handler-onmousemove">onmousemove</a>; - attribute <a href="#function">Function</a> <a href="#handler-onmouseout" title="handler-onmouseout">onmouseout</a>; - attribute <a href="#function">Function</a> <a href="#handler-onmouseover" title="handler-onmouseover">onmouseover</a>; - attribute <a href="#function">Function</a> <a href="#handler-onmouseup" title="handler-onmouseup">onmouseup</a>; - attribute <a href="#function">Function</a> <a href="#handler-onmousewheel" title="handler-onmousewheel">onmousewheel</a>; - attribute <a href="#function">Function</a> <a href="#handler-onpause" title="handler-onpause">onpause</a>; - attribute <a href="#function">Function</a> <a href="#handler-onplay" title="handler-onplay">onplay</a>; - attribute <a href="#function">Function</a> <a href="#handler-onplaying" title="handler-onplaying">onplaying</a>; - attribute <a href="#function">Function</a> <a href="#handler-onprogress" title="handler-onprogress">onprogress</a>; - attribute <a href="#function">Function</a> <a href="#handler-onratechange" title="handler-onratechange">onratechange</a>; - attribute <a href="#function">Function</a> <a href="#handler-onreadystatechange" title="handler-onreadystatechange">onreadystatechange</a>; - attribute <a href="#function">Function</a> <a href="#handler-onscroll" title="handler-onscroll">onscroll</a>; - attribute <a href="#function">Function</a> <a href="#handler-onseeked" title="handler-onseeked">onseeked</a>; - attribute <a href="#function">Function</a> <a href="#handler-onseeking" title="handler-onseeking">onseeking</a>; - attribute <a href="#function">Function</a> <a href="#handler-onselect" title="handler-onselect">onselect</a>; - attribute <a href="#function">Function</a> <a href="#handler-onshow" title="handler-onshow">onshow</a>; - attribute <a href="#function">Function</a> <a href="#handler-onstalled" title="handler-onstalled">onstalled</a>; - attribute <a href="#function">Function</a> <a href="#handler-onsubmit" title="handler-onsubmit">onsubmit</a>; - attribute <a href="#function">Function</a> <a href="#handler-onsuspend" title="handler-onsuspend">onsuspend</a>; - attribute <a href="#function">Function</a> <a href="#handler-ontimeupdate" title="handler-ontimeupdate">ontimeupdate</a>; - attribute <a href="#function">Function</a> <a href="#handler-onvolumechange" title="handler-onvolumechange">onvolumechange</a>; - attribute <a href="#function">Function</a> <a href="#handler-onwaiting" title="handler-onwaiting">onwaiting</a>; -}; - -interface <dfn id="htmlunknownelement">HTMLUnknownElement</dfn> : <a href="#htmlelement">HTMLElement</a> { };</pre><p>The <code><a href="#htmlelement">HTMLElement</a></code> interface holds methods and - attributes related to a number of disparate features, and the - members of this interface are therefore described in various - different sections of this specification.</p><h4 id="global-attributes"><span class="secno">3.2.3 </span><dfn>Global attributes</dfn></h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>The following attributes are common to and may be specified on - all <a href="infrastructure.html#html-elements">HTML elements</a>:</p><ul class="brief"><li><code title="attr-accesskey"><a href="editing.html#the-accesskey-attribute">accesskey</a></code></li> - <li><code title="attr-class"><a href="#classes">class</a></code></li> - <li><code title="attr-contenteditable"><a href="editing.html#attr-contenteditable">contenteditable</a></code></li> - <li><code title="attr-contextmenu"><a href="interactive-elements.html#attr-contextmenu">contextmenu</a></code></li> - <li><code title="attr-dir"><a href="#the-dir-attribute">dir</a></code></li> - <li><code title="attr-draggable"><a href="dnd.html#the-draggable-attribute">draggable</a></code></li> - <li><code title="attr-hidden"><a href="editing.html#the-hidden-attribute">hidden</a></code></li> - <li><code title="attr-id"><a href="#the-id-attribute">id</a></code></li> - <li><code title="attr-itemid"><a href="microdata.html#attr-itemid">itemid</a></code></li> - <li><code title="attr-itemprop"><a href="microdata.html#names:-the-itemprop-attribute">itemprop</a></code></li> - <li><code title="attr-itemref"><a href="microdata.html#attr-itemref">itemref</a></code></li> - <li><code title="attr-itemscope"><a href="microdata.html#attr-itemscope">itemscope</a></code></li> - <li><code title="attr-itemtype"><a href="microdata.html#attr-itemtype">itemtype</a></code></li> - <li><code title="attr-lang"><a href="#attr-lang">lang</a></code></li> - <li><code title="attr-spellcheck"><a href="editing.html#attr-spellcheck">spellcheck</a></code></li> - <li><code title="attr-style"><a href="#the-style-attribute">style</a></code></li> - <li><code title="attr-tabindex"><a href="editing.html#attr-tabindex">tabindex</a></code></li> - <li><code title="attr-title"><a href="#the-title-attribute">title</a></code></li> - </ul><hr><p>The following <a href="browsers.html#event-handler-content-attributes">event handler content attributes</a> may - be specified on any <a href="infrastructure.html#html-elements" title="HTML elements">HTML - element</a>:</p><ul class="brief"><li><code title="handler-onabort"><a href="#handler-onabort">onabort</a></code></li> - <li><code title="handler-onblur"><a href="#handler-onblur">onblur</a></code>*</li> - <li><code title="handler-oncanplay"><a href="#handler-oncanplay">oncanplay</a></code></li> - <li><code title="handler-oncanplaythrough"><a href="#handler-oncanplaythrough">oncanplaythrough</a></code></li> - <li><code title="handler-onchange"><a href="#handler-onchange">onchange</a></code></li> - <li><code title="handler-onclick"><a href="#handler-onclick">onclick</a></code></li> - <li><code title="handler-oncontextmenu"><a href="#handler-oncontextmenu">oncontextmenu</a></code></li> - <li><code title="handler-ondblclick"><a href="#handler-ondblclick">ondblclick</a></code></li> - <li><code title="handler-ondrag"><a href="#handler-ondrag">ondrag</a></code></li> - <li><code title="handler-ondragend"><a href="#handler-ondragend">ondragend</a></code></li> - <li><code title="handler-ondragenter"><a href="#handler-ondragenter">ondragenter</a></code></li> - <li><code title="handler-ondragleave"><a href="#handler-ondragleave">ondragleave</a></code></li> - <li><code title="handler-ondragover"><a href="#handler-ondragover">ondragover</a></code></li> - <li><code title="handler-ondragstart"><a href="#handler-ondragstart">ondragstart</a></code></li> - <li><code title="handler-ondrop"><a href="#handler-ondrop">ondrop</a></code></li> - <li><code title="handler-ondurationchange"><a href="#handler-ondurationchange">ondurationchange</a></code></li> - <li><code title="handler-onemptied"><a href="#handler-onemptied">onemptied</a></code></li> - <li><code title="handler-onended"><a href="#handler-onended">onended</a></code></li> - <li><code title="handler-onerror"><a href="#handler-onerror">onerror</a></code>*</li> - <li><code title="handler-onfocus"><a href="#handler-onfocus">onfocus</a></code>*</li> - <li><code title="handler-onformchange"><a href="#handler-onformchange">onformchange</a></code></li> - <li><code title="handler-onforminput"><a href="#handler-onforminput">onforminput</a></code></li> - <li><code title="handler-oninput"><a href="#handler-oninput">oninput</a></code></li> - <li><code title="handler-oninvalid"><a href="#handler-oninvalid">oninvalid</a></code></li> - <li><code title="handler-onkeydown"><a href="#handler-onkeydown">onkeydown</a></code></li> - <li><code title="handler-onkeypress"><a href="#handler-onkeypress">onkeypress</a></code></li> - <li><code title="handler-onkeyup"><a href="#handler-onkeyup">onkeyup</a></code></li> - <li><code title="handler-onload"><a href="#handler-onload">onload</a></code>*</li> - <li><code title="handler-onloadeddata"><a href="#handler-onloadeddata">onloadeddata</a></code></li> - <li><code title="handler-onloadedmetadata"><a href="#handler-onloadedmetadata">onloadedmetadata</a></code></li> - <li><code title="handler-onloadstart"><a href="#handler-onloadstart">onloadstart</a></code></li> - <li><code title="handler-onmousedown"><a href="#handler-onmousedown">onmousedown</a></code></li> - <li><code title="handler-onmousemove"><a href="#handler-onmousemove">onmousemove</a></code></li> - <li><code title="handler-onmouseout"><a href="#handler-onmouseout">onmouseout</a></code></li> - <li><code title="handler-onmouseover"><a href="#handler-onmouseover">onmouseover</a></code></li> - <li><code title="handler-onmouseup"><a href="#handler-onmouseup">onmouseup</a></code></li> - <li><code title="handler-onmousewheel"><a href="#handler-onmousewheel">onmousewheel</a></code></li> - <li><code title="handler-onpause"><a href="#handler-onpause">onpause</a></code></li> - <li><code title="handler-onplay"><a href="#handler-onplay">onplay</a></code></li> - <li><code title="handler-onplaying"><a href="#handler-onplaying">onplaying</a></code></li> - <li><code title="handler-onprogress"><a href="#handler-onprogress">onprogress</a></code></li> - <li><code title="handler-onratechange"><a href="#handler-onratechange">onratechange</a></code></li> - <li><code title="handler-onreadystatechange"><a href="#handler-onreadystatechange">onreadystatechange</a></code></li> - <li><code title="handler-onscroll"><a href="#handler-onscroll">onscroll</a></code></li> - <li><code title="handler-onseeked"><a href="#handler-onseeked">onseeked</a></code></li> - <li><code title="handler-onseeking"><a href="#handler-onseeking">onseeking</a></code></li> - <li><code title="handler-onselect"><a href="#handler-onselect">onselect</a></code></li> - <li><code title="handler-onshow"><a href="#handler-onshow">onshow</a></code></li> - <li><code title="handler-onstalled"><a href="#handler-onstalled">onstalled</a></code></li> - <li><code title="handler-onsubmit"><a href="#handler-onsubmit">onsubmit</a></code></li> - <li><code title="handler-onsuspend"><a href="#handler-onsuspend">onsuspend</a></code></li> - <li><code title="handler-ontimeupdate"><a href="#handler-ontimeupdate">ontimeupdate</a></code></li> - <li><code title="handler-onvolumechange"><a href="#handler-onvolumechange">onvolumechange</a></code></li> - <li><code title="handler-onwaiting"><a href="#handler-onwaiting">onwaiting</a></code></li> - </ul><p class="note">The attributes marked with an asterisk have a - different meaning when specified on <code><a href="sections.html#the-body-element-0">body</a></code> elements as - those elements expose <a href="browsers.html#event-handlers">event handlers</a> of the - <code><a href="browsers.html#window">Window</a></code> object with the same names.</p><p class="note">While these attributes apply to all elements, they - are not useful on all elements. For example, only <a href="video.html#media-element" title="media - element">media elements</a> will ever receive a <code title="event-media-volumechange"><a href="video.html#event-media-volumechange">volumechange</a></code> event fired by - the user agent.</p><hr><p><a href="#custom-data-attribute" title="custom data attribute">Custom data attributes</a> - (e.g. <code title="">data-foldername</code> or <code title="">data-msgid</code>) can be specified on any <a href="infrastructure.html#html-elements" title="HTML elements">HTML element</a>, to store custom data - specific to the page.</p><hr><p>In <a href="dom.html#html-documents">HTML documents</a>, elements in the <a href="#html-namespace-0">HTML - namespace</a> may have an <code title="">xmlns</code> attribute - specified, if, and only if, it has the exact value - "<code>http://www.w3.org/1999/xhtml</code>". This does not apply to - <a href="dom.html#xml-documents">XML documents</a>.</p><p class="note">In HTML, the <code title="">xmlns</code> attribute - has absolutely no effect. It is basically a talisman. It is allowed - merely to make migration to and from XHTML mildly easier. When - parsed by an <a href="#html-parser">HTML parser</a>, the attribute ends up in no - namespace, not the "<code>http://www.w3.org/2000/xmlns/</code>" - namespace like namespace declaration attributes in XML do.</p><p class="note">In XML, an <code title="">xmlns</code> attribute is - part of the namespace declaration mechanism, and an element cannot - actually have an <code title="">xmlns</code> attribute in no - namespace specified.</p><hr><p>To enable assistive technology products to expose a more - fine-grained interface than is otherwise possible with HTML elements - and attributes, a set of <a href="content-models.html#annotations-for-assistive-technology-products-aria">annotations for assistive technology - products</a> can be specified.</p><h5 id="the-id-attribute"><span class="secno">3.2.3.1 </span>The <dfn title="attr-id"><code>id</code></dfn> attribute</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>The <code title="attr-id"><a href="#the-id-attribute">id</a></code> attribute specifies its - element's <dfn id="concept-id" title="concept-id">unique identifier (ID)</dfn>. The - value must be unique amongst all the IDs in the element's <a href="infrastructure.html#home-subtree">home - subtree</a> and must contain at least one character. The value - must not contain any <a href="#space-character" title="space character">space - characters</a>.</p><!-- space characters are disallowed because space-separated lists - of IDs otherwise would not be able to reach all valid IDs --><p class="note">An element's <a href="#concept-id" title="concept-id">unique - identifier</a> can be used for a variety of purposes, most - notably as a way to link to specific parts of a document using - fragment identifiers, as a way to target an element when scripting, - and as a way to style a specific element from CSS.</p><h5 id="the-title-attribute"><span class="secno">3.2.3.2 </span>The <dfn title="attr-title"><code>title</code></dfn> attribute</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>The <code title="attr-title"><a href="#the-title-attribute">title</a></code> attribute - <a href="#represents">represents</a> advisory information for the element, such - as would be appropriate for a tooltip. On a link, this could be the - title or a description of the target resource; on an image, it could - be the image credit or a description of the image; on a paragraph, - it could be a footnote or commentary on the text; on a citation, it - could be further information about the source; and so forth. The - value is text.</p><p>If this attribute is omitted from an element, then it implies - that the <code title="attr-title"><a href="#the-title-attribute">title</a></code> attribute of the - nearest ancestor <a href="infrastructure.html#html-elements" title="HTML elements">HTML element</a> - with a <code title="attr-title"><a href="#the-title-attribute">title</a></code> attribute set is also - relevant to this element. Setting the attribute overrides this, - explicitly stating that the advisory information of any ancestors is - not relevant to this element. Setting the attribute to the empty - string indicates that the element has no advisory information.</p><p>If the <code title="attr-title"><a href="#the-title-attribute">title</a></code> attribute's value - contains U+000A LINE FEED (LF) characters, the content is split into - multiple lines. Each U+000A LINE FEED (LF) character represents a - line break.</p><div class="example"> - - <p>Caution is advised with respect to the use of newlines in <code title="attr-title"><a href="#the-title-attribute">title</a></code> attributes.</p> - - <p>For instance, the following snippet actually defines an - abbreviation's expansion <em>with a line break in it</em>:</p> - - <pre class="bad"><p>My logs show that there was some interest in <abbr title="Hypertext -Transport Protocol">HTTP</abbr> today.</p></pre> - - </div><p>Some elements, such as <code><a href="semantics.html#the-link-element">link</a></code>, <code><a href="text-level-semantics.html#the-abbr-element">abbr</a></code>, and - <code><a href="the-input-element.html#the-input-element">input</a></code>, define additional semantics for the <code title="attr-title"><a href="#the-title-attribute">title</a></code> attribute beyond the semantics - described above.</p><h5 id="the-lang-and-xml:lang-attributes"><span class="secno">3.2.3.3 </span>The <code title="attr-lang"><a href="#attr-lang">lang</a></code> and <code title="attr-xml-lang"><a href="#attr-xml-lang">xml:lang</a></code> attributes</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>The <dfn id="attr-lang" title="attr-lang"><code>lang</code></dfn> attribute (in - no namespace) specifies the primary <dfn id="language">language</dfn> for the - element's contents and for any of the element's attributes that - contain text. Its value must be a valid BCP 47 language code, or - the empty string. <a href="references.html#refsBCP47">[BCP47]</a></p><p>The <dfn id="attr-xml-lang" title="attr-xml-lang"><code title="">lang</code></dfn> - attribute in the <a href="#xml-namespace">XML namespace</a> is defined in XML. <a href="references.html#refsXML">[XML]</a></p><p>If these attributes are omitted from an element, then the - language of this element is the same as the language of its parent - element, if any. Setting the attribute to the empty string indicates - that the primary language is unknown.</p><!-- UA conformance - requires for this are below --><p>The <code title="attr-lang"><a href="#attr-lang">lang</a></code> attribute in no namespace - may be used on any <a href="infrastructure.html#html-elements" title="HTML elements">HTML - element</a>.</p><p>The <a href="#attr-xml-lang" title="attr-xml-lang"><code title="">lang</code> - attribute in the <span>XML namespace</span></a> may be used on - <a href="infrastructure.html#html-elements">HTML elements</a> in <a href="dom.html#xml-documents">XML documents</a>, as well as - elements in other namespaces if the relevant specifications allow it - (in particular, MathML and SVG allow <a href="#attr-xml-lang" title="attr-xml-lang"><code title="">lang</code> attributes in the - <span>XML namespace</span></a> to be specified on their - elements). If both the <code title="attr-lang"><a href="#attr-lang">lang</a></code> attribute - in no namespace and the <a href="#attr-xml-lang" title="attr-xml-lang"><code title="">lang</code> attribute in the <span>XML - namespace</span></a> are specified on the same element, they must - have exactly the same value when compared in an <a href="infrastructure.html#ascii-case-insensitive">ASCII - case-insensitive</a> manner.</p><p>Authors must not use the <a href="#attr-xml-lang" title="attr-xml-lang"><code title="">lang</code> attribute in the <span>XML - namespace</span></a> on <a href="infrastructure.html#html-elements">HTML elements</a> in <a href="dom.html#html-documents">HTML - documents</a>. To ease migration to and from XHTML, authors may - specify an attribute in no namespace with no prefix and with the - literal localname "<code title="">xml:lang</code>" on <a href="infrastructure.html#html-elements">HTML - elements</a> in <a href="dom.html#html-documents">HTML documents</a>, but such attributes - must only be specified if a <code title="attr-lang"><a href="#attr-lang">lang</a></code> - attribute in no namespace is also specified, and both attributes - must have the same value when compared in an <a href="infrastructure.html#ascii-case-insensitive">ASCII - case-insensitive</a> manner.</p><p class="note">The attribute in no namespace with no prefix and - with the literal localname "<code title="">xml:lang</code>" has no - effect on language processing.</p><h5 id="the-xml:base-attribute-xml-only"><span class="secno">3.2.3.4 </span>The <dfn title="attr-xml-base"><code>xml:base</code></dfn> - attribute (XML only)</h5><p>The <code title="attr-xml-base"><a href="#the-xml:base-attribute-xml-only">xml:base</a></code> attribute is - defined in XML Base. <a href="references.html#refsXMLBASE">[XMLBASE]</a></p><p>The <code title="attr-xml-base"><a href="#the-xml:base-attribute-xml-only">xml:base</a></code> attribute may be - used on elements of <a href="dom.html#xml-documents">XML documents</a>. Authors must not - use the <code title="attr-xml-base"><a href="#the-xml:base-attribute-xml-only">xml:base</a></code> attribute in - <a href="dom.html#html-documents">HTML documents</a>.</p><h5 id="the-dir-attribute"><span class="secno">3.2.3.5 </span>The <dfn title="attr-dir"><code>dir</code></dfn> attribute</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>The <code title="attr-dir"><a href="#the-dir-attribute">dir</a></code> attribute specifies the - element's text directionality. The attribute is an <a href="common-microsyntaxes.html#enumerated-attribute">enumerated - attribute</a> with the keyword <code title="">ltr</code> mapping - to the state <i>ltr</i>, and the keyword <code title="">rtl</code> - mapping to the state <i>rtl</i>. The attribute has no - defaults.</p><p><dfn id="the-directionality">The directionality</dfn> of an element, which is used in - particular by the <code><a href="the-canvas-element.html#the-canvas-element">canvas</a></code> element's text rendering API, - is either 'ltr' or 'rtl'. If the user agent supports CSS and the - 'direction' property on this element has a computed value of either - 'ltr' or 'rtl', then that is <a href="#the-directionality">the directionality</a> of the - element. Otherwise, if the element is <a href="#being-rendered">being rendered</a>, - then <a href="#the-directionality">the directionality</a> of the element is the - directionality used by the presentation layer, potentially - determined from the value of the <code title="attr-dir"><a href="#the-dir-attribute">dir</a></code> - attribute on the element. Otherwise, if the element's <code title="attr-dir"><a href="#the-dir-attribute">dir</a></code> attribute has the state <i>ltr</i>, the - element's directionality is 'ltr' (left-to-right); if the attribute - has the state <i>rtl</i>, the element's directionality is 'rtl' - (right-to-left); and otherwise, the element's directionality is the - same as its parent element, or 'ltr' if there is no parent - element.</p><hr><dl class="domintro"><dt><var title="">document</var> . <code title="dom-dir"><a href="#dom-dir">dir</a></code> [ = <var title="">value</var> ]</dt> - <dd> - <p>Returns <a href="dom.html#the-html-element">the <code>html</code> element</a>'s <code title="attr-dir"><a href="#the-dir-attribute">dir</a></code> attribute's value, if any.</p> - <p>Can be set, to either "<code title="">ltr</code>" or "<code title="">rtl</code>", to replace <a href="dom.html#the-html-element">the <code>html</code> element</a>'s <code title="attr-dir"><a href="#the-dir-attribute">dir</a></code> attribute's value.</p> - <p>If there is no <a href="dom.html#the-html-element" title="the html element"><code>html</code> element</a>, returns the empty string and ignores new values.</p> - </dd> - - </dl><p class="note">Authors are strongly encouraged to use the <code title="attr-dir"><a href="#the-dir-attribute">dir</a></code> attribute to indicate text direction - rather than using CSS, since that way their documents will continue - to render correctly even in the absence of CSS (e.g. as interpreted - by search engines).</p><h5 id="classes"><span class="secno">3.2.3.6 </span>The <dfn title="attr-class"><code>class</code></dfn> attribute</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>Every <a href="infrastructure.html#html-elements" title="HTML elements">HTML element</a> may have a - <code title="attr-class"><a href="#classes">class</a></code> attribute specified.</p><p>The attribute, if specified, must have a value that is a - <a href="common-microsyntaxes.html#set-of-space-separated-tokens">set of space-separated tokens</a> representing the various - classes that the element belongs to.</p><p class="note">Assigning classes to an element affects class - matching in selectors in CSS, the <code title="dom-document-getElementsByClassName"><a href="#dom-document-getelementsbyclassname">getElementsByClassName()</a></code> - method in the DOM, and other such features.</p><p>There are no additional restrictions on the tokens authors can - use in the <code title="attr-class"><a href="#classes">class</a></code> attribute, but - authors are encouraged to use values that describe the nature of the - content, rather than values that describe the desired presentation - of the content.</p><h5 id="the-style-attribute"><span class="secno">3.2.3.7 </span>The <dfn title="attr-style"><code>style</code></dfn> attribute</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>All <a href="infrastructure.html#html-elements">HTML elements</a> may have the <code title="attr-style"><a href="#the-style-attribute">style</a></code> content attribute set. If specified, - the attribute must contain only a list of zero or more - semicolon-separated (;) CSS declarations. <a href="references.html#refsCSS">[CSS]</a></p><p>Documents that use <code title="attr-style"><a href="#the-style-attribute">style</a></code> - attributes on any of their elements must still be comprehensible and - usable if those attributes were removed.</p><p class="note">In particular, using the <code title="attr-style"><a href="#the-style-attribute">style</a></code> attribute to hide and show content, - or to convey meaning that is otherwise not included in the document, - is non-conforming. (To hide and show content, use the <code title="attr-hidden"><a href="editing.html#the-hidden-attribute">hidden</a></code> attribute.)</p><hr><dl class="domintro"><dt><var title="">element</var> . <code title="dom-style"><a href="#dom-style">style</a></code></dt> - <dd> - <p>Returns a <code>CSSStyleDeclaration</code> object for the element's <code title="attr-style"><a href="#the-style-attribute">style</a></code> attribute.</p> - </dd> - - </dl><div class="example"> - - <p>In the following example, the words that refer to colors are - marked up using the <code><a href="text-level-semantics.html#the-span-element">span</a></code> element and the <code title="attr-style"><a href="#the-style-attribute">style</a></code> attribute to make those words show - up in the relevant colors in visual media.</p> - - <pre><p>My sweat suit is <span style="color: green; background: -transparent">green</span> and my eyes are <span style="color: blue; -background: transparent">blue</span>.</p></pre> - - </div><h5 id="embedding-custom-non-visible-data"><span class="secno">3.2.3.8 </span><dfn>Embedding custom non-visible data</dfn></h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>A <dfn id="custom-data-attribute">custom data attribute</dfn> is an attribute in no - namespace whose name starts with the string "<dfn id="attr-data" title="attr-data-*"><code>data-</code></dfn>", has at least one - character after the hyphen, is <a href="infrastructure.html#xml-compatible">XML-compatible</a>, and - contains no characters in the range U+0041 to U+005A (LATIN CAPITAL - LETTER A to LATIN CAPITAL LETTER Z).</p><p class="note">All attributes on <a href="infrastructure.html#html-elements">HTML elements</a> in - <a href="dom.html#html-documents">HTML documents</a> get ASCII-lowercased automatically, so - the restriction on ASCII uppercase letters doesn't affect such - documents.</p><p><a href="#custom-data-attribute" title="custom data attribute">Custom data attributes</a> - are intended to store custom data private to the page or - application, for which there are no more appropriate attributes or - elements.</p><p>These attributes are not intended for use by software that is - independent of the site that uses the attributes.</p><div class="example"> - - <p>For instance, a site about music could annotate list items - representing tracks in an album with custom data attributes - containing the length of each track. This information could then be - used by the site itself to allow the user to sort the list by track - length, or to filter the list for tracks of certain lengths.</p> - - <pre><ol> - <li data-length="2m11s">Beyond The Sea</li> - ... -</ol></pre> - - <p>It would be inappropriate, however, for the user to use generic - software not associated with that music site to search for tracks - of a certain length by looking at this data.</p> - - <p>This is because these attributes are intended for use by the - site's own scripts, and are not a generic extension mechanism for - publicly-usable metadata.</p> - - </div><p>Every <a href="infrastructure.html#html-elements" title="HTML elements">HTML element</a> may have - any number of <a href="#custom-data-attribute" title="custom data attribute">custom data - attributes</a> specified, with any value.</p><hr><dl class="domintro"><dt><var title="">element</var> . <code title="dom-dataset"><a href="#dom-dataset">dataset</a></code></dt> - <dd> - <p>Returns a <code><a href="#domstringmap">DOMStringMap</a></code> object for the element's <code title="attr-data-*"><a href="#attr-data">data-*</a></code> attributes.</p> - </dd> - - </dl><div class="example"> - - <p>If a Web page wanted an element to represent a space ship, - e.g. as part of a game, it would have to use the <code class="attr-class">class</code> attribute along with <code title="attr-data-*"><a href="#attr-data">data-*</a></code> attributes:</p> - - <pre><div class="spaceship" data-id="92432" - data-weapons="laser 2" data-shields="50%" - data-x="30" data-y="10" data-z="90"> - <button class="fire" - onclick="spaceships[this.parentNode.dataset.id].fire()"> - Fire - </button> -</div></pre> - - </div><p>Authors should carefully design such extensions so that when the - attributes are ignored and any associated CSS dropped, the page is - still usable.</p><h4 id="element-definitions"><span class="secno">3.2.4 </span>Element definitions</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>Each element in this specification has a definition that includes - the following information:</p><dl><dt>Categories</dt> - - <dd>A list of <a href="content-models.html#content-categories" title="content categories">categories</a> to - which the element belongs. These are used when defining the - <a href="content-models.html#content-models">content models</a> for each element.</dd> - - - <dt>Contexts in which this element may be used</dt> - - <dd>A <em>non-normative</em> description of where the element can - be used. This information is redundant with the content models of - elements that allow this one as a child, and is provided only as a - convenience.</dd> - - - <dt>Content model</dt> - - <dd>A normative description of what content must be included as - children and descendants of the element.</dd> - - - <dt>Content attributes</dt> - - <dd>A normative list of attributes that may be specified on the - element.</dd> - - - <dt>DOM interface</dt> - - <dd>A normative definition of a DOM interface that such elements - must implement.</dd> - - </dl><p>This is then followed by a description of what the element - <a href="#represents">represents</a>, along with any additional normative - conformance criteria that may apply to authors. Examples are sometimes - also included.</p></body></html> \ No newline at end of file Index: content-models.html =================================================================== RCS file: /sources/public/html5/spec-author-view/content-models.html,v retrieving revision 1.8 retrieving revision 1.9 diff -u -d -r1.8 -r1.9 --- content-models.html 3 Jan 2010 15:08:14 -0000 1.8 +++ content-models.html 3 Jan 2010 15:10:30 -0000 1.9 @@ -1,216 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"> -<!DOCTYPE html> -<!-- when publishing, change bits marked ZZZ --><html lang="en-US-x-Hixie" class="split chapter"><head><title>3.2.5 Content models — HTML5 (Author Edition)</title><script src="link-fixup.js"></script><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 { 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: #EEFFEE; } - 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; } - - 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; } - - .tall-and-narrow { - font-size: 0.6em; - column-width: 25em; - column-gap: 1em; - -moz-column-width: 25em; - -moz-column-gap: 1em; - -webkit-column-width: 25em; - -webkit-column-gap: 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; } - - #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: 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; } - - #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-ex \ No newline at end of file Index: apis-in-html-documents.html =================================================================== RCS file: /sources/public/html5/spec-author-view/apis-in-html-documents.html,v retrieving revision 1.7 retrieving revision 1.8 diff -u -d -r1.7 -r1.8 --- apis-in-html-documents.html 1 Jan 2010 06:10:27 -0000 1.7 +++ apis-in-html-documents.html 3 Jan 2010 15:10:30 -0000 1.8 @@ -1,520 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"> -<!DOCTYPE html> -<!-- when publishing, change bits marked ZZZ --><html lang="en-US-x-Hixie" class="split chapter"><head><title>3.3 APIs in HTML documents — HTML5 (Author Edition)</title><script src="link-fixup.js"></script><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 { 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: #EEFFEE; } - 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; } - - 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; } - - .tall-and-narrow { - font-size: 0.6em; - column-width: 25em; - column-gap: 1em; - -moz-column-width: 25em; - -moz-column-gap: 1em; - -webkit-column-width: 25em; - -webkit-column-gap: 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; } - - #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: 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; } - - #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; } - - </style><link href="data:text/css," rel="stylesheet" title="Complete specification"><link href="data:text/css,.impl%20%7B%20display:%20none;%20%7D" rel="alternate stylesheet" title="Author documentation only"><link href="data:text/css,.impl%20%7B%20background:%20%23FFEEEE;%20%7D" rel="alternate stylesheet" title="Highlight implementation requirements"><link href="data:text/css," id="complete" rel="stylesheet" title="Complete specification"><link href="data:text/css,.impl%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" id="highlight" rel="alternate stylesheet" title="Highlight implementation requirements"><script> - 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', 'http://www.whatwg.org/specs/web-apps/current-work/' + 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); - // load('reviewer.js'); // would need cross-site XHR - if (document.getElementById('head')) - load('toc.js'); - - // load('updater.js'); // would need cross-site XHR - load('dfn.js'); - // load('status.js'); // would need cross-site XHR - 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="content-models.html" title="3.2.5 Content models" rel="prev"> - <link href="Overview.html#contents" title="Table of contents" rel="index"> - <link href="semantics.html" title="4 The elements of HTML" 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 (Author Edition)</h1> - </div><div> - <a href="content-models.html">← 3.2.5 Content models</a> – - <a href="Overview.html#contents">Table of contents</a> – - <a href="semantics.html">4 The elements of HTML →</a> - <ol class="toc"><li><ol><li><a href="apis-in-html-documents.html#apis-in-html-documents"><span class="secno">3.3 </span>APIs in HTML documents</a></li><li><a href="apis-in-html-documents.html#dynamic-markup-insertion"><span class="secno">3.4 </span>Dynamic markup insertion</a> - <ol><li><a href="apis-in-html-documents.html#opening-the-input-stream"><span class="secno">3.4.1 </span>Opening the input stream</a></li><li><a href="apis-in-html-documents.html#closing-the-input-stream"><span class="secno">3.4.2 </span>Closing the input stream</a></li><li><a href="apis-in-html-documents.html#document.write"><span class="secno">3.4.3 </span><code title="dom-document-write">document.write()</code></a></li><li><a href="apis-in-html-documents.html#document.writeln"><span class="secno">3.4.4 </span><code title="dom-document-writeln">document.writeln()</code></a></li><li><a href="apis-in-html-documents.html#innerhtml"><span class="secno">3.4.5 </span><code title="dom-innerHTML">innerHTML</code></a></li><li><a href="apis-in-html-documents.html#outerhtml"><span class="secno">3.4.6 </span><code title="dom-outerHTML">outerHTML</code></a></li><li><a href="apis-in-html-documents.html#insertadjacenthtml"><span class="secno">3.4.7 </span><code title="dom-insertAdjacentHTML">insertAdjacentHTML()</coe></a></li></ol></li></ol></li></ol></div> - - <h3 id="apis-in-html-documents"><span class="secno">3.3 </span>APIs in HTML documents</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>For <a href="dom.html#html-documents">HTML documents</a>, and for <a href="infrastructure.html#html-elements">HTML - elements</a> in <a href="dom.html#html-documents">HTML documents</a>, certain APIs defined - in DOM Core become case-insensitive or case-changing, as sometimes - defined in DOM Core, and as summarized below. <a href="references.html#refsDOMCORE">[DOMCORE]</a></p><p>This does not apply to <a href="dom.html#xml-documents">XML documents</a> or to elements - that are not in the <a href="#html-namespace-0">HTML namespace</a> despite being in - <a href="dom.html#html-documents">HTML documents</a>.</p><dl><dt><code title="">Element.tagName</code> and <code title="">Node.nodeName</code></dt> - - <dd> - - <p>These attributes must<a href="#converted-to-ascii-uppercase">converted to ASCII uppercase</a>, regardless of the case - with which they were created.</p> - - </dd> - - - <dt><code title="">Document.createElement()</code></dt> - - <dd> - - <p>The canonical form of HTML markup is all-lowercase; thus, this - method will <a href="#converted-to-ascii-lowercase" title="converted to ASCII lowercase">lowercase</a> - the argument before creating the requisite element. .</p> - - <p class="note">This doesn't apply to <code title="">Document.createElementNS()</code>. Thus, it is possible, - by passing this last method a tag name in the wrong case, to - create an element that claims to have the tag name of an element - defined in this specification, but doesn't support its interfaces, - because it really has another tag name not accessible from the DOM - APIs.</p> - - </dd> - - - <dt><code title="">Element.setAttribute()</code></dt> - <dt><code title="">Element.setAttributeNode()</code></dt> - - <dd> - - <p>Attribute names are <a href="#converted-to-ascii-lowercase">converted to ASCII lowercase</a>.</p> - - - - <p class="note">This doesn't apply to <code title="">Document.setAttributeNS()</code> and <code title="">Document.setAttributeNodeNS()</code>.</p> - - </dd> - - - <dt><code title="">Element.getAttribute()</code></dt> - <dt><code title="">Element.getAttributeNode()</code></dt> - - <dd> - - <p>Attribute names are <a href="#converted-to-ascii-lowercase">converted to ASCII lowercase</a>.</p> - - - - <p class="note">This doesn't apply to <code title="">Document.getAttributeNS()</code> and <code title="">Document.getAttributeNodeNS()</code>.</p> - - </dd> - - - <dt><code title="">Document.getElementsByTagName()</code></dt> - <dt><code title="">Element.getElementsByTagName()</code></dt> - - <dd> - - <p>HTML elements match by lower-casing the argument before - comparison, elements from other namespaces are treated as in XML - (case-sensitively).</p> - - - - <p class="note">Thus, in an <a href="dom.html#html-documents" title="HTML documents">HTML - document</a> with nodes in multiple namespaces, these methods - will effectively be both case-sensitive and case-insensitive at - the same time.</p> - - </dd> - - - </dl><h3 id="dynamic-markup-insertion"><span class="secno">3.4 </span><dfn>Dynamic markup insertion</dfn></h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p class="note">APIs for dynamically inserting markup into the - document interact with the parser, and thus their behavior varies - depending on whether they are used with <a href="dom.html#html-documents">HTML documents</a> - (and the <a href="#html-parser">HTML parser</a>) or XHTML in <a href="dom.html#xml-documents">XML - documents</a> (and the <a href="#xml-parser">XML parser</a>).</p><h4 id="opening-the-input-stream"><span class="secno">3.4.1 </span>Opening the input stream</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>The <dfn id="dom-document-open" title="dom-document-open"><code>open()</code></dfn> - method comes in several variants with different numbers of - arguments.</p><dl class="domintro"><dt><var title="">document</var> = <var title="">document</var> . <code title="dom-document-open"><a href="#dom-document-open">open</a></code>( [ <var title="">type</var> [, <var title="">replace</var> ] ] )</dt> - - <dd> - - <p>Causes the <code>Document</code> to be replaced in-place, as if - it was a new <code>Document</code> object, but reusing the - previous object, which is then returned.</p> - - <p>If the <var title="">type</var> argument is omitted or has the - value "<code><a href="iana.html#text-html">text/html</a></code>", then the resulting - <code>Document</code> has an HTML parser associated with it, which - can be given data to parse using <code title="dom-document-write"><a href="#dom-document-write">document.write()</a></code>. Otherwise, all - content passed to <code title="dom-document-write"><a href="#dom-document-write">document.write()</a></code> will be parsed - as plain text.</p> - - <p>If the <var title="">replace</var> argument is present and has - the value "<code title="">replace</code>", the existing entries in - the session history for the <code>Document</code> object are - removed.</p> - - <p>The method has no effect if the <code>Document</code> is still - being parsed.</p> - - <p>Throws an <code><a href="urls.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception if the - <code>Document</code> is an <a href="dom.html#xml-documents" title="XML documents">XML - document</a>.</p> - - </dd> - - <dt><var title="">window</var> = <var title="">document</var> . <code title="dom-document-open"><a href="#dom-document-open">open</a></code>( <var title="">url</var>, <var title="">name</var>, <var title="">features</var> [, <var title="">replace</var> ] )</dt> - - <dd> - - <p>Works like the <code title="dom-open"><a href="#dom-open">window.open()</a></code> - method.</p> - - </dd> - - </dl><h4 id="closing-the-input-stream"><span class="secno">3.4.2 </span>Closing the input stream</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-close"><a href="#dom-document-close">close</a></code>()</dt> - - <dd> - - <p>Closes the input stream that was opened by the <code title="dom-document-open"><a href="#dom-document-open">document.open()</a></code> method.</p> - - <p>Throws an <code><a href="urls.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception if the - <code>Document</code> is an <a href="dom.html#xml-documents" title="XML documents">XML - document</a>.</p> - - </dd> - - </dl><h4 id="document.write"><span class="secno">3.4.3 </span><code title="dom-document-write"><a href="#dom-document-write">document.write()</a></code></h4><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-write"><a href="#dom-document-write">write</a></code>(<var title="">text</var>...)</dt> - - <dd> - - <p>Adds the given string(s) to the <code>Document</code>'s input - stream. If necessary, calls the <code title="dom-document-open"><a href="#dom-document-open">open()</a></code> method implicitly - first.</p> - - <p>This method throws an <code><a href="urls.html#invalid_access_err">INVALID_ACCESS_ERR</a></code> exception - when invoked on <a href="dom.html#xml-documents">XML documents</a>.</p> - - </dd> - - </dl><h4 id="document.writeln"><span class="secno">3.4.4 </span><code title="dom-document-writeln"><a href="#dom-document-writeln">document.writeln()</a></code></h4><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-writeln"><a href="#dom-document-writeln">writeln</a></code>(<var title="">text</var>...)</dt> - - <dd> - - <p>Adds the given string(s) to the <code>Document</code>'s input - stream, followed by a newline character. If necessary, calls the - <code title="dom-document-open"><a href="#dom-document-open">open()</a></code> method implicitly - first.</p> - - <p>This method throws an <code><a href="urls.html#invalid_access_err">INVALID_ACCESS_ERR</a></code> exception - when invoked on <a href="dom.html#xml-documents">XML documents</a>.</p> - - </dd> - - </dl><h4 id="innerhtml"><span class="secno">3.4.5 </span><code title="dom-innerHTML"><a href="#dom-innerhtml">innerHTML</a></code></h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>The <dfn id="dom-innerhtml" title="dom-innerHTML"><code>innerHTML</code></dfn> IDL - attribute represents the markup of the node's contents.</p><dl class="domintro"><dt><var title="">document</var> . <code title="dom-innerHTML"><a href="#dom-innerhtml">innerHTML</a></code> [ = <var title="">value</var> ]</dt> - - <dd> - - <p>Returns a fragment of HTML or XML that represents the - <code>Document</code>.</p> - - <p>Can be set, to replace the <code>Document</code>'s contents - with the result of parsing the given string.</p> - - <p>In the case of <a href="dom.html#xml-documents">XML documents</a>, will throw an - <code><a href="urls.html#invalid_state_err">INVALID_STATE_ERR</a></code> if the <code>Document</code> cannot - be serialized to XML, and a <code><a href="urls.html#syntax_err">SYNTAX_ERR</a></code> if the given - string is not well-formed.</p> - - </dd> - - <dt><var title="">element</var> . <code title="dom-innerHTML"><a href="#dom-innerhtml">innerHTML</a></code> [ = <var title="">value</var> ]</dt> - - <dd> - - <p>Returns a fragment of HTML or XML that represents the element's - contents.</p> - - <p>Can be set, to replace the contents of the element with nodes - parsed from the given string.</p> - - <p>In the case of <a href="dom.html#xml-documents">XML documents</a>, will throw an - <code><a href="urls.html#invalid_state_err">INVALID_STATE_ERR</a></code> if the element cannot be serialized - to XML, and a <code><a href="urls.html#syntax_err">SYNTAX_ERR</a></code> if the given string is not - well-formed.</p> - - </dd> - - </dl><h4 id="outerhtml"><span class="secno">3.4.6 </span><code title="dom-outerHTML"><a href="#dom-outerhtml">outerHTML</a></code></h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>The <dfn id="dom-outerhtml" title="dom-outerHTML"><code>outerHTML</code></dfn> IDL - attribute represents the markup of the element and its contents.</p><dl class="domintro"><dt><var title="">element</var> . <code title="dom-outerHTML"><a href="#dom-outerhtml">outerHTML</a></code> [ = <var title="">value</var> ]</dt> - - <dd> - - <p>Returns a fragment of HTML or XML that represents the element - and its contents.</p> - - <p>Can be set, to replace the element with nodes parsed from the - given string.</p> - - <p>In the case of <a href="dom.html#xml-documents">XML documents</a>, will throw an - <code><a href="urls.html#invalid_state_err">INVALID_STATE_ERR</a></code> if the element cannot be serialized - to XML, and a <code><a href="urls.html#syntax_err">SYNTAX_ERR</a></code> if the given string is not - well-formed.</p> - - <p>Throws a <code><a href="urls.html#no_modification_allowed_err">NO_MODIFICATION_ALLOWED_ERR</a></code> exception if - the parent of the element is the <code>Document</code> - node.</p> - - </dd> - - </dl><h4 id="insertadjacenthtml"><span class="secno">3.4.7 </span><code title="dom-insertAdjacentHTML"><a href="#dom-insertadjacenthtml">insertAdjacentHTML()</a></code></h4><dl class="domintro"><dt><var title="">element</var> . <code title="dom-insertAdjacentHTML"><a href="#dom-insertadjacenthtml">insertAdjacentHTML</a></code>(<var title="">position</var>, <var title="">text</var>)</dt> - - <dd> - - <p>Parses the given string <var title="">text</var> as HTML or XML - and inserts the resulting nodes into the tree in the position - given by the <var title="">position</var> argument, as - follows:</p> - - <dl><dt>"beforebegin"</dt> - <dd>Before the element itself.</dd> - <dt>"afterbegin"</dt> - <dd>Just inside the element, before its first child.</dd> - <dt>"beforeend"</dt> - <dd>Just inside the element, after its last child.</dd> - <dt>"afterend"</dt> - <dd>After the element itself.</dd> - </dl><p>Throws a <code><a href="urls.html#syntax_err">SYNTAX_ERR</a></code> exception the arguments have - invalid values (e.g., in the case of <a href="dom.html#xml-documents">XML documents</a>, - if the given string is not well-formed).</p> - - <p>Throws a <code><a href="urls.html#no_modification_allowed_err">NO_MODIFICATION_ALLOWED_ERR</a></code> exception if - the given position isn't possible (e.g. inserting elements after - the root element of a <code>Document</code>).</p> - - </dd> - - </dl></body></html> \ No newline at end of file Index: obsolete.html =================================================================== RCS file: /sources/public/html5/spec-author-view/obsolete.html,v retrieving revision 1.553 retrieving revision 1.554 diff -u -d -r1.553 -r1.554 --- obsolete.html 1 Jan 2010 06:10:29 -0000 1.553 +++ obsolete.html 3 Jan 2010 15:10:31 -0000 1.554 @@ -1,503 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"> -<!DOCTYPE html> -<!-- when publishing, change bits marked ZZZ --><html lang="en-US-x-Hixie" class="split chapter"><head><title>11 Obsolete features — HTML5 (Author Edition)</title><script src="link-fixup.js"></script><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 { 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: #EEFFEE; } - 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; } - - 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; } - - .tall-and-narrow { - font-size: 0.6em; - column-width: 25em; - column-gap: 1em; - -moz-column-width: 25em; - -moz-column-gap: 1em; - -webkit-column-width: 25em; - -webkit-column-gap: 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; } - - #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: 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; } - - #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; } - - </style><link href="data:text/css," rel="stylesheet" title="Complete specification"><link href="data:text/css,.impl%20%7B%20display:%20none;%20%7D" rel="alternate stylesheet" title="Author documentation only"><link href="data:text/css,.impl%20%7B%20background:%20%23FFEEEE;%20%7D" rel="alternate stylesheet" title="Highlight implementation requirements"><link href="data:text/css," id="complete" rel="stylesheet" title="Complete specification"><link href="data:text/css,.impl%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" id="highlight" rel="alternate stylesheet" title="Highlight implementation requirements"><script> - 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', 'http://www.whatwg.org/specs/web-apps/current-work/' + 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); - // load('reviewer.js'); // would need cross-site XHR - if (document.getElementById('head')) - load('toc.js'); - - // load('updater.js'); // would need cross-site XHR - load('dfn.js'); - // load('status.js'); // would need cross-site XHR - 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="the-xhtml-syntax.html" title="10 The XHTML syntax" rel="prev"> - <link href="Overview.html#contents" title="Table of contents" rel="index"> - <link href="iana.html" title="12 IANA considerations" 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 (Author Edition)</h1> - </div><div> - <a href="the-xhtml-syntax.html">← 10 The XHTML syntax</a> – - <a href="Overview.html#contents">Table of contents</a> – - <a href="iana.html">12 IANA considerations →</a> - <ol class="toc"><li><a href="obsolete.html#obsolete"><span class="secno">11 </span>Obsolete features</a> - <ol><li><a href="obsolete.html#obsolete-but-conforming-features"><span class="secno">11.1 </span>Obsolete but conforming features</a></li><li><a href="obsolete.html#non-conforming-features"><span class="secno">11.2 </span>Non-conforming features</a></li></ol></li></ol></div> - - <h2 id="obsolete"><span class="secno">11 </span>Obsolete features</h2><h3 id="obsolete-but-conforming-features"><span class="secno">11.1 </span>Obsolete but conforming features</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>Features listed in this section will trigger warnings in - conformance checkers.</p><p>In <a href="syntax.html#syntax">the HTML syntax</a>, authors should not specify <a href="syntax.html#syntax-doctype" title="syntax-DOCTYPE">DOCTYPE</a>s that get parsed as <a href="#obsolete-permitted-doctype" title="obsolete permitted DOCTYPE">obsolete permitted - DOCTYPEs</a>.</p><!-- this is poor form; we really should define - this in the syntax section somehow --><p>Authors should not specify an <code title="attr-meta-http-equiv"><a href="semantics.html#attr-meta-http-equiv">http-equiv</a></code> attribute in the - <a href="semantics.html#attr-meta-http-equiv-content-language" title="attr-meta-http-equiv-content-language">Content - Language</a> state on a <code><a href="semantics.html#meta">meta</a></code> element. The <code title="attr-lang"><a href="elements.html#attr-lang">lang</a></code> attribute should be used instead.</p><p>Authors should not specify a <code title="attr-img-border"><a href="#attr-img-border">border</a></code> attribute on an - <code><a href="embedded-content-1.html#the-img-element">img</a></code> element. If the attribute is present, its value - must be the string "<code title="">0</code>". CSS should be used - instead.</p><p>Authors should not specify a <code title="attr-script-language"><a href="#attr-script-language">language</a></code> attribute on a - <code><a href="scripting-1.html#script">script</a></code> element. If the attribute is present, its value - must be an <a href="infrastructure.html#ascii-case-insensitive">ASCII case-insensitive</a> match for the string - "<code title="">JavaScript</code>" and either the <code title="attr-script-type"><a href="scripting-1.html#attr-script-type">type</a></code> attribute must be omitted or - its value must be an <a href="infrastructure.html#ascii-case-insensitive">ASCII case-insensitive</a> match for - the string "<code title="">text/javascript</code>". The attribute - should be entirely omitted instead (with the value "<code title="">JavaScript</code>", it has no effect), or replaced with use - of the <code title="attr-script-type"><a href="scripting-1.html#attr-script-type">type</a></code> attribute.</p><p>Authors should not specify the <code title="attr-a-name"><a href="#attr-a-name">name</a></code> attribute on <code><a href="text-level-semantics.html#the-a-element">a</a></code> - elements. If the attribute is present, its value must not be the - empty string and must neither be equal to the value of any of the - <a href="elements.html#concept-id" title="concept-id">IDs</a> in the element's <a href="infrastructure.html#home-subtree">home - subtree</a> other than the element's own <a href="elements.html#concept-id" title="concept-id">ID</a>, if any, nor be equal to the value of - any of the other <code title="attr-a-name"><a href="#attr-a-name">name</a></code> attributes on - <code><a href="text-level-semantics.html#the-a-element">a</a></code> elements in the element's <a href="infrastructure.html#home-subtree">home - subtree</a>. If this attribute is present and the element has an - <a href="elements.html#concept-id" title="concept-id">ID</a>, then the attribute's value must - be equal to the element's <a href="elements.html#concept-id" title="concept-id">ID</a>. In - earlier versions of the language, this attribute was intended as a - way to specify possible targets for fragment identifiers in <a href="urls.html#url" title="URL">URLs</a>. The <code title="attr-id"><a href="elements.html#the-id-attribute">id</a></code> - attribute should be used instead.</p><p class="note">The <code title="attr-table-summary"><a href="tabular-data.html#attr-table-summary">summary</a></code> - attribute, defined in the <code><a href="tabular-data.html#the-table-element">table</a></code> section, will also - trigger a warning.</p><h3 id="non-conforming-features"><span class="secno">11.2 </span>Non-conforming features</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>Elements in the following list are entirely obsolete, and must - not be used by authors:</p><dl><!-- alphabetical by first element in the group, except CSS goes last --><dt><code><a href="#the-applet-element">applet</a></code></dt> - <dd><p>Use <code><a href="the-iframe-element.html#the-embed-element">embed</a></code> or <code><a href="the-iframe-element.html#the-object-element">object</a></code> instead.</p></dd> - - <dt><dfn id="acronym"><code>acronym</code></dfn></dt> - <dd><p>Use <code><a href="text-level-semantics.html#the-abbr-element">abbr</a></code> instead.</p></dd> - - <dt><dfn id="dir"><code>dir</code></dfn></dt> - <dd><p>Use <code><a href="grouping-content.html#the-ul-element">ul</a></code> instead.</p></dd> - - <dt><code><a href="#frame">frame</a></code></dt> - <dt><code><a href="#frameset">frameset</a></code></dt> - <dt><dfn id="noframes"><code>noframes</code></dfn></dt> - <dd><p>Either use <code><a href="the-iframe-element.html#the-iframe-element">iframe</a></code> and CSS instead, or use server-side includes to generate complete pages with the various invariant parts merged in.</p></dd> - - <dt><dfn id="isindex-0"><code>isindex</code></dfn></dt> - <dd><p>Use an explicit <code><a href="forms.html#the-form-element">form</a></code> and <a href="states-of-the-type-attribute.html#text-state-and-search-state" title="attr-input-type-text">text field</a> combination instead.</p></dd> - - <dt><dfn id="listing"><code>listing</code></dfn></dt> - <dt><dfn id="xmp"><code>xmp</code></dfn></dt> - <dd><p>Use <code><a href="grouping-content.html#the-pre-element">pre</a></code> and <code><a href="text-level-semantics.html#the-code-element">code</a></code> instead.</p></dd> - - <dt><dfn id="nextid"><code>nextid</code></dfn></dt> - <dd><p>Use GUIDs instead.</p></dd> - - <dt><dfn id="noembed"><code>noembed</code></dfn></dt> - <dd><p>Use <code><a href="the-iframe-element.html#the-object-element">object</a></code> instead of <code><a href="the-iframe-element.html#the-embed-element">embed</a></code> when fallback is necessary.</p></dd> - - <dt><dfn id="plaintext"><code>plaintext</code></dfn></dt> - <dd><p>Use the "<code>text/plain</code>" <a href="infrastructure.html#mime-type">MIME type</a> instead.</p></dd> - - <dt><dfn id="rb"><code>rb</code></dfn></dt> - <dd><p>Providing the ruby base directly inside the <code><a href="text-level-semantics.html#the-ruby-element">ruby</a></code> element is sufficient; the <code><a href="#rb">rb</a></code> element is unnecessary. Omit it altogether.</p></dd> - - <dt><dfn id="basefont"><code>basefont</code></dfn></dt> - <dt><dfn id="big"><code>big</code></dfn></dt> - <dt><dfn id="blink"><code>blink</code></dfn></dt> - <dt><dfn id="center"><code>center</code></dfn></dt> - <dt><dfn id="font"><code>font</code></dfn></dt> - <dt><code><a href="#the-marquee-element">marquee</a></code></dt> - <dt><dfn id="s"><code>s</code></dfn></dt> - <dt><dfn id="spacer"><code>spacer</code></dfn></dt> - <dt><dfn id="strike"><code>strike</code></dfn></dt> - <dt><dfn id="tt"><code>tt</code></dfn></dt> - <dt><dfn id="u"><code>u</code></dfn></dt> - <dd><p>Use CSS instead.</p></dd> - - </dl><hr><p>The following attributes are obsolete (though the elements are - still part of the language), and must not be used by authors:</p><dl><!-- alphabetical by element then attribute of first item in group, except CSS goes last --><dt><dfn id="attr-a-charset" title="attr-a-charset"><code>charset</code></dfn> on <code><a href="text-level-semantics.html#the-a-element">a</a></code> elements</dt> - <dt><dfn id="attr-link-charset" title="attr-link-charset"><code>charset</code></dfn> on <code><a href="semantics.html#the-link-element">link</a></code> elements</dt> - <dd><p>Use an HTTP Content-Type header on the linked resource instead.</p></dd> - - <dt><dfn id="attr-a-coords" title="attr-a-coords"><code>coords</code></dfn> on <code><a href="text-level-semantics.html#the-a-element">a</a></code> elements</dt> - <dt><dfn id="attr-a-shape" title="attr-a-shape"><code>shape</code></dfn> on <code><a href="text-level-semantics.html#the-a-element">a</a></code> elements</dt> - <dd><p>Use <code><a href="the-map-element.html#the-area-element">area</a></code> instead of <code><a href="text-level-semantics.html#the-a-element">a</a></code> for image maps.</p></dd> - - <dt><dfn id="attr-a-methods" title="attr-a-methods"><code>methods</code></dfn> on <code><a href="text-level-semantics.html#the-a-element">a</a></code> elements</dt> - <dd><p>Use the HTTP OPTIONS feature instead.</p></dd> - - <dt><dfn id="attr-a-name" title="attr-a-name"><code>name</code></dfn> on <code><a href="text-level-semantics.html#the-a-element">a</a></code> elements (except as noted in the previous section)</dt> - <dt><dfn id="attr-embed-name" title="attr-embed-name"><code>name</code></dfn> on <code><a href="the-iframe-element.html#the-embed-element">embed</a></code> elements</dt> - <dt><dfn id="attr-img-name" title="attr-img-name"><code>name</code></dfn> on <code><a href="embedded-content-1.html#the-img-element">img</a></code> elements</dt> - <dd><p>Use the <code title="attr-id"><a href="elements.html#the-id-attribute">id</a></code> attribute instead.</p></dd> - - <dt><dfn id="attr-a-rev" title="attr-a-rev"><code>rev</code></dfn> on <code><a href="text-level-semantics.html#the-a-element">a</a></code> elements</dt> - <dt><dfn id="attr-link-rev" title="attr-link-rev"><code>rev</code></dfn> on <code><a href="semantics.html#the-link-element">link</a></code> elements</dt> - <dd><p>Use the <code title="attr-hyperlink-rel"><a href="links.html#attr-hyperlink-rel">rel</a></code> - attribute instead, with an opposite term. (For example, instead of - <code title="">rev="made"</code>, use <code title="">rel="author"</code>.)</p></dd> - - <dt><dfn id="attr-a-urn" title="attr-a-urn"><code>urn</code></dfn> on <code><a href="text-level-semantics.html#the-a-element">a</a></code> elements</dt> - <dd><p>Specify the preferred persistent identifier using the <code title="attr-href">href</code> attribute instead.</p></dd> - - <dt><dfn id="attr-area-nohref" title="attr-area-nohref"><code>nohref</code></dfn> on <code><a href="the-map-element.html#the-area-element">area</a></code> elements</dt> - <dd><p>Omitting the <code title="attr-hyperlink-href"><a href="links.html#attr-hyperlink-href">href</a></code> - attribute is sufficient; the <code title="attr-area-nohref"><a href="#attr-area-nohref">nohref</a></code> attribute is - unnecessary. Omit it altogether.</p></dd> - - <dt><dfn id="attr-head-profile" title="attr-head-profile"><code>profile</code></dfn> on <code><a href="semantics.html#the-head-element-0">head</a></code> elements</dt> - <dd><p>When used for declaring which <code><a href="semantics.html#meta">meta</a></code> terms are - used in the document, unnecessary; omit it altogether, and <a href="semantics.html#concept-meta-extensions" title="concept-meta-extensions">register the names</a>.</p></dd> - <dd><p>When used for triggering specific user agent behaviors: use - a <code><a href="semantics.html#the-link-element">link</a></code> element instead.</p></dd> - - <dt><dfn id="attr-html-version" title="attr-html-version"><code>version</code></dfn> on <code><a href="semantics.html#the-html-element-0">html</a></code> elements</dt> - <dd><p>Unnecessary. Omit it altogether.</p></dd> - - <dt><dfn id="attr-input-usemap" title="attr-input-usemap"><code>usemap</code></dfn> on <code><a href="the-input-element.html#the-input-element">input</a></code> elements</dt> - <dd><p>Use <code><a href="embedded-content-1.html#the-img-element">img</a></code> instead of <code><a href="the-input-element.html#the-input-element">input</a></code> for image maps.</p></dd> - - <dt><dfn id="attr-iframe-longdesc" title="attr-iframe-longdesc"><code>longdesc</code></dfn> on <code><a href="the-iframe-element.html#the-iframe-element">iframe</a></code> elements</dt> - <dt><dfn id="attr-img-longdesc" title="attr-img-longdesc"><code>longdesc</code></dfn> on <code><a href="embedded-content-1.html#the-img-element">img</a></code> elements</dt> - <dd><p>Use a regular <code><a href="text-level-semantics.html#the-a-element">a</a></code> element to link to the description.</p></dd> - - <dt><dfn id="attr-link-target" title="attr-link-target"><code>target</code></dfn> on <code><a href="semantics.html#the-link-element">link</a></code> elements</dt> - <dd><p>Unnecessary. Omit it altogether.</p></dd> - - <dt><dfn id="attr-meta-scheme" title="attr-meta-scheme"><code>scheme</code></dfn> on <code><a href="semantics.html#meta">meta</a></code> elements</dt> - <dd><p>Use only one scheme per field, or make the scheme declaration part of the value.</p></dd> - - <dt><dfn id="attr-object-archive" title="attr-object-archive"><code>archive</code></dfn> on <code><a href="the-iframe-element.html#the-object-element">object</a></code> elements</dt> - <dt><dfn id="attr-object-classid" title="attr-object-classid"><code>classid</code></dfn> on <code><a href="the-iframe-element.html#the-object-element">object</a></code> elements</dt> - <dt><dfn id="attr-object-code" title="attr-object-code"><code>code</code></dfn> on <code><a href="the-iframe-element.html#the-object-element">object</a></code> elements</dt> - <dt><dfn id="attr-object-codebase" title="attr-object-codebase"><code>codebase</code></dfn> on <code><a href="the-iframe-element.html#the-object-element">object</a></code> elements</dt> - <dt><dfn id="attr-object-codetype" title="attr-object-codetype"><code>codetype</code></dfn> on <code><a href="the-iframe-element.html#the-object-element">object</a></code> elements</dt> - <dd><p>Use the <code title="attr-object-data"><a href="the-iframe-element.html#attr-object-data">data</a></code> and <code title="attr-object-type"><a href="the-iframe-element.html#attr-object-type">type</a></code> attributes to invoke <a href="infrastructure.html#plugin" title="plugin">plugins</a>. To set parameters with these names - in particular, the <code><a href="the-iframe-element.html#the-param-element">param</a></code> element can be used.</p></dd> - - <dt><dfn id="attr-object-declare" title="attr-object-declare"><code>declare</code></dfn> on <code><a href="the-iframe-element.html#the-object-element">object</a></code> elements</dt> - <dd><p>Repeat the <code><a href="the-iframe-element.html#the-object-element">object</a></code> element completely each time the resource is to be reused.</p></dd> - - <dt><dfn id="attr-object-standby" title="attr-object-standby"><code>standby</code></dfn> on <code><a href="the-iframe-element.html#the-object-element">object</a></code> elements</dt> - <dd><p>Optimise the linked resource so that it loads quickly or, at least, incrementally.</p></dd> - - <dt><dfn id="attr-param-type" title="attr-param-type"><code>type</code></dfn> on <code><a href="the-iframe-element.html#the-param-element">param</a></code> elements</dt> - <dt><dfn id="attr-param-valuetype" title="attr-param-valuetype"><code>valuetype</code></dfn> on <code><a href="the-iframe-element.html#the-param-element">param</a></code> elements</dt> - <dd><p>Use the <code title="attr-param-name"><a href="the-iframe-element.html#attr-param-name">name</a></code> and <code title="attr-param-value"><a href="the-iframe-element.html#attr-param-value">value</a></code> attributes without declaring - value types.</p></dd> - - <dt><dfn id="attr-script-language" title="attr-script-language"><code>language</code></dfn> on <code><a href="scripting-1.html#script">script</a></code> elements (except as noted in the previous section)</dt> - <dd><p>Use the <code title="attr-script-type"><a href="scripting-1.html#attr-script-type">type</a></code> attribute - instead.</p></dd> - - <dt><dfn id="attr-tdth-abbr" title="attr-tdth-abbr"><code>abbr</code></dfn> on <code><a href="tabular-data.html#the-td-element">td</a></code> and <code><a href="tabular-data.html#the-th-element">th</a></code> elements</dt> - <dd><p>Use text that begins in an unambiguous and terse manner, and include any more elaborate text after that.</p> - - </dd><dt><dfn id="attr-tdth-axis" title="attr-tdth-axis"><code>axis</code></dfn> on <code><a href="tabular-data.html#the-td-element">td</a></code> and <code><a href="tabular-data.html#the-th-element">th</a></code> elements</dt> - <dd><p>Use the <code title="attr-th-scope"><a href="tabular-data.html#attr-th-scope">scope</a></code> attribute.</p> - - </dd><dt><dfn id="attr-body-alink" title="attr-body-alink"><code>alink</code></dfn> on <code><a href="sections.html#the-body-element-0">body</a></code> elements</dt> - <dt><dfn id="attr-body-background" title="attr-body-background"><code>background</code></dfn> on <code><a href="sections.html#the-body-element-0">body</a></code> elements</dt> - <dt><dfn id="attr-body-bgcolor" title="attr-body-bgcolor"><code>bgcolor</code></dfn> on <code><a href="sections.html#the-body-element-0">body</a></code> elements</dt> - <dt><dfn id="attr-body-link" title="attr-body-link"><code>link</code></dfn> on <code><a href="sections.html#the-body-element-0">body</a></code> elements</dt> - <dt><dfn id="attr-body-text" title="attr-body-text"><code>text</code></dfn> on <code><a href="sections.html#the-body-element-0">body</a></code> elements</dt> - <dt><dfn id="attr-body-vlink" title="attr-body-vlink"><code>vlink</code></dfn> on <code><a href="sections.html#the-body-element-0">body</a></code> elements</dt> - <dt><dfn id="attr-br-clear" title="attr-br-clear"><code>clear</code></dfn> on <code><a href="grouping-content.html#the-br-element">br</a></code> elements</dt> - <dt><dfn id="attr-caption-align" title="attr-caption-align"><code>align</code></dfn> on <code><a href="tabular-data.html#the-caption-element">caption</a></code> elements</dt> - <dt><dfn id="attr-col-align" title="attr-col-align"><code>align</code></dfn> on <code><a href="tabular-data.html#the-col-element">col</a></code> elements</dt> - <dt><dfn id="attr-col-char" title="attr-col-char"><code>char</code></dfn> on <code><a href="tabular-data.html#the-col-element">col</a></code> elements</dt> - <dt><dfn id="attr-col-charoff" title="attr-col-charoff"><code>charoff</code></dfn> on <code><a href="tabular-data.html#the-col-element">col</a></code> elements</dt> - <dt><dfn id="attr-col-valign" title="attr-col-valign"><code>valign</code></dfn> on <code><a href="tabular-data.html#the-col-element">col</a></code> elements</dt> - <dt><dfn id="attr-col-width" title="attr-col-width"><code>width</code></dfn> on <code><a href="tabular-data.html#the-col-element">col</a></code> elements</dt> - <dt><dfn id="attr-div-align" title="attr-div-align"><code>align</code></dfn> on <code><a href="grouping-content.html#the-div-element">div</a></code> elements</dt> - <dt><dfn id="attr-dl-compact" title="attr-dl-compact"><code>compact</code></dfn> on <code><a href="grouping-content.html#the-dl-element">dl</a></code> elements</dt> - <dt><dfn id="attr-embed-align" title="attr-embed-align"><code>align</code></dfn> on <code><a href="the-iframe-element.html#the-embed-element">embed</a></code> elements</dt> - <dt><dfn id="attr-hr-align" title="attr-hr-align"><code>align</code></dfn> on <code><a href="grouping-content.html#the-hr-element">hr</a></code> elements</dt> - <dt><dfn id="attr-hr-color" title="attr-hr-color"><code>color</code></dfn> on <code><a href="grouping-content.html#the-hr-element">hr</a></code> elements</dt> - <dt><dfn id="attr-hr-noshade" title="attr-hr-noshade"><code>noshade</code></dfn> on <code><a href="grouping-content.html#the-hr-element">hr</a></code> elements</dt> - <dt><dfn id="attr-hr-size" title="attr-hr-size"><code>size</code></dfn> on <code><a href="grouping-content.html#the-hr-element">hr</a></code> elements</dt> - <dt><dfn id="attr-hr-width" title="attr-hr-width"><code>width</code></dfn> on <code><a href="grouping-content.html#the-hr-element">hr</a></code> elements</dt> - <dt><dfn id="attr-hx-align" title="attr-hx-align"><code>align</code></dfn> on <code><a href="sections.html#the-h1-h2-h3-h4-h5-and-h6-elements">h1</a></code>—<code><a href="sections.html#the-h1-h2-h3-h4-h5-and-h6-elements">h6</a></code> elements</dt> - <dt><dfn id="attr-iframe-align" title="attr-iframe-align"><code>align</code></dfn> on <code><a href="the-iframe-element.html#the-iframe-element">iframe</a></code> elements</dt> - <dt><dfn id="attr-iframe-frameborder" title="attr-iframe-frameborder"><code>frameborder</code></dfn> on <code><a href="the-iframe-element.html#the-iframe-element">iframe</a></code> elements</dt> - <dt><dfn id="attr-iframe-marginheight" title="attr-iframe-marginheight"><code>marginheight</code></dfn> on <code><a href="the-iframe-element.html#the-iframe-element">iframe</a></code> elements</dt> - <dt><dfn id="attr-iframe-marginwidth" title="attr-iframe-marginwidth"><code>marginwidth</code></dfn> on <code><a href="the-iframe-element.html#the-iframe-element">iframe</a></code> elements</dt> - <dt><dfn id="attr-iframe-scrolling" title="attr-iframe-scrolling"><code>scrolling</code></dfn> on <code><a href="the-iframe-element.html#the-iframe-element">iframe</a></code> elements</dt> - <dt><dfn id="attr-input-align" title="attr-input-align"><code>align</code></dfn> on <code><a href="the-input-element.html#the-input-element">input</a></code> elements</dt> - <dt><dfn id="attr-img-align" title="attr-img-align"><code>align</code></dfn> on <code><a href="embedded-content-1.html#the-img-element">img</a></code> elements</dt> - <dt><dfn id="attr-img-border" title="attr-img-border"><code>border</code></dfn> on <code><a href="embedded-content-1.html#the-img-element">img</a></code> elements (except as noted in the previous section)</dt> - <dt><dfn id="attr-img-hspace" title="attr-img-hspace"><code>hspace</code></dfn> on <code><a href="embedded-content-1.html#the-img-element">img</a></code> elements</dt> - <dt><dfn id="attr-img-vspace" title="attr-img-vspace"><code>vspace</code></dfn> on <code><a href="embedded-content-1.html#the-img-element">img</a></code> elements</dt> - <dt><dfn id="attr-legend-align" title="attr-legend-align"><code>align</code></dfn> on <code><a href="forms.html#the-legend-element">legend</a></code> elements</dt> - <dt><dfn id="attr-li-type" title="attr-li-type"><code>type</code></dfn> on <code><a href="grouping-content.html#the-li-element">li</a></code> elements</dt> - <dt><dfn id="attr-menu-compact" title="attr-menu-compact"><code>compact</code></dfn> on <code><a href="interactive-elements.html#menus">menu</a></code> elements</dt> - <dt><dfn id="attr-object-align" title="attr-object-align"><code>align</code></dfn> on <code><a href="the-iframe-element.html#the-object-element">object</a></code> elements</dt> - <dt><dfn id="attr-object-border" title="attr-object-border"><code>border</code></dfn> on <code><a href="the-iframe-element.html#the-object-element">object</a></code> elements</dt> - <dt><dfn id="attr-object-hspace" title="attr-object-hspace"><code>hspace</code></dfn> on <code><a href="the-iframe-element.html#the-object-element">object</a></code> elements</dt> - <dt><dfn id="attr-object-vspace" title="attr-object-vspace"><code>vspace</code></dfn> on <code><a href="the-iframe-element.html#the-object-element">object</a></code> elements</dt> - <dt><dfn id="attr-ol-compact" title="attr-ol-compact"><code>compact</code></dfn> on <code><a href="grouping-content.html#the-ol-element">ol</a></code> elements</dt> - <dt><dfn id="attr-ol-type" title="attr-ol-type"><code>type</code></dfn> on <code><a href="grouping-content.html#the-ol-element">ol</a></code> elements</dt> - <dt><dfn id="attr-p-align" title="attr-p-align"><code>align</code></dfn> on <code><a href="grouping-content.html#the-p-element">p</a></code> elements</dt> - <dt><dfn id="attr-pre-width" title="attr-pre-width"><code>width</code></dfn> on <code><a href="grouping-content.html#the-pre-element">pre</a></code> elements</dt> - <dt><dfn id="attr-table-align" title="attr-table-align"><code>align</code></dfn> on <code><a href="tabular-data.html#the-table-element">table</a></code> elements</dt> - <dt><dfn id="attr-table-bgcolor" title="attr-table-bgcolor"><code>bgcolor</code></dfn> on <code><a href="tabular-data.html#the-table-element">table</a></code> elements</dt> - <dt><dfn id="attr-table-border" title="attr-table-border"><code>border</code></dfn> on <code><a href="tabular-data.html#the-table-element">table</a></code> elements</dt> - <dt><dfn id="attr-table-cellpadding" title="attr-table-cellpadding"><code>cellpadding</code></dfn> on <code><a href="tabular-data.html#the-table-element">table</a></code> elements</dt> - <dt><dfn id="attr-table-cellspacing" title="attr-table-cellspacing"><code>cellspacing</code></dfn> on <code><a href="tabular-data.html#the-table-element">table</a></code> elements</dt> - <dt><dfn id="attr-table-frame" title="attr-table-frame"><code>frame</code></dfn> on <code><a href="tabular-data.html#the-table-element">table</a></code> elements</dt> - <dt><dfn id="attr-table-rules" title="attr-table-rules"><code>rules</code></dfn> on <code><a href="tabular-data.html#the-table-element">table</a></code> elements</dt> - <dt><dfn id="attr-table-width" title="attr-table-width"><code>width</code></dfn> on <code><a href="tabular-data.html#the-table-element">table</a></code> elements</dt> - <dt><dfn id="attr-tbody-align" title="attr-tbody-align"><code>align</code></dfn> on <code><a href="tabular-data.html#the-tbody-element">tbody</a></code>, <code><a href="tabular-data.html#the-thead-element">thead</a></code>, and <code><a href="tabular-data.html#the-tfoot-element">tfoot</a></code> elements</dt> - <dt><dfn id="attr-tbody-char" title="attr-tbody-char"><code>char</code></dfn> on <code><a href="tabular-data.html#the-tbody-element">tbody</a></code>, <code><a href="tabular-data.html#the-thead-element">thead</a></code>, and <code><a href="tabular-data.html#the-tfoot-element">tfoot</a></code> elements</dt> - <dt><dfn id="attr-tbody-charoff" title="attr-tbody-charoff"><code>charoff</code></dfn> on <code><a href="tabular-data.html#the-tbody-element">tbody</a></code>, <code><a href="tabular-data.html#the-thead-element">thead</a></code>, and <code><a href="tabular-data.html#the-tfoot-element">tfoot</a></code> elements</dt> - <dt><dfn id="attr-tbody-valign" title="attr-tbody-vAlign"><code>valign</code></dfn> on <code><a href="tabular-data.html#the-tbody-element">tbody</a></code>, <code><a href="tabular-data.html#the-thead-element">thead</a></code>, and <code><a href="tabular-data.html#the-tfoot-element">tfoot</a></code> elements</dt> - <dt><dfn id="attr-tdth-align" title="attr-tdth-align"><code>align</code></dfn> on <code><a href="tabular-data.html#the-td-element">td</a></code> and <code><a href="tabular-data.html#the-th-element">th</a></code> elements</dt> - <dt><dfn id="attr-tdth-bgcolor" title="attr-tdth-bgcolor"><code>bgcolor</code></dfn> on <code><a href="tabular-data.html#the-td-element">td</a></code> and <code><a href="tabular-data.html#the-th-element">th</a></code> elements</dt> - <dt><dfn id="attr-tdth-char" title="attr-tdth-char"><code>char</code></dfn> on <code><a href="tabular-data.html#the-td-element">td</a></code> and <code><a href="tabular-data.html#the-th-element">th</a></code> elements</dt> - <dt><dfn id="attr-tdth-charoff" title="attr-tdth-charoff"><code>charoff</code></dfn> on <code><a href="tabular-data.html#the-td-element">td</a></code> and <code><a href="tabular-data.html#the-th-element">th</a></code> elements</dt> - <dt><dfn id="attr-tdth-height" title="attr-tdth-height"><code>height</code></dfn> on <code><a href="tabular-data.html#the-td-element">td</a></code> and <code><a href="tabular-data.html#the-th-element">th</a></code> elements</dt> - <dt><dfn id="attr-tdth-nowrap" title="attr-tdth-nowrap"><code>nowrap</code></dfn> on <code><a href="tabular-data.html#the-td-element">td</a></code> and <code><a href="tabular-data.html#the-th-element">th</a></code> elements</dt> - <dt><dfn id="attr-tdth-valign" title="attr-tdth-valign"><code>valign</code></dfn> on <code><a href="tabular-data.html#the-td-element">td</a></code> and <code><a href="tabular-data.html#the-th-element">th</a></code> elements</dt> - <dt><dfn id="attr-tdth-width" title="attr-tdth-width"><code>width</code></dfn> on <code><a href="tabular-data.html#the-td-element">td</a></code> and <code><a href="tabular-data.html#the-th-element">th</a></code> elements</dt> - <dt><dfn id="attr-tr-align" title="attr-tr-align"><code>align</code></dfn> on <code><a href="tabular-data.html#the-tr-element">tr</a></code> elements</dt> - <dt><dfn id="attr-tr-bgcolor" title="attr-tr-bgcolor"><code>bgcolor</code></dfn> on <code><a href="tabular-data.html#the-tr-element">tr</a></code> elements</dt> - <dt><dfn id="attr-tr-char" title="attr-tr-char"><code>char</code></dfn> on <code><a href="tabular-data.html#the-tr-element">tr</a></code> elements</dt> - <dt><dfn id="attr-tr-charoff" title="attr-tr-charoff"><code>charoff</code></dfn> on <code><a href="tabular-data.html#the-tr-element">tr</a></code> elements</dt> - <dt><dfn id="attr-tr-valign" title="attr-tr-valign"><code>valign</code></dfn> on <code><a href="tabular-data.html#the-tr-element">tr</a></code> elements</dt> - <dt><dfn id="attr-ul-compact" title="attr-ul-compact"><code>compact</code></dfn> on <code><a href="grouping-content.html#the-ul-element">ul</a></code> elements</dt> - <dt><dfn id="attr-ul-type" title="attr-ul-type"><code>type</code></dfn> on <code><a href="grouping-content.html#the-ul-element">ul</a></code> elements</dt> - <dd><p>Use CSS instead.</p></dd> - - </dl></body></html> \ No newline at end of file Index: named-character-references.html =================================================================== RCS file: /sources/public/html5/spec-author-view/named-character-references.html,v retrieving revision 1.554 retrieving revision 1.555 diff -u -d -r1.554 -r1.555 --- named-character-references.html 3 Jan 2010 15:08:15 -0000 1.554 +++ named-character-references.html 3 Jan 2010 15:10:31 -0000 1.555 @@ -1,216 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"> -<!DOCTYPE html> -<!-- when publishing, change bits marked ZZZ --><html lang="en-US-x-Hixie" class="split chapter"><head><title>9.2 Named character references — HTML5 (Author Edition)</title><script src="link-fixup.js"></script><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 { 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: #EEFFEE; } - 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; } - - 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; } - - .tall-and-narrow { - font-size: 0.6em; - column-width: 25em; - column-gap: 1em; - -moz-column-width: 25em; - -moz-column-gap: 1em; - -webkit-column-width: 25em; - -webkit-column-gap: 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; } - - #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: 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; } - - #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; } - .appl \ No newline at end of file Index: semantics.html =================================================================== RCS file: /sources/public/html5/spec-author-view/semantics.html,v retrieving revision 1.556 retrieving revision 1.557 diff -u -d -r1.556 -r1.557 --- semantics.html 1 Jan 2010 06:10:29 -0000 1.556 +++ semantics.html 3 Jan 2010 15:10:31 -0000 1.557 @@ -1,1187 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"> -<!DOCTYPE html> -<!-- when publishing, change bits marked ZZZ --><html lang="en-US-x-Hixie" class="split chapter"><head><title>4 The elements of HTML — HTML5 (Author Edition)</title><script src="link-fixup.js"></script><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; } [...1157 lines suppressed...] - <title>My favorite book</title> - <style> - body { color: black; background: white; } - em { font-style: normal; color: red; } - </style> - </head> - <body> - <p>My <em>favorite</em> book of all time has <em>got</em> to be - <cite>A Cat's Life</cite>. It is a book by P. Rahmel that talks - about the <i lang="la">Felis Catus</i> in modern human society.</p> - </body> -</html></pre> - - </div><h4 id="styling"><span class="secno">4.2.7 </span><dfn title="styling processing model">Styling</dfn></h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>The <code><a href="#the-link-element">link</a></code> and <code><a href="#the-style-element">style</a></code> elements can provide - styling information for the user agent to use when rendering the - document. The DOM Styling specification specifies what styling - information is to be used by the user agent and how it is to be - used. <a href="references.html#refsCSSOM">[CSSOM]</a></p><p>The <code><a href="#the-style-element">style</a></code> and <code><a href="#the-link-element">link</a></code> elements implement - the <code>LinkStyle</code> interface. <a href="references.html#refsCSSOM">[CSSOM]</a></p></body></html> \ No newline at end of file Index: index.html =================================================================== RCS file: /sources/public/html5/spec-author-view/index.html,v retrieving revision 1.553 retrieving revision 1.554 diff -u -d -r1.553 -r1.554 --- index.html 3 Jan 2010 15:08:14 -0000 1.553 +++ index.html 3 Jan 2010 15:10:30 -0000 1.554 @@ -1,216 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"> -<!DOCTYPE html> -<!-- when publishing, change bits marked ZZZ --><html lang="en-US-x-Hixie" class="split chapter"><head><title>Index — HTML5 (Author Edition)</title><script src="link-fixup.js"></script><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 { 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: #EEFFEE; } - 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; } - - 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; } - - .tall-and-narrow { - font-size: 0.6em; - column-width: 25em; - column-gap: 1em; - -moz-column-width: 25em; - -moz-column-gap: 1em; - -webkit-column-width: 25em; - -webkit-column-gap: 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; } - - #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: 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; } - - #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 \ No newline at end of file Index: spec.html =================================================================== RCS file: /sources/public/html5/spec-author-view/spec.html,v retrieving revision 1.558 retrieving revision 1.559 diff -u -d -r1.558 -r1.559 --- spec.html 3 Jan 2010 15:08:15 -0000 1.558 +++ spec.html 3 Jan 2010 15:10:31 -0000 1.559 @@ -215,5081 +215,4 @@ .apple-table-examples.e2 th[scope=row] { padding-left: 1em; } .apple-table-examples sup { line-height: 0; } - </style><link href=data:text/css, rel=stylesheet title="Complete specification"><link href=data:text/css,.impl%20{%20display:%20none;%20} rel="alternate stylesheet" title="Author documentation only"><link href=data:text/css,.impl%20{%20background:%20%23FFEEEE;%20} rel="alternate stylesheet" title="Highlight implementation requirements"><link href=data:text/css, id=complete rel=stylesheet title="Complete specification"><link href=data:text/css,.impl%20{%20display:%20none;%20} id=author rel="alternate stylesheet" title="Author documentation only"><link href=data:text/css,.impl%20{%20background:%20%23FFEEEE;%20} id=highlight rel="alternate stylesheet" title="Highlight implementation requirements"><script> - 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) [...5053 lines suppressed...] -c = %x0043 ; U+0043 LATIN CAPITAL LETTER C -c =/ %x0063 ; U+0063 LATIN SMALL LETTER C -r = %x0052 ; U+0052 LATIN CAPITAL LETTER R -r =/ %x0072 ; U+0072 LATIN SMALL LETTER R -i = %x0049 ; U+0049 LATIN CAPITAL LETTER I -i =/ %x0069 ; U+0069 LATIN SMALL LETTER I -p = %x0050 ; U+0050 LATIN CAPITAL LETTER P -p =/ %x0070 ; U+0070 LATIN SMALL LETTER P -t = %x0054 ; U+0054 LATIN CAPITAL LETTER T -t =/ %x0074 ; U+0074 LATIN SMALL LETTER T - -tag-end = %x0009 ; U+0009 CHARACTER TABULATION -tag-end =/ %x000A ; U+000A LINE FEED (LF) -tag-end =/ %x000C ; U+000C FORM FEED (FF) -tag-end =/ %x0020 ; U+0020 SPACE -tag-end =/ %x002F ; U+002F SOLIDUS (/) -tag-end =/ %x003E ; U+003E GREATER-THAN SIGN (>)</pre><p>When a <code><a href=#script>script</a></code> element contains <a href=#inline-documentation-for-external-scripts>sc \ No newline at end of file + </style><link h \ No newline at end of file Index: introduction.html =================================================================== RCS file: /sources/public/html5/spec-author-view/introduction.html,v retrieving revision 1.553 retrieving revision 1.554 diff -u -d -r1.553 -r1.554 --- introduction.html 1 Jan 2010 06:10:28 -0000 1.553 +++ introduction.html 3 Jan 2010 15:10:30 -0000 1.554 @@ -1,637 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"> -<!DOCTYPE html> -<!-- when publishing, change bits marked ZZZ --><html lang="en-US-x-Hixie" class="split chapter"><head><title>1 Introduction — HTML5 (Author Edition)</title><script src="link-fixup.js"></script><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 { 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: #EEFFEE; } - 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; } - - 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; } - - .tall-and-narrow { - font-size: 0.6em; - column-width: 25em; - column-gap: 1em; - -moz-column-width: 25em; - -moz-column-gap: 1em; - -webkit-column-width: 25em; - -webkit-column-gap: 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; } - - #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: 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; } - - #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; } - - </style><link href="data:text/css," rel="stylesheet" title="Complete specification"><link href="data:text/css,.impl%20%7B%20display:%20none;%20%7D" rel="alternate stylesheet" title="Author documentation only"><link href="data:text/css,.impl%20%7B%20background:%20%23FFEEEE;%20%7D" rel="alternate stylesheet" title="Highlight implementation requirements"><link href="data:text/css," id="complete" rel="stylesheet" title="Complete specification"><link href="data:text/css,.impl%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" id="highlight" rel="alternate stylesheet" title="Highlight implementation requirements"><script> - 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', 'http://www.whatwg.org/specs/web-apps/current-work/' + 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); - // load('reviewer.js'); // would need cross-site XHR - if (document.getElementById('head')) - load('toc.js'); - - // load('updater.js'); // would need cross-site XHR - load('dfn.js'); - // load('status.js'); // would need cross-site XHR - 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="Overview.html#contents" title="Table of contents" rel="index"> - <link href="infrastructure.html" title="2 Common infrastructure" 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 (Author Edition)</h1> - </div><div> - <a href="Overview.html#contents">Table of contents</a> – - <a href="infrastructure.html">2 Common infrastructure →</a> - <ol class="toc"><li><a href="introduction.html#introduction"><span class="secno">1 </span>Introduction</a> - <ol><li><a href="introduction.html#background"><span class="secno">1.1 </span>Background</a></li><li><a href="introduction.html#audience"><span class="secno">1.2 </span>Audience</a></li><li><a href="introduction.html#scope"><span class="secno">1.3 </span>Scope</a></li><li><a href="introduction.html#history-1"><span class="secno">1.4 </span>History</a></li><li><a href="introduction.html#design-notes"><span class="secno">1.5 </span>Design notes</a> - <ol><li><a href="introduction.html#serializability-of-script-execution"><span class="secno">1.5.1 </span>Serializability of script execution</a></li><li><a href="introduction.html#compliance-with-other-specifications"><span class="secno">1.5.2 </span>Compliance with other specifications</a></li></ol></li><li><a href="introduction.html#html-vs-xhtml"><span class="secno">1.6 </span>HTML vs XHTML</a></li><li><a href="introduction.html#structure-of-this-specification"><span class="secno">1.7 </span>Structure of this specification</a> - <ol><li><a href="introduction.html#how-to-read-this-specification"><span class="secno">1.7.1 </span>How to read this specification</a></li><li><a href="introduction.html#typographic-conventions"><span class="secno">1.7.2 </span>Typographic conventions</a></li></ol></li><li><a href="introduction.html#a-quick-introduction-to-html"><span class="secno">1.8 </span>A quick introduction to HTML</a></li><li><a href="introduction.html#recommended-reading"><span class="secno">1.9 </span>Recommended reading</a></li></ol></li></ol></div> - - <h2 id="introduction"><span class="secno">1 </span>Introduction</h2><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><h3 id="background"><span class="secno">1.1 </span>Background</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p><i>This section is non-normative.</i></p><p>The World Wide Web's markup language has always been HTML. HTML - was primarily designed as a language for semantically describing - scientific documents, although its general design and adaptations - over the years have enabled it to be used to describe a number of - other types of documents.</p><p>The main area that has not been adequately addressed by HTML is a - vague subject referred to as Web Applications. This specification - attempts to rectify this, while at the same time updating the HTML - specifications to address issues raised in the past few years.</p><h3 id="audience"><span class="secno">1.2 </span>Audience</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p><i>This section is non-normative.</i></p><p>This specification is intended for authors of documents and - scripts that use the features defined in this specification, implementors of tools that operate on pages that use - the features defined in this specification, and individuals wishing - to establish the correctness of documents or implementations with - respect to the requirements of this specification</p><p>This document is probably not suited to readers who do not - already have at least a passing familiarity with Web technologies, - as in places it sacrifices clarity for precision, and brevity for - completeness. More approachable tutorials and authoring guides can - provide a gentler introduction to the topic.</p><p>In particular, familiarity with the basics of DOM Core and DOM - Events is necessary for a complete understanding of some of the more - technical parts of this specification. An understanding of Web IDL, - HTTP, XML, Unicode, character encodings, JavaScript, and CSS will - also be helpful in places but is not essential.</p><h3 id="scope"><span class="secno">1.3 </span>Scope</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p><i>This section is non-normative.</i></p><p>This specification is limited to providing a semantic-level - markup language and associated semantic-level scripting APIs for - authoring accessible pages on the Web ranging from static documents - to dynamic applications.</p><p>The scope of this specification does not include providing - mechanisms for media-specific customization of presentation - (although default rendering rules for Web browsers are included at - the end of this specification, and several mechanisms for hooking - into CSS are provided as part of the language).</p><p>The scope of this specification is not to describe an entire - operating system. In particular, hardware configuration software, - image manipulation tools, and applications that users would be - expected to use with high-end workstations on a daily basis are out - of scope. In terms of applications, this specification is targeted - specifically at applications that would be expected to be used by - users on an occasional basis, or regularly but from disparate - locations, with low CPU requirements. For instance online purchasing - systems, searching systems, games (especially multiplayer online - games), public telephone books or address books, communications - software (e-mail clients, instant messaging clients, discussion - software), document editing software, etc.</p><h3 id="history-1"><span class="secno">1.4 </span>History</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p><i>This section is non-normative.</i></p><p>For its first five years (1990-1995), HTML went through a number - of revisions and experienced a number of extensions, primarily - hosted first at CERN, and then at the IETF.</p><p>With the creation of the W3C, HTML's development changed venue - again. A first abortive attempt at extending HTML in 1995 known as - HTML 3.0 then made way to a more pragmatic approach known as HTML - 3.2, which was completed in 1997. HTML4 followed, reaching - completion in 1998.</p><p>At this time, the W3C membership decided to stop evolving HTML - and instead begin work on an XML-based equivalent, called - XHTML. This effort started with a reformulation of HTML4 in XML, - known as XHTML 1.0, which added no new features except the new - serialization, and which was completed in 2000. After XHTML 1.0, the - W3C's focus turned to making it easier for other working groups to - extend XHTML, under the banner of XHTML Modularization. In parallel - with this, the W3C also worked on a new language that was not - compatible with the earlier HTML and XHTML languages, calling it - XHTML2.</p><p>Around the time that HTML's evolution was stopped in 1998, parts - of the API for HTML developed by browser vendors were specified and - published under the name DOM Level 1 (in 1998) and DOM Level 2 Core - and DOM Level 2 HTML (starting in 2000 and culminating in - 2003). These efforts then petered out, with some DOM Level 3 - specifications published in 2004 but the working group being closed - before all the Level 3 drafts were completed.</p><p>In 2003, the publication of XForms, a technology which was - positioned as the next generation of Web forms, sparked a renewed - interest in evolving HTML itself, rather than finding replacements - for it. This interest was borne from the realization that XML's - deployment as a Web technology was limited to entirely new - technologies (like RSS and later Atom), rather than as a replacement - for existing deployed technologies (like HTML).</p><p>A proof of concept to show that it was possible to extend HTML4's - forms to provide many of the features that XForms 1.0 introduced, - without requiring browsers to implement rendering engines that were - incompatible with existing HTML Web pages, was the first result of - this renewed interest. At this early stage, while the draft was - already publicly available, and input was already being solicited - from all sources, the specification was only under Opera Software's - copyright.</p><p>The idea that HTML's evolution should be reopened was tested at a - W3C workshop in 2004, where some of the principles that underlie the - HTML5 work (described below), as well as the aforementioned early - draft proposal covering just forms-related features, were presented - to the W3C jointly by Mozilla and Opera. The proposal was rejected - on the grounds that the proposal conflicted with the previously - chosen direction for the Web's evolution; the W3C staff and - membership voted to continue developing XML-based replacements - instead.</p><p>Shortly thereafter, Apple, Mozilla, and Opera jointly announced - their intent to continue working on the effort under the umbrella of - a new venue called the WHATWG. A public mailing list was created, - and the draft was moved to the WHATWG site. The copyright was - subsequently amended to be jointly owned by all three vendors, and - to allow reuse of the specification.</p><p>The WHATWG was based on several core principles, in particular - that technologies need to be backwards compatible, that - specifications and implementations need to match even if this means - changing the specification rather than the implementations, and that - specifications need to be detailed enough that implementations can - achieve complete interoperability without reverse-engineering each - other.</p><p>The latter requirement in particular required that the scope of - the HTML5 specification include what had previously been specified - in three separate documents: HTML4, XHTML1, and DOM2 HTML. It also - meant including significantly more detail than had previously been - considered the norm.</p><p>In 2006, the W3C indicated an interest to participate in the - development of HTML5 after all, and in 2007 formed a working group - chartered to work with the WHATWG on the development of the HTML5 - specification. Apple, Mozilla, and Opera allowed the W3C to publish - the specification under the W3C copyright, while keeping a version - with the less restrictive license on the WHATWG site.</p><p>Since then, both groups have been working together.</p><p>A separate document has been published by the W3C HTML working - group to document the differences between this specification and the - language described in the HTML4 specification. <a href="references.html#refsHTMLDIFF">[HTMLDIFF]</a></p><h3 id="design-notes"><span class="secno">1.5 </span>Design notes</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p><i>This section is non-normative.</i></p><p>It must be admitted that many aspects of HTML appear at first - glance to be nonsensical and inconsistent.</p><p>HTML, its supporting DOM APIs, as well as many of its supporting - technologies, have been developed over a period of several decades - by a wide array of people with different priorities who, in many - cases, did not know of each other's existence.</p><p>Features have thus arisen from many sources, and have not always - been designed in especially consistent ways. Furthermore, because of - the unique characteristics of the Web, implementation bugs have - often become de-facto, and now de-jure, standards, as content is - often unintentionally written in ways that rely on them before they - can be fixed.</p><p>Despite all this, efforts have been made to adhere to certain - design goals. These are described in the next few subsections.</p><h4 id="serializability-of-script-execution"><span class="secno">1.5.1 </span>Serializability of script execution</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p><i>This section is non-normative.</i></p><p>To avoid exposing Web authors to the complexities of - multithreading, the HTML and DOM APIs are designed such that no - script can ever detect the simultaneous execution of other - scripts. Even with <span title="Worker">workers</span>, the intent - is that the behavior of implementations can be thought of as - completely serializing the execution of all scripts in all <a href="browsers.html#browsing-context" title="browsing context">browsing contexts</a>.</p><p class="note">The <code title="dom-navigator-yieldForStorageUpdates"><a href="#dom-navigator-yieldforstorageupdates">navigator.yieldForStorageUpdates()</a></code> - method, in this model, is equivalent to allowing other scripts to - run while the calling script is blocked.</p><h4 id="compliance-with-other-specifications"><span class="secno">1.5.2 </span>Compliance with other specifications</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p><i>This section is non-normative.</i></p><p>This specification interacts with and relies on a wide variety of - other specifications. In certain circumstances, unfortunately, the - desire to be compatible with legacy content has led to this - specification violating the requirements of these other - specifications. Whenever this has occurred, the transgressions have - each been noted as a "<dfn id="willful-violation">willful violation</dfn>".</p><h3 id="html-vs-xhtml"><span class="secno">1.6 </span>HTML vs XHTML</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p><i>This section is non-normative.</i></p><p>This specification defines an abstract language for describing - documents and applications, and some APIs for interacting with - in-memory representations of resources that use this language.</p><p>The in-memory representation is known as "DOM HTML", or "the DOM" - for short. This specification defines version 5 of DOM HTML, known - as "DOM5 HTML".</p><p>There are various concrete syntaxes that can be used to transmit - resources that use this abstract language, two of which are defined - in this specification.</p><p>The first such concrete syntax is the HTML syntax. This is the - format suggested for most authors. It is compatible with most legacy - Web browsers. If a document is transmitted with the <a href="infrastructure.html#mime-type">MIME - type</a> <code><a href="iana.html#text-html">text/html</a></code>, then it will be processed as an - HTML document by Web browsers. This specification defines version 5 - of the HTML syntax, known as "HTML5".</p><p>The second concrete syntax is the XHTML syntax, which is an - application of XML. When a document is transmitted with an <a href="infrastructure.html#xml-mime-type">XML - MIME type</a>, such as <code><a href="iana.html#application-xhtml-xml">application/xhtml+xml</a></code>, then - it is treated as an XML document by Web browsers, to be parsed by an - XML processor. Authors are reminded that the processing for XML and - HTML differs; in particular, even minor syntax errors will prevent a - document labeled as XML from being rendered fully, whereas they - would be ignored in the HTML syntax. This specification defines - version 5 of the XHTML syntax, known as "XHTML5".</p><p>The DOM, the HTML syntax, and XML cannot all represent the same - content. For example, namespaces cannot be represented using the - HTML syntax, but they are supported in the DOM and in XML. - Similarly, documents that use the <code><a href="scripting-1.html#the-noscript-element">noscript</a></code> feature can - be represented using the HTML syntax, but cannot be represented with - the DOM or in XML. Comments that contain the string "<code title="">--></code>" can be represented in the DOM but not in the - HTML syntax or in XML.</p><h3 id="structure-of-this-specification"><span class="secno">1.7 </span>Structure of this specification</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p><i>This section is non-normative.</i></p><p>This specification is divided into the following major - sections:</p><dl><dt><a href="infrastructure.html#infrastructure">Common Infrastructure</a></dt> - - <dd>The conformance classes, algorithms, definitions, and the - common underpinnings of the rest of the specification.</dd> - - - <dt><a href="dom.html#dom">Semantics, structure, and APIs of HTML documents</a></dt> - - <dd>Documents are built from elements. These elements form a tree - using the DOM. This section defines the features of this DOM, as - well as introducing the features common to all elements, and the - concepts used in defining elements.</dd> - - - <dt><a href="semantics.html#semantics">Elements</a></dt> - - <dd>Each element has a predefined meaning, which is explained in - this section. Rules for authors on how to use the element, along with user agent requirements for how to handle - each element,</dd> - - - <dt><a href="microdata.html#microdata">Microdata</a></dt> - - <dd>This specification introduces a mechanism for adding - machine-readable annotations to documents, so that tools can - extract trees of name/value pairs from the document. This section - describes this mechanism and some algorithms - that can be used to convert HTML documents into other - formats</dd> - - - <dt><a href="browsers.html#browsers">Web Browsers</a></dt> - - <dd>HTML documents do not exist in a vacuum — this section - defines many of the features that affect environments that deal - with multiple pages, links between pages, and running scripts.</dd> - - - <dt><a href="editing.html#editing">User Interaction</a></dt> - - <dd>HTML documents can provide a number of mechanisms for users to - interact with and modify content, which are described in this - section.</dd> - - - <dt><a href="comms.html#comms">The Communication APIs</a></dt> - - <dd>This section describes some mechanisms that applications - written in HTML can use to communicate with other applications from - different domains running on the same client. - </dd> - - - <dt><a href="syntax.html#syntax">The HTML Syntax</a></dt> - <dt><a href="the-xhtml-syntax.html#xhtml">The XHTML Syntax</a></dt> - - <dd>All of these features would be for naught if they couldn't be - represented in a serialized form and sent to other people, and so - these sections define the syntaxes of HTML, along with rules for - how to parse content using those syntaxes.</dd> - - - </dl><p>There are also some appendices, defining <a href="#rendering">rendering rules</a> for Web browsers and listing - <a href="obsolete.html#obsolete">obsolete features</a> and <a href="iana.html#iana">IANA - considerations</a>.</p><h4 id="how-to-read-this-specification"><span class="secno">1.7.1 </span>How to read this specification</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>This specification should be read like all other specifications. - First, it should be read cover-to-cover, multiple times. Then, it - should be read backwards at least once. Then it should be read by - picking random sections from the contents list and following all the - cross-references.</p><h4 id="typographic-conventions"><span class="secno">1.7.2 </span>Typographic conventions</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>This is a definition, requirement, or explanation.</p><p class="note">This is a note.</p><p class="example">This is an example.</p><p class="XXX">This is an open issue.</p><p class="warning">This is a warning.</p><pre class="idl extract">interface <dfn title="">Example</dfn> { - // this is an IDL definition -};</pre><dl class="domintro"><dt><var title="">variable</var> = <var title="">object</var> . <code title="">method</code>( [ <var title="">optionalArgument</var> ] )</dt> - - <dd> - - <p>This is a note to authors describing the usage of an interface.</p> - - </dd> - - </dl><pre class="css">/* this is a CSS fragment */</pre><p>The defining instance of a term is marked up like <dfn id="x-this" title="x-this">this</dfn>. Uses of that term are marked up like - <a href="#x-this" title="x-this">this</a> or like <i title="x-this"><a href="#x-this">this</a></i>.</p><p>The defining instance of an element, attribute, or API is marked - up like <dfn id="x-that" title="x-that"><code>this</code></dfn>. References to - that element, attribute, or API are marked up like <code title="x-that"><a href="#x-that">this</a></code>.</p><p>Other code fragments are marked up <code title="">like - this</code>.</p><p>Variables are marked up like <var title="">this</var>.</p><h3 id="a-quick-introduction-to-html"><span class="secno">1.8 </span>A quick introduction to HTML</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p><i>This section is non-normative.</i></p><p>A basic HTML document looks like this:</p><pre id="intro-early-example"><!DOCTYPE html> -<html> - <head> - <title>Sample page</title> - </head> - <body> - <h1>Sample page</h1> - <p>This is a <a href="demo.html">simple</a> sample.</p> - <!-- this is a comment --> - </body> -</html></pre><p>HTML documents consist of a tree of elements and text. Each - element is denoted in the source by a <a href="syntax.html#syntax-start-tag" title="syntax-start-tag">start tag</a>, such as "<code title=""><body></code>", and an <a href="syntax.html#syntax-end-tag" title="syntax-end-tag">end - tag</a>, such as "<code title=""></body></code>". (Certain - start tags and end tags can in certain cases be <a href="syntax.html#syntax-tag-omission" title="syntax-tag-omission">omitted</a> and are implied by other - tags.)</p><p>Tags have to be nested such that elements are all completely - within each other, without overlapping:</p><pre class="bad"><p>This is <em>very <strong>wrong</em>!</strong></p></pre><pre><p>This <em>is <strong>correct</strong>.</em></p></pre><p>This specification defines a set of elements that can be used in - HTML, along with rules about the ways in which the elements can be - nested.</p><p>Elements can have attributes, which control how the elements - work. In the example below, there is a <a href="links.html#hyperlink">hyperlink</a>, - formed using the <code><a href="text-level-semantics.html#the-a-element">a</a></code> element and its <code title="attr-hyperlink-href"><a href="links.html#attr-hyperlink-href">href</a></code> attribute:</p><pre><a href="demo.html">simple</a></pre><p><a href="syntax.html#syntax-attributes" title="syntax-attributes">Attributes</a> are placed - inside the start tag, and consist of a <a href="syntax.html#syntax-attribute-name" title="syntax-attribute-name">name</a> and a <a href="syntax.html#syntax-attribute-value" title="syntax-attribute-value">value</a>, separated by an "<code title="">=</code>" character. The attribute value can be left <a href="syntax.html#unquoted">unquoted</a> if it doesn't contain spaces or any of - <code title="">"</code> <code title="">'</code> <code title="">`</code> <code title="">=</code> <code title=""><</code> - or <code title="">></code>. Otherwise, it has to be quoted using - either single or double quotes. The value, along with the "<code title="">=</code>" character, can be omitted altogether if the value - is the empty string.</p><pre><!-- empty attributes --> -<input name=address disabled> -<input name=address disabled=""> - -<!-- attributes with a value --> -<input name=address maxlength=200> -<input name=address maxlength='200'> -<input name=address maxlength="200"></pre><p>HTML user agents (e.g. Web browsers) then <i>parse</i> this - markup, turning it into a DOM (Document Object Model) tree. A DOM - tree is an in-memory representation of a document.</p><p>DOM trees contain several kinds of nodes, in particular a DOCTYPE - node, elements, text nodes, and comment nodes.</p><p>The <a href="#intro-early-example">markup snippet at the top of - this section</a> would be turned into the following DOM tree:</p><ul class="domTree"><li class="t10">DOCTYPE: <code><a href="semantics.html#the-html-element-0">html</a></code></li><li class="t1"><code><a href="semantics.html#the-html-element-0">html</a></code><ul><li class="t1"><code><a href="semantics.html#the-head-element-0">head</a></code><ul><li class="t3"><code>#text</code>: <span title="">⏎␣␣</span></li><li class="t1"><code><a href="semantics.html#the-title-element-0">title</a></code><ul><li class="t3"><code>#text</code>: <span title="">Sample page</span></li></ul></li><li class="t3"><code>#text</code>: <span title="">⏎␣</span></li></ul></li><li class="t3"><code>#text</code>: <span title="">⏎␣</span></li><li class="t1"><code><a href="sections.html#the-body-element-0">body</a></code><ul><li class="t3"><code>#text</code>: <span title="">⏎␣␣</span></li><li class="t1"><code><a href="sections.html#the-h1-h2-h3-h4-h5-and-h6-elements">h1</a></cod><ul><li class="t3"><code>#text</code>: <span title="">Sample page</span></li></ul></li><li class="t3"><code>#text</code>: <span title="">⏎␣␣</span></li><li class="t1"><code><a href="grouping-content.html#the-p-element">p</a></code><ul><li class="t3"><code>#text</code>: <span title="">This is a </span></li><li class="t1"><code><a href="text-level-semantics.html#the-a-element">a</a></code> <span class="t2" title=""><code class="attribute name">href</code>="<code class="attribute value">demo.html</code>"</span><ul><li class="t3"><code>#text</code>: <span title="">simple</span></li></ul></li><li class="t3"><code>#text</code>: <span title=""> sample.</span></li></ul></li><li class="t3"><code>#text</code>: <span title="">⏎␣␣</span></li><li class="t8"><code>#comment</code>: <span title=""> this is a comment </span></li><li class="t3"><code>#text</code>: <span title="">⏎␣⏎</span></li></ul></li></ul></li></ul><p>The <a href="infrastructure.html#root-element">roo element</a> of this tree is the - <code><a href="semantics.html#the-html-element-0">html</a></code> element, which is the element always found at the - root of HTML documents. It contains two elements, <code><a href="semantics.html#the-head-element-0">head</a></code> - and <code><a href="sections.html#the-body-element-0">body</a></code>, as well as a text node between them.</p><p>There are many more text nodes in the DOM tree than one would - initially expect, because the source contains a number of spaces - (represented here by "␣") and line breaks ("⏎") that - all end up as text nodes in the DOM.</p><p>The <code><a href="semantics.html#the-head-element-0">head</a></code> element contains a <code><a href="semantics.html#the-title-element-0">title</a></code> - element, which itself contains a text node with the text "Sample - page". Similarly, the <code><a href="sections.html#the-body-element-0">body</a></code> element contains an - <code><a href="sections.html#the-h1-h2-h3-h4-h5-and-h6-elements">h1</a></code> element, a <code><a href="grouping-content.html#the-p-element">p</a></code> element, and a - comment.</p><hr><p>This DOM tree can be manipulated from scripts in the - page. Scripts (typically in JavaScript) are small programs that can - be embedded using the <code><a href="scripting-1.html#script">script</a></code> element or using - <a href="browsers.html#event-handler-content-attributes">event handler content attributes</a>. For example, here is - a form with a script that sets the value of the form's - <code><a href="the-button-element.html#the-output-element">output</a></code> element to say "Hello World":</p><pre><<a href="forms.html#the-form-element">form</a> <a href="forms.html#attr-form-name" title="attr-form-name">name</a>="main"> - Result: <<a href="the-button-element.html#the-output-element">output</a> <a href="association-of-controls-and-forms.html#attr-fe-name" title="attr-fe-name">name</a>="result"></output> - <<a href="scripting-1.html#script">script</a>> - <a href="dom.html#htmldocument" title="HTMLDocument">document</a>.<a href="#dom-document-forms" title="dom-document-forms">forms</a>.main.<a href="#dom-form-elements" title="dom-form-elements">elements</a>.result.<a href="#dom-output-value" title="dom-output-value">value</a> = 'Hello World'; - </script> -</form></pre><p>Each element in the DOM tree is represented by an object, and - these objects have APIs so that they can be manipulated. For - instance, a link (e.g. the <code><a href="text-level-semantics.html#the-a-element">a</a></code> element in the tree above) - can have its "<code title="attr-hyperlink-href"><a href="links.html#attr-hyperlink-href">href</a></code>" - attribute changed in several ways:</p><pre>var a = <a href="dom.html#htmldocument" title="HTMLDocument">document</a>.<a href="#dom-document-links" title="dom-document-links">links</a>[0]; // obtain the first link in the document -a.<a href="#dom-a-href" title="dom-a-href">href</a> = 'sample.html'; // change the destination URL of the link -a.<a href="#dom-uda-protocol" title="dom-uda-protocol">protocol</a> = 'https'; // change just the scheme part of the URL -a.setAttribute('href', 'http://example.com/'); // change the content attribute directly</pre><p>Since DOM trees are used as the way to represent HTML documents - when they are processed and presented by implementations (especially - interactive implementations like Web browsers), this specification - is mostly phrased in terms of DOM trees, instead of the markup - described above.</p><hr><p>HTML documents represent a media-independent description of - interactive content. HTML documents might be rendered to a screen, - or through a speech synthesizer, or on a braille display. To - influence exactly how such rendering takes place, authors can use a - styling language such as CSS.</p><p>In the following example, the page has been made yellow-on-blue - using CSS.</p><pre><!DOCTYPE html> -<html> - <head> - <title>Sample styled page</title> - <style> - body { background: navy; color: yellow; } - </style> - </head> - <body> - <h1>Sample styled page</h1> - <p>This page is just a demo.</p> - </body> -</html></pre><p>For more details on how to use HTML, authors are encouraged to - consult tutorials and guides. Some of the examples included in this - specification might also be of use, but the novice author is - cautioned that this specification, by necessity, defines the - language with a level of detail that might be difficult to - understand at first.</p><h3 id="recommended-reading"><span class="secno">1.9 </span>Recommended reading</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p><i>This section is non-normative.</i></p><p>The following documents might be of interest to readers of this - specification.</p><dl><dt><cite>Character Model for the World Wide Web 1.0: Fundamentals</cite> <a href="references.html#refsCHARMOD">[CHARMOD]</a></dt> - - <dd><blockquote><p>This Architectural Specification provides - authors of specifications, software developers, and content - developers with a common reference for interoperable text - manipulation on the World Wide Web, building on the Universal - Character Set, defined jointly by the Unicode Standard and ISO/IEC - 10646. Topics addressed include use of the terms 'character', - 'encoding' and 'string', a reference processing model, choice and - identification of character encodings, character escaping, and - string indexing.</p></blockquote></dd> - - <dt><cite>Unicode Security Considerations</cite> <a href="references.html#refsUTR36">[UTR36]</a></dt> - - <dd><blockquote><p>Because Unicode contains such a large number of - characters and incorporates the varied writing systems of the - world, incorrect usage can expose programs or systems to possible - security attacks. This is especially important as more and more - products are internationalized. This document describes some of the - security considerations that programmers, system analysts, - standards developers, and users should take into account, and - provides specific recommendations to reduce the risk of - problems.</p></blockquote></dd> - - <dt><cite>Web Content Accessibility Guidelines (WCAG) 2.0</cite> <a href="references.html#refsWCAG">[WCAG]</a></dt> - - <dd><blockquote><p>Web Content Accessibility Guidelines (WCAG) 2.0 - covers a wide range of recommendations for making Web content more - accessible. Following these guidelines will make content accessible - to a wider range of people with disabilities, including blindness - and low vision, deafness and hearing loss, learning disabilities, - cognitive limitations, limited movement, speech disabilities, - photosensitivity and combinations of these. Following these - guidelines will also often make your Web content more usable to - users in general.</p></blockquote></dd> - - - - - - - - - - </dl></body></html> \ No newline at end of file Index: acknowledgements.html =================================================================== RCS file: /sources/public/html5/spec-author-view/acknowledgements.html,v retrieving revision 1.553 retrieving revision 1.554 diff -u -d -r1.553 -r1.554 --- acknowledgements.html 3 Jan 2010 15:08:14 -0000 1.553 +++ acknowledgements.html 3 Jan 2010 15:10:30 -0000 1.554 @@ -1,216 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"> -<!DOCTYPE html> -<!-- when publishing, change bits marked ZZZ --><html lang="en-US-x-Hixie" class="split chapter"><head><title>Acknowledgements — HTML5 (Author Edition)</title><script src="link-fixup.js"></script><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 { 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: #EEFFEE; } - 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; } - - 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; } - - .tall-and-narrow { - font-size: 0.6em; - column-width: 25em; - column-gap: 1em; - -moz-column-width: 25em; - -moz-column-gap: 1em; - -webkit-column-width: 25em; - -webkit-column-gap: 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; } - - #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: 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; } - - #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-exampl \ No newline at end of file Index: common-microsyntaxes.html =================================================================== RCS file: /sources/public/html5/spec-author-view/common-microsyntaxes.html,v retrieving revision 1.7 retrieving revision 1.8 diff -u -d -r1.7 -r1.8 --- common-microsyntaxes.html 1 Jan 2010 06:10:28 -0000 1.7 +++ common-microsyntaxes.html 3 Jan 2010 15:10:30 -0000 1.8 @@ -1,662 +0,0 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"> -<!DOCTYPE html> -<!-- when publishing, change bits marked ZZZ --><html lang="en-US-x-Hixie" class="split chapter"><head><title>2.4 Common microsyntaxes — HTML5 (Author Edition)</title><script src="link-fixup.js"></script><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 { 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: #EEFFEE; } - 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; } - - 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; } - - .tall-and-narrow { - font-size: 0.6em; - column-width: 25em; - column-gap: 1em; - -moz-column-width: 25em; - -moz-column-gap: 1em; - -webkit-column-width: 25em; - -webkit-column-gap: 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; } - - #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: 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; } - - #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; } - - </style><link href="data:text/css," rel="stylesheet" title="Complete specification"><link href="data:text/css,.impl%20%7B%20display:%20none;%20%7D" rel="alternate stylesheet" title="Author documentation only"><link href="data:text/css,.impl%20%7B%20background:%20%23FFEEEE;%20%7D" rel="alternate stylesheet" title="Highlight implementation requirements"><link href="data:text/css," id="complete" rel="stylesheet" title="Complete specification"><link href="data:text/css,.impl%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" id="highlight" rel="alternate stylesheet" title="Highlight implementation requirements"><script> - 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', 'http://www.whatwg.org/specs/web-apps/current-work/' + 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); - // load('reviewer.js'); // would need cross-site XHR - if (document.getElementById('head')) - load('toc.js'); - - // load('updater.js'); // would need cross-site XHR - load('dfn.js'); - // load('status.js'); // would need cross-site XHR - 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="infrastructure.html" title="2 Common infrastructure" rel="prev"> - <link href="Overview.html#contents" title="Table of contents" rel="index"> - <link href="urls.html" title="2.5 URLs" 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 (Author Edition)</h1> - </div><div> - <a href="infrastructure.html">← 2 Common infrastructure</a> – - <a href="Overview.html#contents">Table of contents</a> – - <a href="urls.html">2.5 URLs →</a> - <ol class="toc"><li><ol><li><a href="common-microsyntaxes.html#common-microsyntaxes"><span class="secno">2.4 </span>Common microsyntaxes</a> - <ol><li><a href="common-microsyntaxes.html#boolean-attributes"><span class="secno">2.4.1 </span>Boolean attributes</a></li><li><a href="common-microsyntaxes.html#keywords-and-enumerated-attributes"><span class="secno">2.4.2 </span>Keywords and enumerated attributes</a></li><li><a href="common-microsyntaxes.html#numbers"><span class="secno">2.4.3 </span>Numbers</a> - <ol><li><a href="common-microsyntaxes.html#non-negative-integers"><span class="secno">2.4.3.1 </span>Non-negative integers</a></li><li><a href="common-microsyntaxes.html#signed-integers"><span class="secno">2.4.3.2 </span>Signed integers</a></li><li><a href="common-microsyntaxes.html#real-numbers"><span class="secno">2.4.3.3 </span>Real numbers</a></li><li><a href="common-microsyntaxes.html#ratios"><span class="secno">2.4.3.4 </span>Ratios</a></li><li><a href="common-microsyntaxes.html#lists-of-integers"><span class="secno">2.4.3.5 </span>Lists of integers</a></li></ol></li><li><a href="common-microsyntaxes.html#dates-and-times"><span class="secno">2.4.4 </span>Dates and times</a> - <ol><li><a href="common-microsyntaxes.html#months"><span class="secno">2.4.4.1 </span>Months</a></li><li><a href="common-microsyntaxes.html#dates"><span class="secno">2.4.4.2 </span>Dates</a></li><li><a href="common-microsyntaxes.html#times"><span class="secno">2.4.4.3 </span>Times</a></li><li><a href="common-microsyntaxes.html#local-dates-and-times"><span class="secno">2.4.4.4 </span>Local dates and times</a></li><li><a href="common-microsyntaxes.html#global-dates-and-times"><span class="secno">2.4.4.5 </span>Global dates and times</a></li><li><a href="common-microsyntaxes.html#weeks"><span class="secno">2.4.4.6 </span>Weeks</a></li><li><a href="common-microsyntaxes.html#vaguer-moments-in-time"><span class="secno">2.4.4.7 </span>Vaguer moments in time</a></li></ol></li><li><a href="common-microsyntaxes.html#colors"><span class="secno">2.4.5 </span>Colors</a></li><li><a href="common-microsyntaxes.html#space-separated-tokens"><span class="secno">2.4.6 </span>Space-separated tokens</a></li><li><a href=common-microsyntaxes.html#comma-separated-tokens"><span class="secno">2.4.7 </span>Comma-separated tokens</a></li><li><a href="common-microsyntaxes.html#syntax-references"><span class="secno">2.4.8 </span>References</a></li><li><a href="common-microsyntaxes.html#mq"><span class="secno">2.4.9 </span>Media queries</a></li></ol></li></ol></li></ol></div> - - <h3 id="common-microsyntaxes"><span class="secno">2.4 </span>Common microsyntaxes</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>There are various places in HTML that accept particular data - types, such as dates or numbers. This section describes what the - conformance criteria for content in those formats is, and how to - parse them.</p><h4 id="boolean-attributes"><span class="secno">2.4.1 </span>Boolean attributes</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>A number of attributes are <dfn id="boolean-attribute" title="boolean attribute">boolean - attributes</dfn>. The presence of a boolean attribute on an element - represents the true value, and the absence of the attribute - represents the false value.</p><p>If the attribute is present, its value must either be the empty - string or a value that is an <a href="infrastructure.html#ascii-case-insensitive">ASCII case-insensitive</a> - match for the attribute's canonical name, with no leading or - trailing whitespace.</p><p class="note">The values "true" and "false" are not allowed on - boolean attributes. To represent a false value, the attribute has to - be omitted altogether.</p><h4 id="keywords-and-enumerated-attributes"><span class="secno">2.4.2 </span>Keywords and enumerated attributes</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>Some attributes are defined as taking one of a finite set of - keywords. Such attributes are called <dfn id="enumerated-attribute" title="enumerated - attribute">enumerated attributes</dfn>. The keywords are each - defined to map to a particular <em>state</em> (several keywords - might map to the same state, in which case some of the keywords are - synonyms of each other; additionally, some of the keywords can be - said to be non-conforming, and are only in the specification for - historical reasons). In addition, two default states can be - given. The first is the <i>invalid value default</i>, the second - is the <i>missing value default</i>.</p><p>If an enumerated attribute is specified, the attribute's value - must be an <a href="infrastructure.html#ascii-case-insensitive">ASCII case-insensitive</a> match for one of the - given keywords that are not said to be non-conforming, with no - leading or trailing whitespace.</p><p>When the attribute is specified, if its value is an <a href="infrastructure.html#ascii-case-insensitive">ASCII - case-insensitive</a> match for one of the given keywords then - that keyword's state is the state that the attribute represents. If - the attribute value matches none of the given keywords, but the - attribute has an <i>invalid value default</i>, then the attribute - represents that state. Otherwise, if the attribute value matches - none of the keywords but there is a <i>missing value default</i> - state defined, then <em>that</em> is the state represented by the - attribute. Otherwise, there is no default, and invalid values must - be ignored.</p><p>When the attribute is <em>not</em> specified, if there is a - <i>missing value default</i> state defined, then that is the state - represented by the (missing) attribute. Otherwise, the absence of - the attribute means that there is no state represented.</p><p class="note">The empty string can be a valid keyword.</p><h4 id="numbers"><span class="secno">2.4.3 </span>Numbers</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><h5 id="non-negative-integers"><span class="secno">2.4.3.1 </span>Non-negative integers</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>A string is a <dfn id="valid-non-negative-integer">valid non-negative integer</dfn> if it - consists of one or more characters in the range U+0030 DIGIT ZERO - (0) to U+0039 DIGIT NINE (9).</p><p>A <a href="#valid-non-negative-integer">valid non-negative integer</a> represents the number - that is represented in base ten by that string of digits.</p><h5 id="signed-integers"><span class="secno">2.4.3.2 </span>Signed integers</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>A string is a <dfn id="valid-integer">valid integer</dfn> if it consists of one or - more characters in the range U+0030 DIGIT ZERO (0) to U+0039 DIGIT - NINE (9), optionally prefixed with a U+002D HYPHEN-MINUS character - (-).</p><p>A <a href="#valid-integer">valid integer</a> without a U+002D HYPHEN-MINUS (-) - prefix represents the number that is represented in base ten by that - string of digits. A <a href="#valid-integer">valid integer</a> <em>with</em> a - U+002D HYPHEN-MINUS (-) prefix represents the number represented in - base ten by the string of digits that follows the U+002D - HYPHEN-MINUS, subtracted from zero.</p><h5 id="real-numbers"><span class="secno">2.4.3.3 </span>Real numbers</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>A string is a <dfn id="valid-floating-point-number">valid floating point number</dfn> if it - consists of:</p><ol class="brief"><li>Optionally, a U+002D HYPHEN-MINUS character (-).</li> - - <li>A series of one or more characters in the range U+0030 DIGIT - ZERO (0) to U+0039 DIGIT NINE (9).</li> - - <li>Optionally: - - <ol><li>A single U+002E FULL STOP character (.).</li> - - <li>A series of one or more characters in the range U+0030 DIGIT - ZERO (0) to U+0039 DIGIT NINE (9).</li> - - </ol></li> - - <li>Optionally: - - <ol><li>Either a U+0065 LATIN SMALL LETTER E character (e) or a - U+0045 LATIN CAPITAL LETTER E character (E).</li> - - <li>Optionally, a U+002D HYPHEN-MINUS character (-) or U+002B - PLUS SIGN character (+).</li> - - <li>A series of one or more characters in the range U+0030 DIGIT - ZERO (0) to U+0039 DIGIT NINE (9).</li> - - </ol></li> - - </ol><p>A <a href="#valid-floating-point-number">valid floating point number</a> represents the number - obtained by multiplying the significand by ten raised to the power - of the exponent, where the significand is the first number, - interpreted as base ten (including the decimal point and the number - after the decimal point, if any, and interpreting the significand as - a negative number if the whole string starts with a U+002D - HYPHEN-MINUS character (-) and the number is not zero), and where - the exponent is the number after the E, if any (interpreted as a - negative number if there is a U+002D HYPHEN-MINUS character (-) - between the E and the number and the number is not zero, or else - ignoring a U+002B PLUS SIGN character (+) between the E and the - number if there is one). If there is no E, then the exponent is - treated as zero.</p><p class="note">The Infinity and Not-a-Number (NaN) values are not - <a href="#valid-floating-point-number" title="valid floating point number">valid floating point - numbers</a>.</p><h5 id="ratios"><span class="secno">2.4.3.4 </span>Ratios</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p class="note">The algorithms described in this section are used by - the <code><a href="text-level-semantics.html#the-progress-element">progress</a></code> and <code><a href="text-level-semantics.html#the-meter-element">meter</a></code> elements.</p><p>A <dfn id="valid-denominator-punctuation-character">valid denominator punctuation character</dfn> is one of - the characters from the table below. There is <dfn id="values-associated-with-denominator-punctuation-characters" title="values - associated with denominator punctuation characters">a value - associated with each denominator punctuation character</dfn>, as - shown in the table below.</p><table><thead><tr><th colspan="2">Denominator Punctuation Character</th> - <th>Value</th> - </tr></thead><tbody><tr><td>U+0025 PERCENT SIGN</td> - <td>%</td> - <td>100</td> - </tr><tr><td>U+066A ARABIC PERCENT SIGN</td> - <td>٪</td> - <td>100</td> - </tr><tr><td>U+FE6A SMALL PERCENT SIGN</td> - <td>﹪</td> - <td>100</td> - </tr><tr><td>U+FF05 FULLWIDTH PERCENT SIGN</td> - <td>%</td> - <td>100</td> - </tr><tr><td>U+2030 PER MILLE SIGN</td> - <td>‰</td> - <td>1000</td> - </tr><tr><td>U+2031 PER TEN THOUSAND SIGN</td> - <td>‱</td> - <td>10000</td> - </tr></tbody></table><h5 id="lists-of-integers"><span class="secno">2.4.3.5 </span>Lists of integers</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>A <dfn id="valid-list-of-integers">valid list of integers</dfn> is a number of <a href="#valid-integer" title="valid integer">valid integers</a> separated by U+002C - COMMA characters, with no other characters (e.g. no <a href="#space-character" title="space character">space characters</a>). In addition, there - might be restrictions on the number of integers that can be given, - or on the range of values allowed.</p><h4 id="dates-and-times"><span class="secno">2.4.4 </span>Dates and times</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>In the algorithms below, the <dfn id="number-of-days-in-month-month-of-year-year">number of days in month <var title="">month</var> of year <var title="">year</var></dfn> is: - <em>31</em> if <var title="">month</var> is 1, 3, 5, 7, 8, 10, or - 12; <em>30</em> if <var title="">month</var> is 4, 6, 9, or 11; - <em>29</em> if <var title="">month</var> is 2 and <var title="">year</var> is a number divisible by 400, or if <var title="">year</var> is a number divisible by 4 but not by 100; and - <em>28</em> otherwise. This takes into account leap years in the - Gregorian calendar. <a href="references.html#refsGREGORIAN">[GREGORIAN]</a></p><p>The <dfn id="concept-datetime-digit" title="concept-datetime-digit">digits</dfn> in the date - and time syntaxes defined in this section must be characters in the - range U+0030 DIGIT ZERO (0) to U+0039 DIGIT NINE (9), used to - express numbers in base ten.</p><h5 id="months"><span class="secno">2.4.4.1 </span>Months</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>A <dfn id="concept-month" title="concept-month">month</dfn> consists of a specific - proleptic Gregorian date with no time-zone information and no date - information beyond a year and a month. <a href="references.html#refsGREGORIAN">[GREGORIAN]</a></p><p>A string is a <dfn id="valid-month-string">valid month string</dfn> representing a year - <var title="">year</var> and month <var title="">month</var> if it - consists of the following components in the given order:</p><ol><li>Four or more <a href="#concept-datetime-digit" title="concept-datetime-digit">digits</a>, representing <var title="">year</var>, where <var title="">year</var> > 0</li> - - <li>A U+002D HYPHEN-MINUS character (-)</li> - - <li>Two <a href="#concept-datetime-digit" title="concept-datetime-digit">digits</a>, - representing the month <var title="">month</var>, in the range - 1 ≤ <var title="">month</var> ≤ 12</li> - - </ol><h5 id="dates"><span class="secno">2.4.4.2 </span>Dates</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>A <dfn id="concept-date" title="concept-date">date</dfn> consists of a specific - proleptic Gregorian date with no time-zone information, consisting - of a year, a month, and a day. <a href="references.html#refsGREGORIAN">[GREGORIAN]</a></p><p>A string is a <dfn id="valid-date-string">valid date string</dfn> representing a year - <var title="">year</var>, month <var title="">month</var>, and day - <var title="">day</var> if it consists of the following components - in the given order:</p><ol><li>A <a href="#valid-month-string">valid month string</a>, representing <var title="">year</var> and <var title="">month</var></li> - - <li>A U+002D HYPHEN-MINUS character (-)</li> - - <li>Two <a href="#concept-datetime-digit" title="concept-datetime-digit">digits</a>, - representing <var title="">day</var>, in the range - 1 ≤ <var title="">day</var> ≤ <var title="">maxday</var> where <var title="">maxday</var> is the <a href="#number-of-days-in-month-month-of-year-year" title="number of days in month month of year year">number of days - in the month <var title="">month</var> and year <var title="">year</var></a></li> - - </ol><h5 id="times"><span class="secno">2.4.4.3 </span>Times</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>A <dfn id="concept-time" title="concept-time">time</dfn> consists of a specific - time with no time-zone information, consisting of an hour, a minute, - a second, and a fraction of a second.</p><p>A string is a <dfn id="valid-time-string">valid time string</dfn> representing an hour - <var title="">hour</var>, a minute <var title="">minute</var>, and a - second <var title="">second</var> if it consists of the following - components in the given order:</p><ol><li>Two <a href="#concept-datetime-digit" title="concept-datetime-digit">digits</a>, - representing <var title="">hour</var>, in the range - 0 ≤ <var title="">hour</var> ≤ 23</li> - - <li>A U+003A COLON character (:)</li> - - <li>Two <a href="#concept-datetime-digit" title="concept-datetime-digit">digits</a>, - representing <var title="">minute</var>, in the range - 0 ≤ <var title="">minute</var> ≤ 59</li> - - <li>Optionally (required if <var title="">second</var> is - non-zero): - - <ol><li>A U+003A COLON character (:)</li> - - <li>Two <a href="#concept-datetime-digit" title="concept-datetime-digit">digits</a>, - representing the integer part of <var title="">second</var>, in - the range 0 ≤ <var title="">s</var> ≤ 59</li> - - <li>Optionally (required if <var title="">second</var> is not an - integer): - - <ol><li>A 002E FULL STOP character (.)</li> - - <li>One or more <a href="#concept-datetime-digit" title="concept-datetime-digit">digits</a>, representing the - fractional part of <var title="">second</var></li> - - </ol></li> - - </ol></li> - - </ol><p class="note">The <var title="">second</var> component cannot be - 60 or 61; leap seconds cannot be represented.</p><h5 id="local-dates-and-times"><span class="secno">2.4.4.4 </span>Local dates and times</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>A <dfn id="concept-datetime-local" title="concept-datetime-local">local date and time</dfn> - consists of a specific proleptic Gregorian date, consisting of a - year, a month, and a day, and a time, consisting of an hour, a - minute, a second, and a fraction of a second, but expressed without - a time zone. <a href="references.html#refsGREGORIAN">[GREGORIAN]</a></p><p>A string is a <dfn id="valid-local-date-and-time-string">valid local date and time string</dfn> - representing a date and time if it consists of the following - components in the given order:</p><ol><li>A <a href="#valid-date-string">valid date string</a> representing the date.</li> - - <li>A U+0054 LATIN CAPITAL LETTER T character (T).</li> - - <li>A <a href="#valid-time-string">valid time string</a> representing the time.</li> - - </ol><h5 id="global-dates-and-times"><span class="secno">2.4.4.5 </span>Global dates and times</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>A <dfn id="concept-datetime" title="concept-datetime">global date and time</dfn> - consists of a specific proleptic Gregorian date, consisting of a - year, a month, and a day, and a time, consisting of an hour, a - minute, a second, and a fraction of a second, expressed with a - time-zone offset, consisting of a signed number of hours and - minutes. <a href="references.html#refsGREGORIAN">[GREGORIAN]</a></p><p>A string is a <dfn id="valid-global-date-and-time-string">valid global date and time string</dfn> - representing a date, time, and a time-zone offset if it consists of - the following components in the given order:</p><ol><li>A <a href="#valid-date-string">valid date string</a> representing the date</li> - - <li>A U+0054 LATIN CAPITAL LETTER T character (T)</li> - - <li>A <a href="#valid-time-string">valid time string</a> representing the time</li> - - <li>Either: - - <ul><li>A U+005A LATIN CAPITAL LETTER Z character (Z), allowed only - if the time zone is UTC</li> - - <li>Or: - - <ol><li>Either a U+002B PLUS SIGN character (+) or a U+002D - HYPHEN-MINUS character (-), representing the sign of the - time-zone offset</li> - - <li>Two <a href="#concept-datetime-digit" title="concept-datetime-digit">digits</a>, - representing the hours component <var title="">hour</var> of - the time-zone offset, in the range 0 ≤ <var title="">hour</var> ≤ 23</li> - - <li>A U+003A COLON character (:)</li> - - <li>Two <a href="#concept-datetime-digit" title="concept-datetime-digit">digits</a>, - representing the minutes component <var title="">minute</var> - of the time-zone offset, in the range 0 ≤ <var title="">minute</var> ≤ 59</li> - - </ol></li> - - </ul></li> - - </ol><p class="note">This format allows for time-zone offsets from -23:59 - to +23:59. In practice, however, the range of offsets of actual time - zones is -12:00 to +14:00, and the minutes component of offsets of - actual time zones is always either 00, 30, or 45.</p><div class="example"> - - <p>The following are some examples of dates written as <a href="#valid-global-date-and-time-string" title="valid global date and time string">valid global date and - time strings</a>.</p> - - <dl><dt>"<code>0037-12-13T00:00Z</code>"</dt> - - <dd>Midnight UTC on the birthday of Nero (the Roman Emperor).</dd> - - <dt>"<code>1979-10-14T12:00:00.001-04:00</code>"</dt> - - <dd>One millisecond after noon on October 14th 1979, in the time - zone in use on the east coast of the USA during daylight saving - time.</dd> - - <dt>"<code>8592-01-01T02:09+02:09</code>"</dt> - - <dd>Midnight UTC on the 1st of January, 8592. The time zone - associated with that time is two hours and nine minutes ahead of - UTC, which is not currently a real time zone, but is nonetheless - allowed.</dd> - - </dl><p>Several things are notable about these dates:</p> - - <ul><li>Years with fewer than four digits have to be - zero-padded. The date "37-12-13" would not be a valid date.</li> - - <li>To unambiguously identify a moment in time prior to the - introduction of the Gregorian calendar, the date has to be first - converted to the Gregorian calendar from the calendar in use at - the time (e.g. from the Julian calendar). The date of Nero's birth - is the 15th of December 37, in the Julian Calendar, which is the - 13th of December 37 in the proleptic Gregorian Calendar.</li> <!-- - This might not be true. I can't find a reference that gives his - birthday with an explicit statement about the calendar being - used. However, it seems unlikely that it would be given in the - Gregorian calendar, so I assume sites use the Julian one. --> - - <li>The time and time-zone offset components are not optional.</li> - - <li>Dates before the year one can't be represented as a datetime - in this version of HTML.</li> - - <li>Time-zone offsets differ based on daylight savings time.</li> - - </ul></div><h5 id="weeks"><span class="secno">2.4.4.6 </span>Weeks</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>A <dfn id="concept-week" title="concept-week">week</dfn> consists of a week-year - number and a week number representing a seven-day period starting on - a Monday. Each week-year in this calendaring system has either 52 or - 53 such seven-day periods, as defined below. The seven-day period - starting on the Gregorian date Monday December 29th 1969 - (1969-12-29) is defined as week number 1 in week-year - 1970. Consecutive weeks are numbered sequentially. The week before - the number 1 week in a week-year is the last week in the previous - week-year, and vice versa. <a href="references.html#refsGREGORIAN">[GREGORIAN]</a></p><p>A week-year with a number <var title="">year</var> has 53 weeks - if it corresponds to either a year <var title="">year</var> in the - proleptic Gregorian calendar that has a Thursday as its first day - (January 1st), or a year <var title="">year</var> in the proleptic - Gregorian calendar that has a Wednesday as its first day (January - 1st) and where <var title="">year</var> is a number divisible by - 400, or a number divisible by 4 but not by 100. All other week-years - have 52 weeks.</p><p>The <dfn id="week-number-of-the-last-day">week number of the last day</dfn> of a week-year with 53 - weeks is 53; the week number of the last day of a week-year with 52 - weeks is 52.</p><p class="note">The week-year number of a particular day can be - different than the number of the year that contains that day in the - proleptic Gregorian calendar. The first week in a week-year <var title="">y</var> is the week that contains the first Thursday of - the Gregorian year <var title="">y</var>.</p><p>A string is a <dfn id="valid-week-string">valid week string</dfn> representing a - week-year <var title="">year</var> and week <var title="">week</var> - if it consists of the following components in the given order:</p><ol><li>Four or more <a href="#concept-datetime-digit" title="concept-datetime-digit">digits</a>, representing <var title="">year</var>, where <var title="">year</var> > 0</li> - - <li>A U+002D HYPHEN-MINUS character (-)</li> - - <li>A U+0057 LATIN CAPITAL LETTER W character (W)</li> - - <li>Two <a href="#concept-datetime-digit" title="concept-datetime-digit">digits</a>, - representing the week <var title="">week</var>, in the range - 1 ≤ <var title="">week</var> ≤ <var title="">maxweek</var>, where <var title="">maxweek</var> is the - <a href="#week-number-of-the-last-day">week number of the last day</a> of week-year <var title="">year</var></li> - - </ol><h5 id="vaguer-moments-in-time"><span class="secno">2.4.4.7 </span>Vaguer moments in time</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>A string is a <dfn id="valid-date-or-time-string">valid date or time string</dfn> if it is also - one of the following:</p><ul><li>A <a href="#valid-date-string">valid date string</a>.</li> - - <li>A <a href="#valid-time-string">valid time string</a>.</li> - - <li>A <a href="#valid-global-date-and-time-string">valid global date and time string</a>.</li> - - </ul><p>A string is a <dfn id="valid-date-or-time-string-in-content">valid date or time string in content</dfn> if - it consists of zero or more <a href="#white_space">White_Space</a> characters, - followed by a <a href="#valid-date-or-time-string">valid date or time string</a>, followed by - zero or more further <a href="#white_space">White_Space</a> characters.</p><hr><p>A string is a <dfn id="valid-date-string-with-optional-time">valid date string with optional time</dfn> if - it is also one of the following:</p><ul><li>A <a href="#valid-date-string">valid date string</a>.</li> - - <li>A <a href="#valid-global-date-and-time-string">valid global date and time string</a>.</li> - - </ul><p>A string is a <dfn id="valid-date-string-in-content-with-optional-time">valid date string in content with optional - time</dfn> if it consists of zero or more <a href="#white_space">White_Space</a> - characters, followed by a <a href="#valid-date-string-with-optional-time">valid date string with optional - time</a>, followed by zero or more further - <a href="#white_space">White_Space</a> characters.</p><h4 id="colors"><span class="secno">2.4.5 </span>Colors</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>A <dfn id="simple-color">simple color</dfn> consists of three 8-bit numbers in the - range 0..255, representing the red, green, and blue components of - the color respectively, in the sRGB color space. <a href="references.html#refsSRGB">[SRGB]</a></p><p>A string is a <dfn id="valid-simple-color">valid simple color</dfn> if it is exactly - seven characters long, and the first character is a U+0023 NUMBER - SIGN character (#), and the remaining six characters are all in the - range U+0030 DIGIT ZERO (0) to U+0039 DIGIT NINE (9), U+0041 LATIN - CAPITAL LETTER A to U+0046 LATIN CAPITAL LETTER F, U+0061 LATIN - SMALL LETTER A to U+0066 LATIN SMALL LETTER F, with the first two - digits representing the red component, the middle two digits - representing the green component, and the last two digits - representing the blue component, in hexadecimal.</p><p>A string is a <dfn id="valid-lowercase-simple-color">valid lowercase simple color</dfn> if it is a - <a href="#valid-simple-color">valid simple color</a> and doesn't use any characters in - the range U+0041 LATIN CAPITAL LETTER A to U+0046 LATIN CAPITAL - LETTER F.</p><hr><p class="note">The <a href="the-canvas-element.html#canvas-context-2d" title="canvas-context-2d">2D graphics - context</a> has a separate color syntax that also handles - opacity.</p><h4 id="space-separated-tokens"><span class="secno">2.4.6 </span>Space-separated tokens</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>A <dfn id="set-of-space-separated-tokens">set of space-separated tokens</dfn> is a string containing - zero or more words separated by one or more <a href="#space-character" title="space - character">space characters</a>, where words consist of any - string of one or more characters, none of which are <a href="#space-character" title="space character">space characters</a>.</p><p>A string containing a <a href="#set-of-space-separated-tokens">set of space-separated tokens</a> - may have leading or trailing <a href="#space-character" title="space character">space - characters</a>.</p><p>An <dfn id="unordered-set-of-unique-space-separated-tokens">unordered set of unique space-separated tokens</dfn> is a - <a href="#set-of-space-separated-tokens">set of space-separated tokens</a> where none of the words - are duplicated.</p><p>An <dfn id="ordered-set-of-unique-space-separated-tokens">ordered set of unique space-separated tokens</dfn> is a - <a href="#set-of-space-separated-tokens">set of space-separated tokens</a> where none of the words - are duplicated but where the order of the tokens is meaningful.</p><p><a href="#set-of-space-separated-tokens" title="set of space-separated tokens">Sets of - space-separated tokens</a> sometimes have a defined set of - allowed values. When a set of allowed values is defined, the tokens - must all be from that list of allowed values; other values are - non-conforming. If no such set of allowed values is provided, then - all values are conforming.</p><h4 id="comma-separated-tokens"><span class="secno">2.4.7 </span>Comma-separated tokens</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>A <dfn id="set-of-comma-separated-tokens">set of comma-separated tokens</dfn> is a string containing - zero or more tokens each separated from the next by a single U+002C - COMMA character (,), where tokens consist of any string of zero or - more characters, neither beginning nor ending with <a href="#space-character" title="space character">space characters</a>, nor containing any - U+002C COMMA characters (,), and optionally surrounded by <a href="#space-character" title="space character">space characters</a>.</p><p class="example">For instance, the string "<code title=""> a ,b,,d d </code>" consists of four - tokens: "a", "b", the empty string, and "d d". Leading and - trailing whitespace around each token doesn't count as part of the - token, and the empty string can be a token.</p><p><a href="#set-of-comma-separated-tokens" title="set of comma-separated tokens">Sets of - comma-separated tokens</a> sometimes have further restrictions on - what consists a valid token. When such restrictions are defined, the - tokens must all fit within those restrictions; other values are - non-conforming. If no such restrictions are specified, then all - values are conforming.</p><h4 id="syntax-references"><span class="secno">2.4.8 </span>References</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>A <dfn id="valid-hash-name-reference">valid hash-name reference</dfn> to an element of type <var title="">type</var> is a string consisting of a U+0023 NUMBER SIGN - character (#) followed by a string which exactly matches the value - of the <code title="">name</code> attribute of an element in the - document with type <var title="">type</var>.</p><h4 id="mq"><span class="secno">2.4.9 </span>Media queries</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><p>A string is a <dfn id="valid-media-query">valid media query</dfn> if it matches the - <code title="">media_query_list</code> production of the Media - Queries specification. <a href="references.html#refsMQ">[MQ]</a></p><p>A string <dfn id="matches-the-environment">matches the environment</dfn> of a view if it is - the empty string, a string consisting of only <a href="#space-character" title="space - character">space characters</a>, or is a media query that matches - that view's environment according to the definitions given in the - Media Queries specification. <a href="references.html#refsMQ">[MQ]</a></p></body></html> \ No newline at end of file
Received on Sunday, 3 January 2010 15:10:51 UTC