Annotation of html5/spec/syntax.html, revision 1.7
1.2 mike 1: <!DOCTYPE HTML>
1.1 mike 2: <html lang="en-US-x-Hixie"><head><title>HTML 5</title><style type="text/css">
3: pre { margin-left: 2em; white-space: pre-wrap; }
4: h2 { margin: 3em 0 1em 0; }
5: h3 { margin: 2.5em 0 1em 0; }
6: h4 { margin: 2.5em 0 0.75em 0; }
7: h5, h6 { margin: 2.5em 0 1em; }
8: h1 + h2, h1 + h2 + h2 { margin: 0.75em 0 0.75em; }
9: h2 + h3, h3 + h4, h4 + h5, h5 + h6 { margin-top: 0.5em; }
10: p { margin: 1em 0; }
11: hr:not(.top) { display: block; background: none; border: none; padding: 0; margin: 2em 0; height: auto; }
12: dl, dd { margin-top: 0; margin-bottom: 0; }
13: dt { margin-top: 0.75em; margin-bottom: 0.25em; clear: left; }
14: dt + dt { margin-top: 0; }
15: dd dt { margin-top: 0.25em; margin-bottom: 0; }
16: dd p { margin-top: 0; }
17: dd dl + p { margin-top: 1em; }
18: dd table + p { margin-top: 1em; }
19: p + * > li, dd li { margin: 1em 0; }
20: dt, dfn { font-weight: bold; font-style: normal; }
21: dt dfn { font-style: italic; }
22: pre, code { font-size: inherit; font-family: monospace; font-variant: normal; }
23: pre strong { color: black; font: inherit; font-weight: bold; background: yellow; }
24: pre em { font-weight: bolder; font-style: normal; }
25: @media screen { code { color: orangered; } code :link, code :visited { color: inherit; } }
26: var sub { vertical-align: bottom; font-size: smaller; position: relative; top: 0.1em; }
27: table { border-collapse: collapse; border-style: hidden hidden none hidden; }
28: table thead { border-bottom: solid; }
29: table tbody th:first-child { border-left: solid; }
30: table td, table th { border-left: solid; border-right: solid; border-bottom: solid thin; vertical-align: top; padding: 0.2em; }
31: blockquote { margin: 0 0 0 2em; border: 0; padding: 0; font-style: italic; }
32:
33: .bad, .bad *:not(.XXX) { color: gray; border-color: gray; background: transparent; }
34: .matrix, .matrix td { border: none; text-align: right; }
35: .matrix { margin-left: 2em; }
36: .dice-example { border-collapse: collapse; border-style: hidden solid solid hidden; border-width: thin; margin-left: 3em; }
37: .dice-example caption { width: 30em; font-size: smaller; font-style: italic; padding: 0.75em 0; text-align: left; }
38: .dice-example td, .dice-example th { border: solid thin; width: 1.35em; height: 1.05em; text-align: center; padding: 0; }
1.2 mike 39: .applies th > * { display: block; }
1.1 mike 40: .applies thead code { display: block; }
41: .applies td { text-align: center; }
42: .applies .yes { background: yellow; }
43:
44: .toc dfn, h1 dfn, h2 dfn, h3 dfn, h4 dfn, h5 dfn, h6 dfn { font: inherit; }
45: img.extra { float: right; }
46: pre.idl { border: solid thin; background: #EEEEEE; color: black; padding: 0.5em 1em; }
47: pre.idl :link, pre.idl :visited { color: inherit; background: transparent; }
48: pre.css { border: solid thin; background: #FFFFEE; color: black; padding: 0.5em 1em; }
49: pre.css:first-line { color: #AAAA50; }
50: dl.domintro { color: green; margin: 2em 0 2em 2em; padding: 0.5em 1em; border: none; background: #EEFFEE; }
51: hr + dl.domintro, div.impl + dl.domintro { margin-top: 2.5em; margin-bottom: 1.5em; }
52: dl.domintro dt, dl.domintro dt * { color: black; text-decoration: none; }
53: dl.domintro dd { margin: 0.5em 0 1em 2em; padding: 0; }
54: dl.domintro dd p { margin: 0.5em 0; }
55: dl.switch { padding-left: 2em; }
56: dl.switch > dt { text-indent: -1.5em; }
57: dl.switch > dt:before { content: '\21AA'; padding: 0 0.5em 0 0; display: inline-block; width: 1em; text-align: right; line-height: 0.5em; }
58: dl.triple { padding: 0 0 0 1em; }
59: dl.triple dt, dl.triple dd { margin: 0; display: inline }
60: dl.triple dt:after { content: ':'; }
61: dl.triple dd:after { content: '\A'; white-space: pre; }
62: .diff-old { text-decoration: line-through; color: silver; background: transparent; }
63: .diff-chg, .diff-new { text-decoration: underline; color: green; background: transparent; }
64: a .diff-new { border-bottom: 1px blue solid; }
65:
66: h2 { page-break-before: always; }
67: h1, h2, h3, h4, h5, h6 { page-break-after: avoid; }
68: h1 + h2, hr + h2.no-toc { page-break-before: auto; }
69:
70: p > span:not([title=""]):not([class="XXX"]):not([class="impl"]), li > span:not([title=""]):not([class="XXX"]):not([class="impl"]) { border-bottom: solid #9999CC; }
71:
72: div.head { margin: 0 0 1em; padding: 1em 0 0 0; }
73: div.head p { margin: 0; }
74: div.head h1 { margin: 0; }
75: div.head .logo { float: right; margin: 0 1em; }
76: div.head .logo img { border: none } /* remove border from top image */
77: div.head dl { margin: 1em 0; }
78: p.copyright { font-size: x-small; font-style: oblique; margin: 0; }
79:
80: body > .toc > li { margin-top: 1em; margin-bottom: 1em; }
81: body > .toc.brief > li { margin-top: 0.35em; margin-bottom: 0.35em; }
82: body > .toc > li > * { margin-bottom: 0.5em; }
83: body > .toc > li > * > li > * { margin-bottom: 0.25em; }
84: .toc, .toc li { list-style: none; }
85:
86: .brief { margin-top: 1em; margin-bottom: 1em; line-height: 1.1; }
87: .brief li { margin: 0; padding: 0; }
88: .brief li p { margin: 0; padding: 0; }
89:
90: .category-list { margin-top: -0.75em; margin-bottom: 1em; line-height: 1.5; }
91: .category-list::before { content: '\21D2\A0'; font-size: 1.2em; font-weight: 900; }
92: .category-list li { display: inline; }
93: .category-list li:not(:last-child)::after { content: ', '; }
94: .category-list li > span, .category-list li > a { text-transform: lowercase; }
95: .category-list li * { text-transform: none; } /* don't affect <code> nested in <a> */
96:
97: .XXX { color: #E50000; background: white; border: solid red; padding: 0.5em; margin: 1em 0; }
98: .XXX > :first-child { margin-top: 0; }
99: p .XXX { line-height: 3em; }
100: .note { color: green; background: transparent; font-family: sans-serif; }
101: .warning { color: red; background: transparent; }
102: .note, .warning { font-weight: bolder; font-style: italic; }
103: p.note, div.note { padding: 0.5em 2em; }
104: span.note { padding: 0 2em; }
105: .note p:first-child, .warning p:first-child { margin-top: 0; }
106: .note p:last-child, .warning p:last-child { margin-bottom: 0; }
107: .warning:before { font-style: normal; }
108: p.note:before { content: 'Note: '; }
109: p.warning:before { content: '\26A0 Warning! '; }
110:
111: .bookkeeping:before { display: block; content: 'Bookkeeping details'; font-weight: bolder; font-style: italic; }
112: .bookkeeping { font-size: 0.8em; margin: 2em 0; }
113: .bookkeeping p { margin: 0.5em 2em; display: list-item; list-style: square; }
114:
115: h4 { position: relative; z-index: 3; }
116: h4 + .element, h4 + div + .element { margin-top: -2.5em; padding-top: 2em; }
117: .element {
118: background: #EEEEFF;
119: color: black;
120: margin: 0 0 1em 0.15em;
121: padding: 0 1em 0.25em 0.75em;
122: border-left: solid #9999FF 0.25em;
123: position: relative;
124: z-index: 1;
125: }
126: .element:before {
127: position: absolute;
128: z-index: 2;
129: top: 0;
130: left: -1.15em;
131: height: 2em;
132: width: 0.9em;
133: background: #EEEEFF;
134: content: ' ';
135: border-style: none none solid solid;
136: border-color: #9999FF;
137: border-width: 0.25em;
138: }
139:
140: .example {
141: display: block;
142: color: #222222;
143: background: #FCFCFC;
144: border-left: double;
145: margin-left: 2em;
146: padding-left: 1em;
147: }
148:
149: .tall-and-narrow {
150: font-size: 0.6em;
151: column-width: 25em;
152: column-gap: 1em;
153: -moz-column-width: 25em;
154: -moz-column-gap: 1em;
155: -webkit-column-width: 25em;
156: -webkit-column-gap: 1em;
157: }
158:
159: ul.domTree, ul.domTree ul { padding: 0 0 0 1em; margin: 0; }
160: ul.domTree li { padding: 0; margin: 0; list-style: none; position: relative; }
161: ul.domTree li li { list-style: none; }
162: 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; }
163: 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; }
164: ul.domTree span { font-style: italic; font-family: serif; }
165: ul.domTree .t1 code { color: purple; font-weight: bold; }
166: ul.domTree .t2 { font-style: normal; font-family: monospace; }
167: ul.domTree .t2 .name { color: black; font-weight: bold; }
168: ul.domTree .t2 .value { color: blue; font-weight: normal; }
169: ul.domTree .t3 code, .domTree .t4 code, .domTree .t5 code { color: gray; }
170: ul.domTree .t7 code, .domTree .t8 code { color: green; }
171: ul.domTree .t10 code { color: teal; }
172:
1.2 mike 173: </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 -->
174: <script src="link-fixup.js"></script>
175: <link href="comms.html" title="8 Communication" rel="prev">
176: <link href="spec.html#contents" title="Table of contents" rel="index">
1.1 mike 177: <link href="named-character-references.html" title="9.6 Named character references" rel="next">
178: </head><body><div class="head">
179: <p><a href="http://www.w3.org/"><img alt="W3C" height="48" src="http://www.w3.org/Icons/w3c_home" width="72"></a></p>
1.4 mike 180: <h1>HTML 5</h1>
1.1 mike 181: <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>
1.2 mike 182: </div><nav>
1.1 mike 183: <a href="comms.html">← 8 Communication</a> –
1.2 mike 184: <a href="spec.html#contents">Table of contents</a> –
1.1 mike 185: <a href="named-character-references.html">9.6 Named character references →</a>
1.7 ! mike 186: </nav><p>This is revision 1.2578.</p>
1.4 mike 187: <h1>
1.1 mike 188:
189: <h2 id="syntax"><span class="secno">9 </span><dfn>The HTML syntax</dfn></h2><p class="note">This section only describes the rules for <code title="">text/html</code> resources. Rules for XML resources are
190: discussed in the section below entitled "<a href="the-xhtml-syntax.html#the-xhtml-syntax">The XHTML
191: syntax</a>".</p><h3 id="writing"><span class="secno">9.1 </span>Writing HTML documents</h3><div class="impl">
192:
193: <p><i>This section only applies to documents, authoring tools, and
194: markup generators. In particular, it does not apply to conformance
195: checkers; conformance checkers must use the requirements given in
196: the next section ("parsing HTML documents").</i></p>
197:
198: </div><p>Documents must consist of the following parts, in the given
199: order:</p><ol><li>Optionally, a single U+FEFF BYTE ORDER MARK (BOM) character.</li>
200:
201: <li>Any number of <a href="#syntax-comments" title="syntax-comments">comments</a> and
202: <a href="infrastructure.html#space-character" title="space character">space characters</a>.</li>
203:
204: <li>A <a href="#syntax-doctype" title="syntax-doctype">DOCTYPE</a>.
205:
206: </li><li>Any number of <a href="#syntax-comments" title="syntax-comments">comments</a> and
207: <a href="infrastructure.html#space-character" title="space character">space characters</a>.</li>
208:
209: <li>The root element, in the form of an <code><a href="semantics.html#the-html-element">html</a></code> <a href="#syntax-elements" title="syntax-elements">element</a>.</li>
210:
211: <li>Any number of <a href="#syntax-comments" title="syntax-comments">comments</a> and
212: <a href="infrastructure.html#space-character" title="space character">space characters</a>.</li>
213:
214: </ol><p>The various types of content mentioned above are described in the
215: next few sections.</p><p>In addition, there are some restrictions on how <a href="semantics.html#character-encoding-declaration" title="character encoding declaration">character encoding
216: declarations</a> are to be serialized, as discussed in the
217: section on that topic.</p><div class="note">
218:
219: <p>Space characters before the root <code><a href="semantics.html#the-html-element">html</a></code> element, and
220: space characters at the start of the <code><a href="semantics.html#the-html-element">html</a></code> element and
221: before the <code><a href="semantics.html#the-head-element">head</a></code> element, will be dropped when the
222: document is parsed; space characters <em>after</em> the root
223: <code><a href="semantics.html#the-html-element">html</a></code> element will be parsed as if they were at the end
224: of the <code><a href="semantics.html#the-body-element">body</a></code> element. Thus, space characters around the
225: root element do not round-trip.</p>
226:
227: <p>It is suggested that newlines be inserted after the DOCTYPE,
228: after any comments that are before the root element, after the
229: <code><a href="semantics.html#the-html-element">html</a></code> element's start tag (if it is not <a href="#syntax-tag-omission" title="syntax-tag-omission">omitted</a>), and after any comments
230: that are inside the <code><a href="semantics.html#the-html-element">html</a></code> element but before the
231: <code><a href="semantics.html#the-head-element">head</a></code> element.</p>
232:
233: </div><p>Many strings in the HTML syntax (e.g. the names of elements and
234: their attributes) are case-insensitive, but only for characters in
235: the ranges U+0041 .. U+005A (LATIN CAPITAL LETTER A to LATIN CAPITAL
236: LETTER Z) and U+0061 .. U+007A (LATIN SMALL LETTER A to LATIN SMALL
237: LETTER Z). For convenience, in this section this is just referred to
238: as "case-insensitive".</p><h4 id="the-doctype"><span class="secno">9.1.1 </span>The DOCTYPE</h4><p>A <dfn id="syntax-doctype" title="syntax-doctype">DOCTYPE</dfn> is a mostly useless,
239: but required, header.</p><p class="note">DOCTYPEs are required for legacy reasons. When
240: omitted, browsers tend to use a different rendering mode that is
241: incompatible with some specifications. Including the DOCTYPE in a
242: document ensures that the browser makes a best-effort attempt at
243: following the relevant specifications.</p><p>A DOCTYPE must consist of the following characters, in this
244: order:</p><ol class="brief"><li>A U+003C LESS-THAN SIGN (<code><</code>) character.</li>
245: <li>A U+0021 EXCLAMATION MARK (<code>!</code>) character.</li>
246: <li>A string that is an <a href="infrastructure.html#ascii-case-insensitive">ASCII case-insensitive</a> match for the string "<code title="">DOCTYPE</code>".</li>
247: <li>One or more <a href="infrastructure.html#space-character" title="space character">space characters</a>.</li>
248: <li>A string that is an <a href="infrastructure.html#ascii-case-insensitive">ASCII case-insensitive</a> match for the string "<code title="">HTML</code>".</li>
249: <li>Optionally, a <a href="#doctype-legacy-string">DOCTYPE legacy string</a> (defined below).</li>
250: <li>Zero or more <a href="infrastructure.html#space-character" title="space character">space characters</a>.</li>
251: <li>A U+003E GREATER-THAN SIGN (<code>></code>) character.</li>
252: </ol><p class="note">In other words, <code><!DOCTYPE HTML></code>,
253: case-insensitively.</p><p>For the purposes of HTML generators that cannot output HTML
254: markup with the short DOCTYPE "<code title=""><!DOCTYPE
255: HTML></code>", a <dfn id="doctype-legacy-string">DOCTYPE legacy string</dfn> may be inserted
256: into the DOCTYPE (in the position defined above). This string must
257: consist of:</p><ol class="brief"><li>One or more <a href="infrastructure.html#space-character" title="space character">space characters</a>.</li>
258: <li>A string that is an <a href="infrastructure.html#ascii-case-insensitive">ASCII case-insensitive</a> match for the string "<code title="">SYSTEM</code>".</li>
259: <li>One or more <a href="infrastructure.html#space-character" title="space character">space characters</a>.</li>
260: <li>A U+0022 QUOTATION MARK or U+0027 APOSTROPHE character (the <i>quote mark</i>).</li>
261: <li>The literal string "<code title="">about:legacy-compat</code>".</li>
262: <li>A matching U+0022 QUOTATION MARK or U+0027 APOSTROPHE character (i.e. the same character as in the earlier step marked <i>quote mark</i>).</li>
263: </ol><p class="note">In other words, <code><!DOCTYPE HTML SYSTEM
264: "about:legacy-compat"></code> or <code><!DOCTYPE HTML SYSTEM
265: 'about:legacy-compat'></code>, case-insensitively except for the bit
266: in quotes.</p><p>The <a href="#doctype-legacy-string">DOCTYPE legacy string</a> should not be used unless
267: the document is generated from a system that cannot output the
268: shorter string.</p><h4 id="elements-0"><span class="secno">9.1.2 </span>Elements</h4><p>There are five different kinds of <dfn id="syntax-elements" title="syntax-elements">elements</dfn>: void elements, CDATA
269: elements, RCDATA elements, foreign elements, and normal
270: elements.</p><dl><dt><dfn id="void-elements">Void elements</dfn></dt>
271:
272: <dd><code><a href="the-canvas-element.html#the-area-element">area</a></code>, <code><a href="semantics.html#the-base-element">base</a></code>, <code><a href="semantics.html#the-br-element">br</a></code>,
273: <code><a href="tabular-data.html#the-col-element">col</a></code>, <code><a href="interactive-elements.html#the-command">command</a></code>, <code><a href="embedded-content-0.html#the-embed-element">embed</a></code>,
274: <code><a href="semantics.html#the-hr-element">hr</a></code>, <code><a href="embedded-content-0.html#the-img-element">img</a></code>, <code><a href="forms.html#the-input-element">input</a></code>,
275: <code><a href="forms.html#the-keygen-element">keygen</a></code>, <code><a href="semantics.html#the-link-element">link</a></code>, <code><a href="semantics.html#meta">meta</a></code>,
276: <code><a href="embedded-content-0.html#the-param-element">param</a></code>, <code><a href="video.html#the-source-element">source</a></code></dd>
277:
278: <dt>CDATA elements</dt>
279:
280: <dd><code><a href="semantics.html#script">script</a></code>, <code><a href="semantics.html#the-style-element">style</a></code></dd> <!-- iframe and
281: noscript don't count as CDATA for syntax purposes -->
282:
283: <dt>RCDATA elements</dt>
284:
285: <dd><code><a href="forms.html#the-textarea-element">textarea</a></code>, <code><a href="semantics.html#the-title-element">title</a></code></dd>
286:
287: <dt>Foreign elements</dt>
288:
289: <dd>Elements from the <a href="#mathml-namespace">MathML namespace</a>
290: and the <a href="#svg-namespace">SVG namespace</a>.</dd>
291:
292: <dt>Normal elements</dt>
293:
294: <dd>All other allowed <a href="infrastructure.html#html-elements">HTML elements</a> are normal
295: elements.</dd>
296:
297: </dl><p><dfn id="syntax-tags" title="syntax-tags">Tags</dfn> are used to delimit the start
298: and end of elements in the markup. CDATA, RCDATA, and normal
299: elements have a <a href="#syntax-start-tag" title="syntax-start-tag">start tag</a> to
300: indicate where they begin, and an <a href="#syntax-end-tag" title="syntax-end-tag">end
301: tag</a> to indicate where they end. The start and end tags of
302: certain normal elements can be <a href="#syntax-tag-omission" title="syntax-tag-omission">omitted</a>, as described
303: later. Those that cannot be omitted must not be omitted. <a href="#void-elements">Void
304: elements</a> only have a start tag; end tags must not be
305: specified for void elements. Foreign elements must either have a
306: start tag and an end tag, or a start tag that is marked as
307: self-closing, in which case they must not have an end tag.</p><p>The contents of the element must be placed between just after the
308: start tag (which <a href="#syntax-tag-omission" title="syntax-tag-omission">might be implied,
309: in certain cases</a>) and just before the end tag (which again,
310: <a href="#syntax-tag-omission" title="syntax-tag-omission">might be implied in certain
311: cases</a>). The exact allowed contents of each individual element
312: depends on the content model of that element, as described earlier
313: in this specification. Elements must not contain content that their
314: content model disallows. In addition to the restrictions placed on
315: the contents by those content models, however, the five types of
316: elements have additional <em>syntactic</em> requirements.</p><p><a href="#void-elements">Void elements</a> can't have any contents (since there's
317: no end tag, no content can be put between the start tag and the end
318: tag).</p><p>CDATA elements can have <a href="#syntax-text" title="syntax-text">text</a>,
319: though it has <a href="#cdata-rcdata-restrictions">restrictions</a>
320: described below.</p><p>RCDATA elements can have <a href="#syntax-text" title="syntax-text">text</a>
321: and <a href="#syntax-charref" title="syntax-charref">character references</a>, but
322: the text must not contain an <a href="#syntax-ambiguous-ampersand" title="syntax-ambiguous-ampersand">ambiguous ampersand</a>.
323: There are also <a href="#cdata-rcdata-restrictions">further
324: restrictions</a> described below.</p><p>Foreign elements whose start tag is marked as self-closing can't
325: have any contents (since, again, as there's no end tag, no content
326: can be put between the start tag and the end tag). Foreign elements
327: whose start tag is <em>not</em> marked as self-closing can have
328: <a href="#syntax-text" title="syntax-text">text</a>, <a href="#syntax-charref" title="syntax-charref">character references</a>, <a href="#syntax-cdata" title="syntax-cdata">CDATA sections</a>, other <a href="#syntax-elements" title="syntax-elements">elements</a>, and <a href="#syntax-comments" title="syntax-comments">comments</a>, but the text must not
329: contain the character U+003C LESS-THAN SIGN (<code><</code>) or
330: an <a href="#syntax-ambiguous-ampersand" title="syntax-ambiguous-ampersand">ambiguous
331: ampersand</a>.</p><p>Normal elements can have <a href="#syntax-text" title="syntax-text">text</a>,
332: <a href="#syntax-charref" title="syntax-charref">character references</a>, other
333: <a href="#syntax-elements" title="syntax-elements">elements</a>, and <a href="#syntax-comments" title="syntax-comments">comments</a>, but the text must not
334: contain the character U+003C LESS-THAN SIGN (<code><</code>) or
335: an <a href="#syntax-ambiguous-ampersand" title="syntax-ambiguous-ampersand">ambiguous
336: ampersand</a>. Some normal elements also have <a href="#element-restrictions">yet more restrictions</a> on what
337: content they are allowed to hold, beyond the restrictions imposed by
338: the content model and those described in this paragraph. Those
339: restrictions are described below.</p><p>Tags contain a <dfn id="syntax-tag-name" title="syntax-tag-name">tag name</dfn>,
340: giving the element's name. HTML elements all have names that only
341: use characters in the range U+0030 DIGIT ZERO .. U+0039 DIGIT NINE,
342: U+0061 LATIN SMALL LETTER A .. U+007A LATIN SMALL LETTER Z, U+0041
343: LATIN CAPITAL LETTER A .. U+005A LATIN CAPITAL LETTER Z, and U+002D
344: HYPHEN-MINUS (<code>-</code>). In the HTML syntax, tag names may be
345: written with any mix of lower- and uppercase letters that, when
346: converted to all-lowercase, matches the element's tag name; tag
347: names are case-insensitive.</p><h5 id="start-tags"><span class="secno">9.1.2.1 </span>Start tags</h5><p><dfn id="syntax-start-tag" title="syntax-start-tag">Start tags</dfn> must have the
348: following format:</p><ol><li>The first character of a start tag must be a U+003C LESS-THAN
349: SIGN (<code><</code>).</li>
350:
351: <li>The next few characters of a start tag must be the element's
352: <a href="#syntax-tag-name" title="syntax-tag-name">tag name</a>.</li>
353:
354: <li>If there are to be any attributes in the next step, there must
355: first be one or more <a href="infrastructure.html#space-character" title="space character">space
356: characters</a>.</li>
357:
358: <li>Then, the start tag may have a number of attributes, the <a href="#syntax-attributes" title="syntax-attributes">syntax for which</a> is described
359: below. Attributes may be separated from each other by one or more
360: <a href="infrastructure.html#space-character" title="space character">space characters</a>.</li>
361:
362: <li>After the attributes, there may be one or more <a href="infrastructure.html#space-character" title="space character">space characters</a>. (Some attributes
363: are required to be followed by a space. See the <a href="#syntax-attributes" title="syntax-attributes">attributes section</a> below.)</li>
364:
365: <li>Then, if the element is one of the <a href="#void-elements">void elements</a>,
366: or if the element is a foreign element, then there may be a single
367: U+002F SOLIDUS (<code>/</code>) character. This character has no
368: effect on void elements, but on foreign elements it marks the start
369: tag as self-closing.</li>
370:
371: <li>Finally, start tags must be closed by a U+003E GREATER-THAN
372: SIGN (<code>></code>) character.</li>
373:
374: </ol><h5 id="end-tags"><span class="secno">9.1.2.2 </span>End tags</h5><p><dfn id="syntax-end-tag" title="syntax-end-tag">End tags</dfn> must have the
375: following format:</p><ol><li>The first character of an end tag must be a U+003C LESS-THAN
376: SIGN (<code><</code>).</li>
377:
378: <li>The second character of an end tag must be a U+002F SOLIDUS
379: (<code>/</code>).</li>
380:
381: <li>The next few characters of an end tag must be the element's
382: <a href="#syntax-tag-name" title="syntax-tag-name">tag name</a>.</li>
383:
384: <li>After the tag name, there may be one or more <a href="infrastructure.html#space-character" title="space
385: character">space characters</a>.</li>
386:
387: <li>Finally, end tags must be closed by a U+003E GREATER-THAN
388: SIGN (<code>></code>) character.</li>
389:
390: </ol><h5 id="attributes"><span class="secno">9.1.2.3 </span>Attributes</h5><p><dfn id="syntax-attributes" title="syntax-attributes">Attributes</dfn> for an element
391: are expressed inside the element's start tag.</p><p>Attributes have a name and a value. <dfn id="syntax-attribute-name" title="syntax-attribute-name">Attribute names</dfn> must consist of
392: one or more characters other than the <a href="infrastructure.html#space-character" title="space
393: character">space characters</a>, U+0000 NULL, U+0022 QUOTATION
394: MARK ("), U+0027 APOSTROPHE ('), U+003E GREATER-THAN SIGN
395: (>), U+002F SOLIDUS (/), and U+003D EQUALS SIGN (=) characters,
396: the control characters, and any characters that are not defined by
397: Unicode. In the HTML syntax, attribute names may be written with any
398: mix of lower- and uppercase letters that are an <a href="infrastructure.html#ascii-case-insensitive">ASCII
399: case-insensitive</a> match for the attribute's name.</p><p><dfn id="syntax-attribute-value" title="syntax-attribute-value">Attribute values</dfn> are a
400: mixture of <a href="#syntax-text" title="syntax-text">text</a> and <a href="#syntax-charref" title="syntax-charref">character references</a>, except with the
401: additional restriction that the text cannot contain an <a href="#syntax-ambiguous-ampersand" title="syntax-ambiguous-ampersand">ambiguous ampersand</a>.</p><p>Attributes can be specified in four different ways:</p><dl><dt>Empty attribute syntax</dt>
402:
403: <dd>
404:
405: <p>Just the <a href="#syntax-attribute-name" title="syntax-attribute-name">attribute
406: name</a>.</p>
407:
408: <div class="example">
409:
410: <p>In the following example, the <code title="attr-fe-disabled"><a href="forms.html#attr-fe-disabled">disabled</a></code> attribute is given with
411: the empty attribute syntax:</p>
412:
413: <pre><input <em>disabled</em>></pre>
414:
415: </div>
416:
417: <p>If an attribute using the empty attribute syntax is to be
418: followed by another attribute, then there must be a <a href="infrastructure.html#space-character">space
419: character</a> separating the two.</p>
420:
421: </dd>
422:
1.2 mike 423: <dt id="unquoted">Unquoted attribute value syntax</dt>
1.1 mike 424:
425: <dd>
426:
427: <p>The <a href="#syntax-attribute-name" title="syntax-attribute-name">attribute name</a>,
428: followed by zero or more <a href="infrastructure.html#space-character" title="space character">space
429: characters</a>, followed by a single U+003D EQUALS SIGN
430: character, followed by zero or more <a href="infrastructure.html#space-character" title="space
431: character">space characters</a>, followed by the <a href="#syntax-attribute-value" title="syntax-attribute-value">attribute value</a>, which, in
432: addition to the requirements given above for attribute values,
433: must not contain any literal <a href="infrastructure.html#space-character" title="space character">space
434: characters</a>, any U+0022 QUOTATION MARK (<code>"</code>)
435: characters, U+0027 APOSTROPHE (<code>'</code>) characters,
436: U+003D EQUALS SIGN (<code>=</code>) characters, U+003C LESS-THAN
437: SIGN (<code><</code>) characters, or U+003E GREATER-THAN SIGN
438: (<code>></code>) characters, and must not be the empty
439: string.</p>
440:
441: <div class="example">
442:
443: <p>In the following example, the <code title="attr-input-value"><a href="forms.html#attr-input-value">value</a></code> attribute is given
444: with the unquoted attribute value syntax:</p>
445:
446: <pre><input <em>value=yes</em>></pre>
447:
448: </div>
449:
450: <p>If an attribute using the unquoted attribute syntax is to be
451: followed by another attribute or by one of the optional U+002F
452: SOLIDUS (<code>/</code>) characters allowed in step 6 of the <a href="#syntax-start-tag" title="syntax-start-tag">start tag</a> syntax above, then there
453: must be a <a href="infrastructure.html#space-character">space character</a> separating the two.</p>
454:
455: </dd>
456:
457: <dt>Single-quoted attribute value syntax</dt>
458:
459: <dd>
460:
461: <p>The <a href="#syntax-attribute-name" title="syntax-attribute-name">attribute name</a>,
462: followed by zero or more <a href="infrastructure.html#space-character" title="space character">space
463: characters</a>, followed by a single U+003D EQUALS SIGN
464: character, followed by zero or more <a href="infrastructure.html#space-character" title="space
465: character">space characters</a>, followed by a single U+0027
466: APOSTROPHE (<code>'</code>) character, followed by the <a href="#syntax-attribute-value" title="syntax-attribute-value">attribute value</a>, which, in
467: addition to the requirements given above for attribute values,
468: must not contain any literal U+0027 APOSTROPHE (<code>'</code>)
469: characters, and finally followed by a second single U+0027
470: APOSTROPHE (<code>'</code>) character.</p>
471:
472: <div class="example">
473:
474: <p>In the following example, the <code title="attr-input-type"><a href="forms.html#attr-input-type">type</a></code> attribute is given with the
475: single-quoted attribute value syntax:</p>
476:
477: <pre><input <em>type='checkbox'</em>></pre>
478:
479: </div>
480:
481: <p>If an attribute using the single-quoted attribute syntax is to
482: be followed by another attribute, then there must be a <a href="infrastructure.html#space-character">space
483: character</a> separating the two.</p>
484:
485: </dd>
486:
487: <dt>Double-quoted attribute value syntax</dt>
488:
489: <dd>
490:
491: <p>The <a href="#syntax-attribute-name" title="syntax-attribute-name">attribute name</a>,
492: followed by zero or more <a href="infrastructure.html#space-character" title="space character">space
493: characters</a>, followed by a single U+003D EQUALS SIGN
494: character, followed by zero or more <a href="infrastructure.html#space-character" title="space
495: character">space characters</a>, followed by a single U+0022
496: QUOTATION MARK (<code>"</code>) character, followed by the <a href="#syntax-attribute-value" title="syntax-attribute-value">attribute value</a>, which, in
497: addition to the requirements given above for attribute values,
498: must not contain any literal U+0022 QUOTATION MARK
499: (<code>"</code>) characters, and finally followed by a second
500: single U+0022 QUOTATION MARK (<code>"</code>) character.</p>
501:
502: <div class="example">
503:
504: <p>In the following example, the <code title="attr-fe-name"><a href="forms.html#attr-fe-name">name</a></code> attribute is given with the
505: double-quoted attribute value syntax:</p>
506:
507: <pre><input <em>name="be evil"</em>></pre>
508:
509: </div>
510:
511: <p>If an attribute using the double-quoted attribute syntax is to
512: be followed by another attribute, then there must be a <a href="infrastructure.html#space-character">space
513: character</a> separating the two.</p>
514:
515: </dd>
516:
517: </dl><p>There must never be two or more attributes on the same start tag
518: whose names are an <a href="infrastructure.html#ascii-case-insensitive">ASCII case-insensitive</a> match for
519: each other.</p><h5 id="optional-tags"><span class="secno">9.1.2.4 </span>Optional tags</h5><p>Certain tags can be <dfn id="syntax-tag-omission" title="syntax-tag-omission">omitted</dfn>.</p><p class="note">Omitting an element's <a href="#syntax-start-tag" title="syntax-start-tag">start tag</a> does not mean the element
520: is not present; it is implied, but it is still there. An HTML
521: document always has a root <code><a href="semantics.html#the-html-element">html</a></code> element, even if the
522: string <code title=""><html></code> doesn't appear anywhere in
523: the markup.</p><!-- <html> --><p>An <code><a href="semantics.html#the-html-element">html</a></code> element's <a href="#syntax-start-tag" title="syntax-start-tag">start tag</a> may be omitted if the
524: first thing inside the <code><a href="semantics.html#the-html-element">html</a></code> element is not a <a href="#syntax-comments" title="syntax-comments">comment</a>.</p><!-- </html> --><p>An <code><a href="semantics.html#the-html-element">html</a></code> element's <a href="#syntax-end-tag" title="syntax-end-tag">end
525: tag</a> may be omitted if the <code><a href="semantics.html#the-html-element">html</a></code> element is not
526: immediately followed by a <a href="#syntax-comments" title="syntax-comments">comment</a>.</p><!-- <head> --><p>A <code><a href="semantics.html#the-head-element">head</a></code> element's <a href="#syntax-start-tag" title="syntax-start-tag">start tag</a> may be omitted <!--if the
527: element is empty, or--> if the first thing inside the
528: <code><a href="semantics.html#the-head-element">head</a></code> element is an element.</p><!-- </head> --><p>A <code><a href="semantics.html#the-head-element">head</a></code> element's <a href="#syntax-end-tag" title="syntax-end-tag">end
529: tag</a> may be omitted if the <code><a href="semantics.html#the-head-element">head</a></code> element is not
530: immediately followed by a <a href="infrastructure.html#space-character">space character</a> or a <a href="#syntax-comments" title="syntax-comments">comment</a>.</p><!-- <body> --><p>A <code><a href="semantics.html#the-body-element">body</a></code> element's <a href="#syntax-start-tag" title="syntax-start-tag">start tag</a> may be omitted if the
531: element is empty, or if the first thing inside the <code><a href="semantics.html#the-body-element">body</a></code>
532: element is not a <a href="infrastructure.html#space-character">space character</a> or a <a href="#syntax-comments" title="syntax-comments">comment</a>, except if the first thing
533: inside the <code><a href="semantics.html#the-body-element">body</a></code> element is a <code><a href="semantics.html#script">script</a></code> or
534: <code><a href="semantics.html#the-style-element">style</a></code> element. <!-- Note that even if the </head> end
535: tag is present, the parser makes <style> and <script> elements
536: between </head> and <body> end up in the <head> instead of implying
537: the <body> --></p><!-- </body> --><p>A <code><a href="semantics.html#the-body-element">body</a></code> element's <a href="#syntax-end-tag" title="syntax-end-tag">end
538: tag</a> may be omitted if the <code><a href="semantics.html#the-body-element">body</a></code> element is not
539: immediately followed by a <a href="#syntax-comments" title="syntax-comments">comment</a>.</p><!-- </li> --><p>A <code><a href="semantics.html#the-li-element">li</a></code> element's <a href="#syntax-end-tag" title="syntax-end-tag">end
540: tag</a> may be omitted if the <code><a href="semantics.html#the-li-element">li</a></code> element is
541: immediately followed by another <code><a href="semantics.html#the-li-element">li</a></code> element or if there
542: is no more content in the parent element.</p><!-- </dt> --><p>A <code><a href="semantics.html#the-dt-element">dt</a></code> element's <a href="#syntax-end-tag" title="syntax-end-tag">end
543: tag</a> may be omitted if the <code><a href="semantics.html#the-dt-element">dt</a></code> element is
544: immediately followed by another <code><a href="semantics.html#the-dt-element">dt</a></code> element or a
545: <code><a href="semantics.html#the-dd-element">dd</a></code> element.</p><!-- </dd> --><p>A <code><a href="semantics.html#the-dd-element">dd</a></code> element's <a href="#syntax-end-tag" title="syntax-end-tag">end
546: tag</a> may be omitted if the <code><a href="semantics.html#the-dd-element">dd</a></code> element is
547: immediately followed by another <code><a href="semantics.html#the-dd-element">dd</a></code> element or a
548: <code><a href="semantics.html#the-dt-element">dt</a></code> element, or if there is no more content in the
549: parent element.</p><!-- </p> --><p>A <code><a href="semantics.html#the-p-element">p</a></code> element's <a href="#syntax-end-tag" title="syntax-end-tag">end
550: tag</a> may be omitted if the <code><a href="semantics.html#the-p-element">p</a></code> element is
551: immediately followed by an <code><a href="semantics.html#the-address-element">address</a></code>,
552: <code><a href="semantics.html#the-article-element">article</a></code>, <code><a href="semantics.html#the-aside-element">aside</a></code>, <code><a href="semantics.html#the-blockquote-element">blockquote</a></code>,
1.5 mike 553: <code><a href="interactive-elements.html#datagrid">datagrid</a></code>, <code><a href="semantics.html#the-dialog-element">dialog</a></code>, <code><a href="obsolete.html#dir">dir</a></code>,
1.1 mike 554: <code><a href="interactive-elements.html#the-div-element">div</a></code>, <code><a href="semantics.html#the-dl-element">dl</a></code>, <code><a href="forms.html#the-fieldset-element">fieldset</a></code>,
555: <code><a href="semantics.html#the-footer-element">footer</a></code>, <code><a href="forms.html#the-form-element">form</a></code>, <code><a href="semantics.html#the-h1-h2-h3-h4-h5-and-h6-elements">h1</a></code>,
556: <code><a href="semantics.html#the-h1-h2-h3-h4-h5-and-h6-elements">h2</a></code>, <code><a href="semantics.html#the-h1-h2-h3-h4-h5-and-h6-elements">h3</a></code>, <code><a href="semantics.html#the-h1-h2-h3-h4-h5-and-h6-elements">h4</a></code>, <code><a href="semantics.html#the-h1-h2-h3-h4-h5-and-h6-elements">h5</a></code>,
557: <code><a href="semantics.html#the-h1-h2-h3-h4-h5-and-h6-elements">h6</a></code>, <code><a href="semantics.html#the-header-element">header</a></code>, <code><a href="semantics.html#the-hgroup-element">hgroup</a></code>,
558: <code><a href="semantics.html#the-hr-element">hr</a></code>, <code><a href="interactive-elements.html#menus">menu</a></code>, <code><a href="semantics.html#the-nav-element">nav</a></code>,
559: <code><a href="semantics.html#the-ol-element">ol</a></code>, <code><a href="semantics.html#the-p-element">p</a></code>, <code><a href="semantics.html#the-pre-element">pre</a></code>,
560: <code><a href="semantics.html#the-section-element">section</a></code>, <code><a href="tabular-data.html#the-table-element">table</a></code>, or <code><a href="semantics.html#the-ul-element">ul</a></code>,
561: element, or if there is no more content in the parent element and
562: the parent element is not an <code><a href="text-level-semantics.html#the-a-element">a</a></code> element.</p><!-- </rt> --><p>An <code><a href="text-level-semantics.html#the-rt-element">rt</a></code> element's <a href="#syntax-end-tag" title="syntax-end-tag">end
563: tag</a> may be omitted if the <code><a href="text-level-semantics.html#the-rt-element">rt</a></code> element is
564: immediately followed by an <code><a href="text-level-semantics.html#the-rt-element">rt</a></code> or <code><a href="text-level-semantics.html#the-rp-element">rp</a></code>
565: element, or if there is no more content in the parent element.</p><!-- </rp> --><p>An <code><a href="text-level-semantics.html#the-rp-element">rp</a></code> element's <a href="#syntax-end-tag" title="syntax-end-tag">end
566: tag</a> may be omitted if the <code><a href="text-level-semantics.html#the-rp-element">rp</a></code> element is
567: immediately followed by an <code><a href="text-level-semantics.html#the-rt-element">rt</a></code> or <code><a href="text-level-semantics.html#the-rp-element">rp</a></code>
568: element, or if there is no more content in the parent element.</p><!-- </optgroup> (the text assumes <optgroup> can only be inside a
569: <select>; commented out text below can handle the non-<select> case
570: if we ever allow it) --><p>An <code><a href="forms.html#the-optgroup-element">optgroup</a></code> element's <a href="#syntax-end-tag" title="syntax-end-tag">end tag</a> may be omitted if the
571: <code><a href="forms.html#the-optgroup-element">optgroup</a></code> element <!--has an ancestor
572: <code>select</code> element and--> is immediately followed by
573: another <code><a href="forms.html#the-optgroup-element">optgroup</a></code> element, or if <!--all of the elements
574: that are ancestors of the <code>optgroup</code> element, up to and
575: including the first ancestor element that is not an
576: <code>optgroup</code> element, have no more content--> there is no
577: more content in the parent element.</p><!-- so e.g. the max number of </optgroup>s are omitted here:
578: <select><optgroup></select>
579: <p id=x><optgroup></optgroup>x</p>
580: <p id=x><optgroup><optgroup></optgroup></optgroup>x</p>
581: <p><optgroup id=x><optgroup></optgroup>x</p>
582: <p><optgroup><optgroup id=x>x</p>
583: --><!-- </option> --><p>An <code><a href="forms.html#the-option-element">option</a></code> element's <a href="#syntax-end-tag" title="syntax-end-tag">end
584: tag</a> may be omitted if the <code><a href="forms.html#the-option-element">option</a></code> element is
585: immediately followed by another <code><a href="forms.html#the-option-element">option</a></code> element, or if
586: it is immediately followed by an <code><a href="forms.html#the-optgroup-element">optgroup</a></code> element, or
587: if there is no more content in the parent element.</p><!-- <colgroup> --><p>A <code><a href="tabular-data.html#the-colgroup-element">colgroup</a></code> element's <a href="#syntax-start-tag" title="syntax-start-tag">start tag</a> may be omitted if the
588: first thing inside the <code><a href="tabular-data.html#the-colgroup-element">colgroup</a></code> element is a
589: <code><a href="tabular-data.html#the-col-element">col</a></code> element, and if the element is not immediately
590: preceded by another <code><a href="tabular-data.html#the-colgroup-element">colgroup</a></code> element whose <a href="#syntax-end-tag" title="syntax-end-tag">end tag</a> has been omitted. (It can't be
591: omitted if the element is empty.)</p><!-- </colgroup> --><p>A <code><a href="tabular-data.html#the-colgroup-element">colgroup</a></code> element's <a href="#syntax-end-tag" title="syntax-end-tag">end tag</a> may be omitted if the
592: <code><a href="tabular-data.html#the-colgroup-element">colgroup</a></code> element is not immediately followed by a
593: <a href="infrastructure.html#space-character">space character</a> or a <a href="#syntax-comments" title="syntax-comments">comment</a>.</p><!-- </thead> --><p>A <code><a href="tabular-data.html#the-thead-element">thead</a></code> element's <a href="#syntax-end-tag" title="syntax-end-tag">end
594: tag</a> may be omitted if the <code><a href="tabular-data.html#the-thead-element">thead</a></code> element is
595: immediately followed by a <code><a href="tabular-data.html#the-tbody-element">tbody</a></code> or <code><a href="tabular-data.html#the-tfoot-element">tfoot</a></code>
596: element.</p><!-- <tbody> --><p>A <code><a href="tabular-data.html#the-tbody-element">tbody</a></code> element's <a href="#syntax-start-tag" title="syntax-start-tag">start tag</a> may be omitted if the
597: first thing inside the <code><a href="tabular-data.html#the-tbody-element">tbody</a></code> element is a
598: <code><a href="tabular-data.html#the-tr-element">tr</a></code> element, and if the element is not immediately
599: preceded by a <code><a href="tabular-data.html#the-tbody-element">tbody</a></code>, <code><a href="tabular-data.html#the-thead-element">thead</a></code>, or
600: <code><a href="tabular-data.html#the-tfoot-element">tfoot</a></code> element whose <a href="#syntax-end-tag" title="syntax-end-tag">end
601: tag</a> has been omitted. (It can't be omitted if the element is
602: empty.)</p><!-- </tbody> --><p>A <code><a href="tabular-data.html#the-tbody-element">tbody</a></code> element's <a href="#syntax-end-tag" title="syntax-end-tag">end
603: tag</a> may be omitted if the <code><a href="tabular-data.html#the-tbody-element">tbody</a></code> element is
604: immediately followed by a <code><a href="tabular-data.html#the-tbody-element">tbody</a></code> or <code><a href="tabular-data.html#the-tfoot-element">tfoot</a></code>
605: element, or if there is no more content in the parent element.</p><!-- </tfoot> --><p>A <code><a href="tabular-data.html#the-tfoot-element">tfoot</a></code> element's <a href="#syntax-end-tag" title="syntax-end-tag">end
606: tag</a> may be omitted if the <code><a href="tabular-data.html#the-tfoot-element">tfoot</a></code> element is
607: immediately followed by a <code><a href="tabular-data.html#the-tbody-element">tbody</a></code> element, or if there is
608: no more content in the parent element.</p><!-- </tr> --><p>A <code><a href="tabular-data.html#the-tr-element">tr</a></code> element's <a href="#syntax-end-tag" title="syntax-end-tag">end
609: tag</a> may be omitted if the <code><a href="tabular-data.html#the-tr-element">tr</a></code> element is
610: immediately followed by another <code><a href="tabular-data.html#the-tr-element">tr</a></code> element, or if there
611: is no more content in the parent element.</p><!-- </td> --><p>A <code><a href="tabular-data.html#the-td-element">td</a></code> element's <a href="#syntax-end-tag" title="syntax-end-tag">end
612: tag</a> may be omitted if the <code><a href="tabular-data.html#the-td-element">td</a></code> element is
613: immediately followed by a <code><a href="tabular-data.html#the-td-element">td</a></code> or <code><a href="tabular-data.html#the-th-element">th</a></code>
614: element, or if there is no more content in the parent element.</p><!-- </th> --><p>A <code><a href="tabular-data.html#the-th-element">th</a></code> element's <a href="#syntax-end-tag" title="syntax-end-tag">end
615: tag</a> may be omitted if the <code><a href="tabular-data.html#the-th-element">th</a></code> element is
616: immediately followed by a <code><a href="tabular-data.html#the-td-element">td</a></code> or <code><a href="tabular-data.html#the-th-element">th</a></code>
617: element, or if there is no more content in the parent element.</p><p><strong>However</strong>, a <a href="#syntax-start-tag" title="syntax-start-tag">start
618: tag</a> must never be omitted if it has any attributes.</p><h5 id="element-restrictions"><span class="secno">9.1.2.5 </span>Restrictions on content models</h5><p>For historical reasons, certain elements have extra restrictions
619: beyond even the restrictions given by their content model.</p><p>A <code><a href="tabular-data.html#the-table-element">table</a></code> element must not contain <code><a href="tabular-data.html#the-tr-element">tr</a></code>
620: elements, even though these elements are technically allowed inside
621: <code><a href="tabular-data.html#the-table-element">table</a></code> elements according to the content models
622: described in this specification. (If a <code><a href="tabular-data.html#the-tr-element">tr</a></code> element is
623: put inside a <code><a href="tabular-data.html#the-table-element">table</a></code> in the markup, it will in fact imply
624: a <code><a href="tabular-data.html#the-tbody-element">tbody</a></code> start tag before it.)</p><p>A single U+000A LINE FEED (LF) character may be placed
625: immediately after the <a href="#syntax-start-tag" title="syntax-start-tag">start
626: tag</a> of <code><a href="semantics.html#the-pre-element">pre</a></code> and <code><a href="forms.html#the-textarea-element">textarea</a></code>
627: elements. This does not affect the processing of the element. The
628: otherwise optional U+000A LINE FEED (LF) character <em>must</em> be
629: included if the element's contents start with that character
630: (because otherwise the leading newline in the contents would be
631: treated like the optional newline, and ignored).</p><div class="example">
632: <p>The following two <code><a href="semantics.html#the-pre-element">pre</a></code> blocks are equivalent:</p>
633: <pre><pre>Hello</pre></pre>
634: <pre><pre><br>Hello</pre></pre>
635: </div><h5 id="cdata-rcdata-restrictions"><span class="secno">9.1.2.6 </span>Restrictions on the contents of CDATA and RCDATA elements</h5><p>The text in CDATA and RCDATA elements must not contain any
636: occurrences of the string "<code title=""></</code>" (U+003C
637: LESS-THAN SIGN, U+002F SOLIDUS) followed by characters that
638: case-insensitively match the tag name of the element followed by one
639: of U+0009 CHARACTER TABULATION, U+000A LINE FEED (LF), U+000C FORM
640: FEED (FF), U+0020 SPACE, U+003E GREATER-THAN SIGN (>), or U+002F
641: SOLIDUS (/), unless that string is part of an <a href="#syntax-escape" title="syntax-escape">escaping text span</a>.</p><p>An <dfn id="syntax-escape" title="syntax-escape">escaping text span</dfn> is a span
642: of <a href="#syntax-text" title="syntax-text">text</a> that starts with an <a href="#syntax-escape-start" title="syntax-escape-start">escaping text span start</a> that is
643: not itself in an <a href="#syntax-escape" title="syntax-escape">escaping text
644: span</a>, and ends at the next <a href="#syntax-escape-end" title="syntax-escape-end">escaping text span end</a>. There
645: cannot be any <a href="#syntax-charref" title="syntax-charref">character
646: references</a> inside an <a href="#syntax-escape" title="syntax-escape">escaping
647: text span</a> — sequences of characters that would look
648: like <a href="#syntax-charref" title="syntax-charref">character references</a> do not
649: have special meaning.</p><p>An <dfn id="syntax-escape-start" title="syntax-escape-start">escaping text span
650: start</dfn> is a part of <a href="#syntax-text" title="syntax-text">text</a> that
651: consists of the four character sequence "<code title=""><!--</code>" (U+003C LESS-THAN SIGN, U+0021 EXCLAMATION
652: MARK, U+002D HYPHEN-MINUS, U+002D HYPHEN-MINUS).</p><p>An <dfn id="syntax-escape-end" title="syntax-escape-end">escaping text span end</dfn> is
653: a part of <a href="#syntax-text" title="syntax-text">text</a> that consists of the
654: three character sequence "<code title="">--></code>" (U+002D
655: HYPHEN-MINUS, U+002D HYPHEN-MINUS, U+003E GREATER-THAN SIGN) whose
656: U+003E GREATER-THAN SIGN (>).</p><p>An <a href="#syntax-escape-start" title="syntax-escape-start">escaping text span
657: start</a> may share its U+002D HYPHEN-MINUS characters with its
658: corresponding <a href="#syntax-escape-end" title="syntax-escape-end">escaping text span
659: end</a>.</p><p>The text in CDATA and RCDATA elements must not have an <a href="#syntax-escape-start" title="syntax-escape-start">escaping text span start</a> that is
660: not followed by an <a href="#syntax-escape-end" title="syntax-escape-end">escaping text
661: span end</a>.</p><h4 id="text-0"><span class="secno">9.1.3 </span>Text</h4><p><dfn id="syntax-text" title="syntax-text">Text</dfn> is allowed inside elements,
662: attributes, and comments. Text must consist of Unicode characters.
663: Text must not contain U+0000 characters. Text must not contain
664: permanently undefined Unicode characters. Text must not contain
665: control characters other than <a href="infrastructure.html#space-character" title="space character">space
666: characters</a>. Extra constraints are placed on what is and what
667: is not allowed in text based on where the text is to be put, as
668: described in the other sections.</p><h5 id="newlines"><span class="secno">9.1.3.1 </span>Newlines</h5><p><dfn id="syntax-newlines" title="syntax-newlines">Newlines</dfn> in HTML may be
669: represented either as U+000D CARRIAGE RETURN (CR) characters, U+000A
670: LINE FEED (LF) characters, or pairs of U+000D CARRIAGE RETURN (CR),
671: U+000A LINE FEED (LF) characters in that order.</p><h4 id="character-references"><span class="secno">9.1.4 </span>Character references</h4><p>In certain cases described in other sections, <a href="#syntax-text" title="syntax-text">text</a> may be mixed with <dfn id="syntax-charref" title="syntax-charref">character references</dfn>. These can be used
672: to escape characters that couldn't otherwise legally be included in
673: <a href="#syntax-text" title="syntax-text">text</a>.</p><p>Character references must start with a U+0026 AMPERSAND
674: (<code>&</code>). Following this, there are three possible kinds
675: of character references:</p><dl><dt>Named character references</dt>
676:
677: <dd>The ampersand must be followed by one of the names given in the
678: <a href="named-character-references.html#named-character-references">named character references</a> section, using the same
679: case. The name must be one that is terminated by a U+003B SEMICOLON
680: (<code title="">;</code>) character.</dd>
681:
682:
683: <dt>Decimal numeric character reference</dt>
684:
685: <dd>The ampersand must be followed by a U+0023 NUMBER SIGN
686: (<code>#</code>) character, followed by one or more digits in the
687: range U+0030 DIGIT ZERO .. U+0039 DIGIT NINE, representing a
688: base-ten integer that itself is a Unicode code point that is
689: not U+0000, U+000D, in the range U+0080 .. U+009F, or in the range
690: 0xD800 .. 0xDFFF (surrogates). The digits must then be followed by
691: a U+003B SEMICOLON character (<code title="">;</code>).</dd>
692:
693:
694: <dt>Hexadecimal numeric character reference</dt>
695:
696: <dd>The ampersand must be followed by a U+0023 NUMBER SIGN
697: (<code>#</code>) character, which must be followed by either a
698: U+0078 LATIN SMALL LETTER X or a U+0058 LATIN CAPITAL LETTER X
699: character, which must then be followed by one or more digits in the
700: range U+0030 DIGIT ZERO .. U+0039 DIGIT NINE, U+0061 LATIN SMALL
701: LETTER A .. U+0066 LATIN SMALL LETTER F, and U+0041 LATIN CAPITAL
702: LETTER A .. U+0046 LATIN CAPITAL LETTER F, representing a
703: base-sixteen integer that itself is a Unicode code point that is
704: not U+0000, U+000D, in the range U+0080 .. U+009F, or in the range
705: 0xD800 .. 0xDFFF (surrogates). The digits must then be followed by
706: a U+003B SEMICOLON character (<code title="">;</code>).</dd>
707:
708: </dl><p>An <dfn id="syntax-ambiguous-ampersand" title="syntax-ambiguous-ampersand">ambiguous
709: ampersand</dfn> is a U+0026 AMPERSAND (<code>&</code>) character
710: that is followed by some <a href="#syntax-text" title="syntax-text">text</a> other
711: than a <a href="infrastructure.html#space-character">space character</a>, a U+003C LESS-THAN SIGN
712: character ('<'), or another U+0026 AMPERSAND (<code>&</code>)
713: character.</p><h4 id="cdata-sections"><span class="secno">9.1.5 </span>CDATA sections</h4><p><dfn id="syntax-cdata" title="syntax-cdata">CDATA sections</dfn> must start with
714: the character sequence U+003C LESS-THAN SIGN, U+0021 EXCLAMATION
715: MARK, U+005B LEFT SQUARE BRACKET, U+0043 LATIN CAPITAL LETTER C,
716: U+0044 LATIN CAPITAL LETTER D, U+0041 LATIN CAPITAL LETTER A, U+0054
717: LATIN CAPITAL LETTER T, U+0041 LATIN CAPITAL LETTER A, U+005B LEFT
718: SQUARE BRACKET (<code title=""><![CDATA[</code>). Following this
719: sequence, the CDATA section may have <a href="#syntax-text" title="syntax-text">text</a>, with the additional restriction
720: that the text must not contain the three character sequence U+005D
721: RIGHT SQUARE BRACKET, U+005D RIGHT SQUARE BRACKET, U+003E
722: GREATER-THAN SIGN (<code title="">]]></code>). Finally, the CDATA
723: section must be ended by the three character sequence U+005D RIGHT
724: SQUARE BRACKET, U+005D RIGHT SQUARE BRACKET, U+003E GREATER-THAN
725: SIGN (<code title="">]]></code>).</p><h4 id="comments"><span class="secno">9.1.6 </span>Comments</h4><p><dfn id="syntax-comments" title="syntax-comments">Comments</dfn> must start with the
726: four character sequence U+003C LESS-THAN SIGN, U+0021 EXCLAMATION
727: MARK, U+002D HYPHEN-MINUS, U+002D HYPHEN-MINUS (<code title=""><!--</code>). Following this sequence, the comment may
728: have <a href="#syntax-text" title="syntax-text">text</a>, with the additional
729: restriction that the text must not start with a single U+003E
730: GREATER-THAN SIGN ('>') character, nor start with a U+002D
731: HYPHEN-MINUS (<code title="">-</code>) character followed by a
732: U+003E GREATER-THAN SIGN ('>') character, nor contain two
733: consecutive U+002D HYPHEN-MINUS (<code title="">-</code>)
734: characters, nor end with a U+002D HYPHEN-MINUS (<code title="">-</code>) character. Finally, the comment must be ended by
735: the three character sequence U+002D HYPHEN-MINUS, U+002D
736: HYPHEN-MINUS, U+003E GREATER-THAN SIGN (<code title="">--></code>).</p><div class="impl">
737:
738: <h3 id="parsing"><span class="secno">9.2 </span>Parsing HTML documents</h3>
739:
740: <p><i>This section only applies to user agents, data mining tools,
741: and conformance checkers.</i></p>
742:
743: <p class="note">The rules for parsing XML documents into DOM trees
744: are covered by the next section, entitled "<a href="the-xhtml-syntax.html#the-xhtml-syntax">The XHTML
745: syntax</a>".</p>
746:
747: <p>For <a href="dom.html#html-documents">HTML documents</a>, user agents must use the parsing
748: rules described in this section to generate the DOM trees. Together,
749: these rules define what is referred to as the <dfn id="html-parser">HTML
750: parser</dfn>.</p>
751:
752: <div class="note">
753:
754: <p>While the HTML syntax described in this specification bears a
755: close resemblance to SGML and XML, it is a separate language with
756: its own parsing rules.</p>
757:
758: <p>Some earlier versions of HTML (in particular from HTML 2 to
759: HTML 4) were based on SGML and used SGML parsing rules. However, few
760: (if any) web browsers ever implemented true SGML parsing for HTML
761: documents; the only user agents to strictly handle HTML as an SGML
762: application have historically been validators. The resulting
763: confusion — with validators claiming documents to have one
764: representation while widely deployed Web browsers interoperably
765: implemented a different representation — has wasted decades
766: of productivity. This version of HTML thus returns to a non-SGML
767: basis.</p>
768:
769: <p>Authors interested in using SGML tools in their authoring
770: pipeline are encouraged to use XML tools and the XML serialization
771: of HTML.</p>
772:
773: </div>
774:
775: <p>This specification defines the parsing rules for HTML documents,
776: whether they are syntactically correct or not. Certain points in the
777: parsing algorithm are said to be <dfn id="parse-error" title="parse error">parse
778: errors</dfn>. The error handling for parse errors is well-defined:
779: user agents must either act as described below when encountering
780: such problems, or must abort processing at the first error that they
781: encounter for which they do not wish to apply the rules described
782: below.</p>
783:
784: <p>Conformance checkers must report at least one parse error
785: condition to the user if one or more parse error conditions exist in
786: the document and must not report parse error conditions if none
787: exist in the document. Conformance checkers may report more than one
788: parse error condition if more than one parse error conditions exist
789: in the document. Conformance checkers are not required to recover
790: from parse errors.</p>
791:
792: <p class="note">Parse errors are only errors with the
793: <em>syntax</em> of HTML. In addition to checking for parse errors,
794: conformance checkers will also verify that the document obeys all
795: the other conformance requirements described in this
796: specification.</p>
797:
798: <p>For the purposes of conformance checkers, if a resource is
799: determined to be in <a href="#syntax">the HTML syntax</a>, then it is an
800: <a href="dom.html#html-documents" title="HTML documents">HTML document</a>.</p>
801:
802:
803: <h4 id="overview-of-the-parsing-model"><span class="secno">9.2.1 </span>Overview of the parsing model</h4>
804:
805: <p>The input to the HTML parsing process consists of a stream of
806: Unicode characters, which is passed through a
807: <a href="#tokenization">tokenization</a> stage followed by a <a href="#tree-construction">tree
808: construction</a> stage. The output is a <code>Document</code>
809: object.</p>
810:
811: <p class="note">Implementations that <a href="infrastructure.html#non-scripted">do not
812: support scripting</a> do not have to actually create a DOM
813: <code>Document</code> object, but the DOM tree in such cases is
814: still used as the model for the rest of the specification.</p>
815:
816: <p>In the common case, the data handled by the tokenization stage
817: comes from the network, but <a href="dom.html#dynamic-markup-insertion" title="dynamic markup
818: insertion">it can also come from script</a>, e.g. using the <code title="dom-document-write"><a href="dom.html#dom-document-write">document.write()</a></code> API.</p>
819:
820: <p><img alt="" src="images/parsing-model-overview.png"></p>
821:
822: <p id="nestedParsing">There is only one set of states for the
823: tokenizer stage and the tree construction stage, but the tree
824: construction stage is reentrant, meaning that while the tree
825: construction stage is handling one token, the tokenizer might be
826: resumed, causing further tokens to be emitted and processed before
827: the first token's processing is complete.</p>
828:
829: <div class="example">
830:
831: <p>In the following example, the tree construction stage will be
832: called upon to handle a "p" start tag token while handling the
833: "script" start tag token:</p>
834:
835: <pre>...
836: <script>
837: document.write('<p>');
838: </script>
839: ...</pre>
840:
841: </div>
842:
843: <p>To handle these cases, parsers have a <dfn id="script-nesting-level">script nesting
844: level</dfn>, which must be initially set to zero, and a <dfn id="parser-pause-flag">parser
845: pause flag</dfn>, which must be initially set to false.</p>
846:
847:
848:
849: <h4 id="the-input-stream"><span class="secno">9.2.2 </span>The <dfn>input stream</dfn></h4>
850:
851: <p>The stream of Unicode characters that comprises the input to the
852: tokenization stage will be initially seen by the user agent as a
853: stream of bytes (typically coming over the network or from the local
854: file system). The bytes encode the actual characters according to a
855: particular <em>character encoding</em>, which the user agent must
856: use to decode the bytes into characters.</p>
857:
858: <p class="note">For XML documents, the algorithm user agents must
859: use to determine the character encoding is given by the XML
860: specification. This section does not apply to XML documents. <a href="references.html#references">[XML]</a></p>
861:
862:
863: <h5 id="determining-the-character-encoding"><span class="secno">9.2.2.1 </span>Determining the character encoding</h5>
864:
865: <p>In some cases, it might be impractical to unambiguously determine
866: the encoding before parsing the document. Because of this, this
867: specification provides for a two-pass mechanism with an optional
868: pre-scan. Implementations are allowed, as described below, to apply
869: a simplified parsing algorithm to whatever bytes they have available
870: before beginning to parse the document. Then, the real parser is
871: started, using a tentative encoding derived from this pre-parse and
872: other out-of-band metadata. If, while the document is being loaded,
873: the user agent discovers an encoding declaration that conflicts with
874: this information, then the parser can get reinvoked to perform a
875: parse of the document with the real encoding.</p>
876:
877: <p id="documentEncoding">User agents must use the following
878: algorithm (the <dfn id="encoding-sniffing-algorithm">encoding sniffing algorithm</dfn>) to determine
879: the character encoding to use when decoding a document in the first
880: pass. This algorithm takes as input any out-of-band metadata
881: available to the user agent (e.g. the <a href="infrastructure.html#content-type" title="Content-Type">Content-Type metadata</a> of the document)
882: and all the bytes available so far, and returns an encoding and a
883: <dfn id="concept-encoding-confidence" title="concept-encoding-confidence">confidence</dfn>. The
884: confidence is either <i>tentative</i>, <i>certain</i>, or
885: <i>irrelevant</i>. The encoding used, and whether the confidence in
886: that encoding is <i>tentative</i> or <i>certain</i>, is <a href="#meta-charset-during-parse">used during the parsing</a> to
887: determine whether to <a href="#change-the-encoding">change the encoding</a>. If no
888: encoding is necessary, e.g. because the parser is operating on a
889: stream of Unicode characters and doesn't have to use an encoding at
890: all, then the <a href="#concept-encoding-confidence" title="concept-encoding-confidence">confidence</a> is
891: <i>irrelevant</i>.</p>
892:
893: <ol><li><p>If the transport layer specifies an encoding, and it is
894: supported, return that encoding with the <a href="#concept-encoding-confidence" title="concept-encoding-confidence">confidence</a>
895: <i>certain</i>, and abort these steps.</p></li>
896:
897: <li><p>The user agent may wait for more bytes of the resource to be
898: available, either in this step or at any later step in this
899: algorithm. For instance, a user agent might wait 500ms or 512
900: bytes, whichever came first. In general preparsing the source to
901: find the encoding improves performance, as it reduces the need to
902: throw away the data structures used when parsing upon finding the
903: encoding information. However, if the user agent delays too long to
904: obtain data to determine the encoding, then the cost of the delay
905: could outweigh any performance improvements from the
906: preparse.</p></li>
907:
908: <li><p>For each of the rows in the following table, starting with
909: the first one and going down, if there are as many or more bytes
910: available than the number of bytes in the first column, and the
911: first bytes of the file match the bytes given in the first column,
912: then return the encoding given in the cell in the second column of
913: that row, with the <a href="#concept-encoding-confidence" title="concept-encoding-confidence">confidence</a>
914: <i>certain</i>, and abort these steps:</p>
915:
916: <!-- this table is present in several forms in this file; keep them in sync -->
917: <table><thead><tr><th>Bytes in Hexadecimal
918: </th><th>Encoding
919: </th></tr></thead><tbody><!-- nobody uses this
920: <tr>
921: <td>00 00 FE FF
922: <td>UTF-32BE
923: <tr>
924: <td>FF FE 00 00
925: <td>UTF-32LE
926: --><tr><td>FE FF
927: </td><td>UTF-16BE
928: </td></tr><tr><td>FF FE
929: </td><td>UTF-16LE
930: </td></tr><tr><td>EF BB BF
931: </td><td>UTF-8
932: <!-- nobody uses this
933: <tr>
934: <td>DD 73 66 73
935: <td>UTF-EBCDIC
936: -->
937: </td></tr></tbody></table><p class="note">This step looks for Unicode Byte Order Marks
938: (BOMs).</p></li>
939:
940: <li><p>Otherwise, the user agent will have to search for explicit
941: character encoding information in the file itself. This should
942: proceed as follows:
943:
944: </p><p>Let <var title="">position</var> be a pointer to a byte in the
945: input stream, initially pointing at the first byte. If at any
946: point during these substeps the user agent either runs out of
947: bytes or decides that scanning further bytes would not be
948: efficient, then skip to the next step of the overall character
949: encoding detection algorithm. User agents may decide that scanning
950: <em>any</em> bytes is not efficient, in which case these substeps
951: are entirely skipped.</p>
952:
953: <p>Now, repeat the following "two" steps until the algorithm
954: aborts (either because user agent aborts, as described above, or
955: because a character encoding is found):</p>
956:
957: <ol><li><p>If <var title="">position</var> points to:</p>
958:
959: <dl class="switch"><dt>A sequence of bytes starting with: 0x3C 0x21 0x2D 0x2D (ASCII '<!--')</dt>
960: <dd>
961:
962: <p>Advance the <var title="">position</var> pointer so that it
963: points at the first 0x3E byte which is preceded by two 0x2D
964: bytes (i.e. at the end of an ASCII '-->' sequence) and comes
965: after the 0x3C byte that was found. (The two 0x2D bytes can be
966: the same as the those in the '<!--' sequence.)</p>
967:
968: </dd>
969:
970: <dt>A sequence of bytes starting with: 0x3C, 0x4D or 0x6D, 0x45 or 0x65, 0x54 or 0x74, 0x41 or 0x61, and finally one of 0x09, 0x0A, 0x0C, 0x0D, 0x20, 0x2F (case-insensitive ASCII '<meta' followed by a space or slash)</dt>
971: <dd>
972:
973: <ol><li><p>Advance the <var title="">position</var> pointer so
974: that it points at the next 0x09, 0x0A, 0x0C, 0x0D, 0x20, or
975: 0x2F byte (the one in sequence of characters matched
976: above).</p></li>
977:
978: <li><p><a href="#concept-get-attributes-when-sniffing" title="concept-get-attributes-when-sniffing">Get
979: an attribute</a> and its value. If no attribute was
980: sniffed, then skip this inner set of steps, and jump to the
981: second step in the overall "two step" algorithm.</p></li>
982:
983: <li><p>If the attribute's name is neither "<code title="">charset</code>" nor "<code title="">content</code>",
984: then return to step 2 in these inner steps.</p></li>
985:
986: <li><p>If the attribute's name is "<code title="">charset</code>", let <var title="">charset</var> be
987: the attribute's value, interpreted as a character
988: encoding.</p></li>
989:
990: <li><p>Otherwise, the attribute's name is "<code title="">content</code>": apply the <a href="infrastructure.html#algorithm-for-extracting-an-encoding-from-a-content-type">algorithm for
991: extracting an encoding from a Content-Type</a>, giving the
992: attribute's value as the string to parse. If an encoding is
993: returned, let <var title="">charset</var> be that
994: encoding. Otherwise, return to step 2 in these inner
995: steps.</p></li>
996:
997: <li><p>If <var title="">charset</var> is a UTF-16 encoding,
998: change the value of <var title="">charset</var> to
999: UTF-8.</p></li>
1000:
1001: <li><p>If <var title="">charset</var> is a supported
1002: character encoding, then return the given encoding, with
1003: <a href="#concept-encoding-confidence" title="concept-encoding-confidence">confidence</a>
1004: <i>tentative</i>, and abort all these steps.</p></li>
1005:
1006: <li><p>Otherwise, return to step 2 in these inner
1007: steps.</p></li>
1008:
1009: </ol></dd>
1010:
1011: <dt>A sequence of bytes starting with a 0x3C byte (ASCII '<'), optionally a 0x2F byte (ASCII '/'), and finally a byte in the range 0x41-0x5A or 0x61-0x7A (an ASCII letter)</dt>
1012: <dd>
1013:
1014: <ol><li><p>Advance the <var title="">position</var> pointer so
1015: that it points at the next 0x09 (ASCII TAB), 0x0A (ASCII LF),
1016: 0x0C (ASCII FF), 0x0D (ASCII CR), 0x20 (ASCII space), or 0x3E
1017: (ASCII '>') byte.</p></li>
1018:
1019: <li><p>Repeatedly <a href="#concept-get-attributes-when-sniffing" title="concept-get-attributes-when-sniffing">get an
1020: attribute</a> until no further attributes can be found,
1021: then jump to the second step in the overall "two step"
1022: algorithm.</p></li>
1023:
1024: </ol></dd>
1025:
1026: <dt>A sequence of bytes starting with: 0x3C 0x21 (ASCII '<!')</dt>
1027: <dt>A sequence of bytes starting with: 0x3C 0x2F (ASCII '</')</dt>
1028: <dt>A sequence of bytes starting with: 0x3C 0x3F (ASCII '<?')</dt>
1029: <dd>
1030:
1031: <p>Advance the <var title="">position</var> pointer so that it
1032: points at the first 0x3E byte (ASCII '>') that comes after the
1033: 0x3C byte that was found.</p>
1034:
1035: </dd>
1036:
1037: <dt>Any other byte</dt>
1038: <dd>
1039:
1040: <p>Do nothing with that byte.</p>
1041:
1042: </dd>
1043:
1044: </dl></li>
1045:
1046: <li>Move <var title="">position</var> so it points at the next
1047: byte in the input stream, and return to the first step of this
1048: "two step" algorithm.</li>
1049:
1050: </ol><p>When the above "two step" algorithm says to <dfn id="concept-get-attributes-when-sniffing" title="concept-get-attributes-when-sniffing">get an
1051: attribute</dfn>, it means doing this:</p>
1052:
1053: <ol><li><p>If the byte at <var title="">position</var> is one of 0x09
1054: (ASCII TAB), 0x0A (ASCII LF), 0x0C (ASCII FF), 0x0D (ASCII CR),
1055: 0x20 (ASCII space), or 0x2F (ASCII '/') then advance <var title="">position</var> to the next byte and redo this
1056: substep.</p></li>
1057:
1058: <li><p>If the byte at <var title="">position</var> is 0x3E (ASCII
1059: '>'), then abort the "get an attribute" algorithm. There isn't
1060: one.</p></li>
1061:
1062: <li><p>Otherwise, the byte at <var title="">position</var> is the
1063: start of the attribute name. Let <var title="">attribute
1064: name</var> and <var title="">attribute value</var> be the empty
1065: string.</p></li>
1066:
1067: <li><p><i>Attribute name</i>: Process the byte at <var title="">position</var> as follows:</p>
1068:
1069: <dl class="switch"><dt>If it is 0x3D (ASCII '='), and the <var title="">attribute
1070: name</var> is longer than the empty string</dt>
1071:
1072: <dd>Advance <var title="">position</var> to the next byte and
1073: jump to the step below labeled <i>value</i>.</dd>
1074:
1075: <dt>If it is 0x09 (ASCII TAB), 0x0A (ASCII LF), 0x0C (ASCII
1076: FF), 0x0D (ASCII CR), or 0x20 (ASCII space)</dt>
1077:
1078: <dd>Jump to the step below labeled <i>spaces</i>.</dd>
1079:
1080: <dt>If it is 0x2F (ASCII '/') or 0x3E (ASCII '>')</dt>
1081:
1082: <dd>Abort the "get an attribute" algorithm. The attribute's
1083: name is the value of <var title="">attribute name</var>, its
1084: value is the empty string.</dd>
1085:
1086: <dt>If it is in the range 0x41 (ASCII 'A') to 0x5A (ASCII
1087: 'Z')</dt>
1088:
1089: <dd>Append the Unicode character with code point <span title=""><var title="">b</var>+0x20</span> to <var title="">attribute
1090: name</var> (where <var title="">b</var> is the value of the
1091: byte at <var title="">position</var>).</dd>
1092:
1093: <dt>Anything else</dt>
1094:
1095: <dd>Append the Unicode character with the same code point as the
1096: value of the byte at <var title="">position</var>) to <var title="">attribute name</var>. (It doesn't actually matter how
1097: bytes outside the ASCII range are handled here, since only
1098: ASCII characters can contribute to the detection of a character
1099: encoding.)</dd>
1100:
1101: </dl></li>
1102:
1103: <li><p>Advance <var title="">position</var> to the next byte and
1104: return to the previous step.</p></li>
1105:
1106: <li><p><i>Spaces</i>: If the byte at <var title="">position</var> is one of 0x09 (ASCII TAB), 0x0A (ASCII
1107: LF), 0x0C (ASCII FF), 0x0D (ASCII CR), or 0x20 (ASCII space) then
1108: advance <var title="">position</var> to the next byte, then,
1109: repeat this step.</p></li>
1110:
1111: <li><p>If the byte at <var title="">position</var> is
1112: <em>not</em> 0x3D (ASCII '='), abort the "get an attribute"
1113: algorithm. The attribute's name is the value of <var title="">attribute name</var>, its value is the empty
1114: string.</p></li>
1115:
1116: <li><p>Advance <var title="">position</var> past the 0x3D (ASCII
1117: '=') byte.</p></li>
1118:
1119: <li><p><i>Value:</i> If the byte at <var title="">position</var> is one of 0x09 (ASCII TAB), 0x0A (ASCII
1120: LF), 0x0C (ASCII FF), 0x0D (ASCII CR), or 0x20 (ASCII space) then
1121: advance <var title="">position</var> to the next byte, then,
1122: repeat this step.</p></li>
1123:
1124: <li><p>Process the byte at <var title="">position</var> as
1125: follows:</p>
1126:
1127: <dl class="switch"><dt>If it is 0x22 (ASCII '"') or 0x27 ("'")</dt>
1128:
1129: <dd>
1130:
1131: <ol><li>Let <var title="">b</var> be the value of the byte at
1132: <var title="">position</var>.</li>
1133:
1134: <li>Advance <var title="">position</var> to the next
1135: byte.</li>
1136:
1137: <li>If the value of the byte at <var title="">position</var>
1138: is the value of <var title="">b</var>, then advance <var title="">position</var> to the next byte and abort the "get
1139: an attribute" algorithm. The attribute's name is the value of
1140: <var title="">attribute name</var>, and its value is the
1141: value of <var title="">attribute value</var>.</li>
1142:
1143: <li>Otherwise, if the value of the byte at <var title="">position</var> is in the range 0x41 (ASCII 'A') to
1144: 0x5A (ASCII 'Z'), then append a Unicode character to <var title="">attribute value</var> whose code point is 0x20 more
1145: than the value of the byte at <var title="">position</var>.</li>
1146:
1147: <li>Otherwise, append a Unicode character to <var title="">attribute value</var> whose code point is the same as
1148: the value of the byte at <var title="">position</var>.</li>
1149:
1150: <li>Return to the second step in these substeps.</li>
1151:
1152: </ol></dd>
1153:
1154: <dt>If it is 0x3E (ASCII '>')</dt>
1155:
1156: <dd>Abort the "get an attribute" algorithm. The attribute's
1157: name is the value of <var title="">attribute name</var>, its
1158: value is the empty string.</dd>
1159:
1160:
1161: <dt>If it is in the range 0x41 (ASCII 'A') to 0x5A (ASCII
1162: 'Z')</dt>
1163:
1164: <dd>Append the Unicode character with code point <span title=""><var title="">b</var>+0x20</span> to <var title="">attribute
1165: value</var> (where <var title="">b</var> is the value of the
1166: byte at <var title="">position</var>). Advance <var title="">position</var> to the next byte.</dd>
1167:
1168: <dt>Anything else</dt>
1169:
1170: <dd>Append the Unicode character with the same code point as the
1171: value of the byte at <var title="">position</var>) to <var title="">attribute value</var>. Advance <var title="">position</var> to the next byte.</dd>
1172:
1173: </dl></li>
1174:
1175: <li><p>Process the byte at <var title="">position</var> as
1176: follows:</p>
1177:
1178: <dl class="switch"><dt>If it is 0x09 (ASCII TAB), 0x0A (ASCII LF), 0x0C (ASCII
1179: FF), 0x0D (ASCII CR), 0x20 (ASCII space), or 0x3E (ASCII
1180: '>')</dt>
1181:
1182: <dd>Abort the "get an attribute" algorithm. The attribute's
1183: name is the value of <var title="">attribute name</var> and its
1184: value is the value of <var title="">attribute value</var>.</dd>
1185:
1186: <dt>If it is in the range 0x41 (ASCII 'A') to 0x5A (ASCII
1187: 'Z')</dt>
1188:
1189: <dd>Append the Unicode character with code point <span title=""><var title="">b</var>+0x20</span> to <var title="">attribute
1190: value</var> (where <var title="">b</var> is the value of the
1191: byte at <var title="">position</var>).</dd>
1192:
1193: <dt>Anything else</dt>
1194:
1195: <dd>Append the Unicode character with the same code point as the
1196: value of the byte at <var title="">position</var>) to <var title="">attribute value</var>.</dd>
1197:
1198: </dl></li>
1199:
1200: <li><p>Advance <var title="">position</var> to the next byte and
1201: return to the previous step.</p></li>
1202:
1203: </ol><p>For the sake of interoperability, user agents should not use a
1204: pre-scan algorithm that returns different results than the one
1205: described above. (But, if you do, please at least let us know, so
1206: that we can improve this algorithm and benefit everyone...)</p>
1207:
1208: </li>
1209:
1210: <li><p>If the user agent has information on the likely encoding for
1211: this page, e.g. based on the encoding of the page when it was last
1212: visited, then return that encoding, with the <a href="#concept-encoding-confidence" title="concept-encoding-confidence">confidence</a>
1213: <i>tentative</i>, and abort these steps.</p></li>
1214:
1215: <li><p>The user agent may attempt to autodetect the character
1216: encoding from applying frequency analysis or other algorithms to
1217: the data stream. If autodetection succeeds in determining a
1218: character encoding, then return that encoding, with the <a href="#concept-encoding-confidence" title="concept-encoding-confidence">confidence</a>
1219: <i>tentative</i>, and abort these steps. <a href="references.html#references">[UNIVCHARDET]</a></p></li> <!--
1220: http://www.mozilla.org/projects/intl/UniversalCharsetDetection.html
1221: -->
1222:
1223: <li><p>Otherwise, return an implementation-defined or
1224: user-specified default character encoding, with the <a href="#concept-encoding-confidence" title="concept-encoding-confidence">confidence</a>
1225: <i>tentative</i>. In non-legacy environments, the more
1226: comprehensive <code title="">UTF-8</code> encoding is
1227: recommended. Due to its use in legacy content, <code title="">windows-1252</code> is recommended as a default in
1228: predominantly Western demographics instead. Since these encodings
1229: can in many cases be distinguished by inspection, a user agent may
1230: heuristically decide which to use as a default.</p></li>
1231:
1232: </ol><p>The <a href="dom.html#document-s-character-encoding">document's character encoding</a> must immediately
1233: be set to the value returned from this algorithm, at the same time
1234: as the user agent uses the returned value to select the decoder to
1235: use for the input stream.</p>
1236:
1237:
1238:
1239: <h5 id="preprocessing-the-input-stream"><span class="secno">9.2.2.2 </span>Preprocessing the input stream</h5>
1240:
1241: <p>Given an encoding, the bytes in the input stream must be
1242: converted to Unicode characters for the tokenizer, as described by
1243: the rules for that encoding, except that the leading U+FEFF BYTE
1244: ORDER MARK character, if any, must not be stripped by the encoding
1245: layer (it is stripped by the rule below).</p> <!-- this is to
1246: prevent two leading BOMs from being both stripped, once by the
1247: decoder, and once by the parser -->
1248:
1249: <p>Bytes or sequences of bytes in the original byte stream that
1250: could not be converted to Unicode characters must be converted to
1251: U+FFFD REPLACEMENT CHARACTER code points.</p>
1252:
1253: <p class="note">Bytes or sequences of bytes in the original byte
1254: stream that did not conform to the encoding specification
1255: (e.g. invalid UTF-8 byte sequences in a UTF-8 input stream) are
1256: errors that conformance checkers are expected to report.</p>
1257:
1258: <p>Any byte or sequences of bytes in the original byte stream that
1259: is <a href="infrastructure.html#misinterpreted-for-compatibility">misinterpreted for compatibility</a> is a <a href="#parse-error">parse
1260: error</a>.</p>
1261:
1262: <p>One leading U+FEFF BYTE ORDER MARK character must be ignored if
1263: any are present.</p>
1264:
1265: <p>All U+0000 NULL characters in the input must be replaced by
1266: U+FFFD REPLACEMENT CHARACTERs. Any occurrences of such characters is
1267: a <a href="#parse-error">parse error</a>.</p>
1268:
1269: <p>Any occurrences of any characters in the ranges U+0001 to U+0008,
1270: <!-- HT, LF allowed --> <!-- U+000B is in the next list --> <!-- FF,
1271: CR allowed --> U+000E to U+001F, <!-- ASCII allowed --> U+007F
1272: <!--to U+0084, (U+0085 NEL not allowed), U+0086--> to U+009F, U+D800
1273: to U+DFFF<!-- surrogates not allowed -->, U+FDD0 to U+FDEF, and
1274: characters U+000B, U+FFFE, U+FFFF, U+1FFFE, U+1FFFF, U+2FFFE,
1275: U+2FFFF, U+3FFFE, U+3FFFF, U+4FFFE, U+4FFFF, U+5FFFE, U+5FFFF,
1276: U+6FFFE, U+6FFFF, U+7FFFE, U+7FFFF, U+8FFFE, U+8FFFF, U+9FFFE,
1277: U+9FFFF, U+AFFFE, U+AFFFF, U+BFFFE, U+BFFFF, U+CFFFE, U+CFFFF,
1278: U+DFFFE, U+DFFFF, U+EFFFE, U+EFFFF, U+FFFFE, U+FFFFF, U+10FFFE, and
1279: U+10FFFF are <a href="#parse-error" title="parse error">parse errors</a>. (These
1280: are all control characters or permanently undefined Unicode
1281: characters.)</p>
1282:
1283: <p>U+000D CARRIAGE RETURN (CR) characters and U+000A LINE FEED (LF)
1284: characters are treated specially. Any CR characters that are
1285: followed by LF characters must be removed, and any CR characters not
1286: followed by LF characters must be converted to LF characters. Thus,
1287: newlines in HTML DOMs are represented by LF characters, and there
1288: are never any CR characters in the input to the
1289: <a href="#tokenization">tokenization</a> stage.</p>
1290:
1291: <p>The <dfn id="next-input-character">next input character</dfn> is the first character in the
1292: input stream that has not yet been <dfn id="consumed">consumed</dfn>. Initially,
1293: the <i><a href="#next-input-character">next input character</a></i> is the first character in the
1294: input. The <dfn id="current-input-character">current input character</dfn> is the last character
1295: to have been <i><a href="#consumed">consumed</a></i>.</p>
1296:
1297: <p>The <dfn id="insertion-point">insertion point</dfn> is the position (just before a
1298: character or just before the end of the input stream) where content
1299: inserted using <code title="dom-document-write"><a href="dom.html#dom-document-write">document.write()</a></code> is actually
1300: inserted. The insertion point is relative to the position of the
1301: character immediately after it, it is not an absolute offset into
1302: the input stream. Initially, the insertion point is
1303: uninitialized.</p>
1304:
1305: <p>The "EOF" character in the tables below is a conceptual character
1306: representing the end of the <a href="#the-input-stream">input stream</a>. If the parser
1307: is a <a href="dom.html#script-created-parser">script-created parser</a>, then the end of the
1308: <a href="#the-input-stream">input stream</a> is reached when an <dfn id="explicit-eof-character">explicit "EOF"
1309: character</dfn> (inserted by the <code title="dom-document-close"><a href="dom.html#dom-document-close">document.close()</a></code> method) is
1310: consumed. Otherwise, the "EOF" character is not a real character in
1311: the stream, but rather the lack of any further characters.</p>
1312:
1313:
1314: <h5 id="changing-the-encoding-while-parsing"><span class="secno">9.2.2.3 </span>Changing the encoding while parsing</h5>
1315:
1316: <p>When the parser requires the user agent to <dfn id="change-the-encoding">change the
1317: encoding</dfn>, it must run the following steps. This might happen
1318: if the <a href="#encoding-sniffing-algorithm">encoding sniffing algorithm</a> described above
1319: failed to find an encoding, or if it found an encoding that was not
1320: the actual encoding of the file.</p>
1321:
1322: <ol><li>If the new encoding is identical or equivalent to the encoding
1323: that is already being used to interpret the input stream, then set
1324: the <a href="#concept-encoding-confidence" title="concept-encoding-confidence">confidence</a> to
1325: <i>certain</i> and abort these steps. This happens when the
1326: encoding information found in the file matches what the
1327: <a href="#encoding-sniffing-algorithm">encoding sniffing algorithm</a> determined to be the
1328: encoding, and in the second pass through the parser if the first
1329: pass found that the encoding sniffing algorithm described in the
1330: earlier section failed to find the right encoding.</li>
1331:
1332: <li>If the encoding that is already being used to interpret the
1333: input stream is a UTF-16 encoding, then set the <a href="#concept-encoding-confidence" title="concept-encoding-confidence">confidence</a> to
1334: <i>certain</i> and abort these steps. The new encoding is ignored;
1335: if it was anything but the same encoding, then it would be clearly
1336: incorrect.</li>
1337:
1338: <li>If the new encoding is a UTF-16 encoding, change it to
1339: UTF-8.</li>
1340:
1341: <li>If all the bytes up to the last byte converted by the current
1342: decoder have the same Unicode interpretations in both the current
1343: encoding and the new encoding, and if the user agent supports
1344: changing the converter on the fly, then the user agent may change
1345: to the new converter for the encoding on the fly. Set the
1346: <a href="dom.html#document-s-character-encoding">document's character encoding</a> and the encoding used to
1347: convert the input stream to the new encoding, set the <a href="#concept-encoding-confidence" title="concept-encoding-confidence">confidence</a> to
1348: <i>certain</i>, and abort these steps.</li>
1349:
1350: <li>Otherwise, <a href="history.html#navigate">navigate</a> to the document again, with
1351: <a href="history.html#replacement-enabled">replacement enabled</a>, and using the same <a href="history.html#source-browsing-context">source
1352: browsing context</a>, but this time skip the <a href="#encoding-sniffing-algorithm">encoding
1353: sniffing algorithm</a> and instead just set the encoding to the
1354: new encoding and the <a href="#concept-encoding-confidence" title="concept-encoding-confidence">confidence</a> to
1355: <i>certain</i>. Whenever possible, this should be done without
1356: actually contacting the network layer (the bytes should be
1357: re-parsed from memory), even if, e.g., the document is marked as
1358: not being cacheable. If this is not possible and contacting the
1359: network layer would involve repeating a request that uses a method
1360: other than HTTP GET (<a href="infrastructure.html#concept-http-equivalent-get" title="concept-http-equivalent-get">or
1361: equivalent</a> for non-HTTP URLs), then instead set the <a href="#concept-encoding-confidence" title="concept-encoding-confidence">confidence</a> to
1362: <i>certain</i> and ignore the new encoding. The resource will be
1363: misinterpreted. User agents may notify the user of the situation,
1364: to aid in application development.</li>
1365:
1366: </ol><h4 id="parse-state"><span class="secno">9.2.3 </span>Parse state</h4>
1367:
1368: <h5 id="the-insertion-mode"><span class="secno">9.2.3.1 </span>The insertion mode</h5>
1369:
1370: <p>The <dfn id="insertion-mode">insertion mode</dfn> is a state variable that controls
1371: the primary operation of the tree construction stage.</p>
1372:
1373: <p>Initially, the <a href="#insertion-mode">insertion mode</a> is "<a href="#the-initial-insertion-mode" title="insertion mode: initial">initial</a>". It can change to
1374: "<a href="#the-before-html-insertion-mode" title="insertion mode: before html">before html</a>",
1375: "<a href="#the-before-head-insertion-mode" title="insertion mode: before head">before head</a>",
1376: "<a href="#parsing-main-inhead" title="insertion mode: in head">in head</a>", "<a href="#parsing-main-inheadnoscript" title="insertion mode: in head noscript">in head noscript</a>",
1377: "<a href="#the-after-head-insertion-mode" title="insertion mode: after head">after head</a>", "<a href="#parsing-main-inbody" title="insertion mode: in body">in body</a>", "<a href="#parsing-main-incdata" title="insertion mode: in CDATA/RCDATA">in CDATA/RCDATA</a>",
1378: "<a href="#parsing-main-intable" title="insertion mode: in table">in table</a>", "<a href="#parsing-main-intabletext" title="insertion mode: in table text">in table text</a>", "<a href="#parsing-main-incaption" title="insertion mode: in caption">in caption</a>", "<a href="#parsing-main-incolgroup" title="insertion mode: in column group">in column group</a>",
1379: "<a href="#parsing-main-intbody" title="insertion mode: in table body">in table body</a>",
1380: "<a href="#parsing-main-intr" title="insertion mode: in row">in row</a>", "<a href="#parsing-main-intd" title="insertion mode: in cell">in cell</a>", "<a href="#parsing-main-inselect" title="insertion mode: in select">in select</a>", "<a href="#parsing-main-inselectintable" title="insertion mode: in select in table">in select in
1381: table</a>", "<a href="#parsing-main-inforeign" title="insertion mode: in foreign content">in
1382: foreign content</a>", "<a href="#parsing-main-afterbody" title="insertion mode: after
1383: body">after body</a>", "<a href="#parsing-main-inframeset" title="insertion mode: in
1384: frameset">in frameset</a>", "<a href="#parsing-main-afterframeset" title="insertion mode: after
1385: frameset">after frameset</a>", "<a href="#the-after-after-body-insertion-mode" title="insertion mode:
1386: after after body">after after body</a>", and "<a href="#the-after-after-frameset-insertion-mode" title="insertion mode: after after frameset">after after
1387: frameset</a>" during the course of the parsing, as described in
1388: the <a href="#tree-construction">tree construction</a> stage. The insertion mode affects
1389: how tokens are processed and whether CDATA sections are
1390: supported.</p>
1391:
1392: <p>Seven of these modes, namely "<a href="#parsing-main-inhead" title="insertion mode: in
1393: head">in head</a>", "<a href="#parsing-main-inbody" title="insertion mode: in body">in
1394: body</a>", "<a href="#parsing-main-intable" title="insertion mode: in table">in
1395: table</a>", "<a href="#parsing-main-intbody" title="insertion mode: in table body">in table
1396: body</a>", "<a href="#parsing-main-intr" title="insertion mode: in row">in row</a>",
1397: "<a href="#parsing-main-intd" title="insertion mode: in cell">in cell</a>", and "<a href="#parsing-main-inselect" title="insertion mode: in select">in select</a>", are special, in
1398: that the other modes defer to them at various times. When the
1399: algorithm below says that the user agent is to do something
1400: "<dfn id="using-the-rules-for">using the rules for</dfn> the <var title="">m</var> insertion
1401: mode", where <var title="">m</var> is one of these modes, the user
1402: agent must use the rules described under the <var title="">m</var>
1403: <a href="#insertion-mode">insertion mode</a>'s section, but must leave the
1404: <a href="#insertion-mode">insertion mode</a> unchanged unless the rules in <var title="">m</var> themselves switch the <a href="#insertion-mode">insertion mode</a>
1405: to a new value.</p>
1406:
1407: <p>When the insertion mode is switched to "<a href="#parsing-main-incdata" title="insertion
1408: mode: in CDATA/RCDATA">in CDATA/RCDATA</a>" or "<a href="#parsing-main-intabletext" title="insertion mode: in table text">in table text</a>", the
1409: <dfn id="original-insertion-mode">original insertion mode</dfn> is also set. This is the
1410: insertion mode to which the tree construction stage will return.</p>
1411:
1412: <p>When the insertion mode is switched to "<a href="#parsing-main-inforeign" title="insertion
1413: mode: in foreign content">in foreign content</a>", the
1414: <dfn id="secondary-insertion-mode">secondary insertion mode</dfn> is also set. This secondary mode
1415: is used within the rules for the "<a href="#parsing-main-inforeign" title="insertion mode: in
1416: foreign content">in foreign content</a>" mode to handle HTML
1417: (i.e. not foreign) content.</p>
1418:
1419: <hr><p>When the steps below require the UA to <dfn id="reset-the-insertion-mode-appropriately">reset the insertion
1420: mode appropriately</dfn>, it means the UA must follow these
1421: steps:</p>
1422:
1423: <ol><li>Let <var title="">last</var> be false.</li>
1424:
1425: <li>Let <var title="">node</var> be the last node in the
1426: <a href="#stack-of-open-elements">stack of open elements</a>.</li>
1427:
1428: <li>If <var title="">node</var> is the first node in the stack of
1429: open elements, then set <var title="">last</var> to true and set
1430: <var title="">node</var> to the <var title="">context</var>
1431: element. (<a href="#fragment-case">fragment case</a>)</li>
1432:
1433: <li>If <var title="">node</var> is a <code><a href="forms.html#the-select-element">select</a></code> element,
1434: then switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-inselect" title="insertion mode: in select">in select</a>" and abort these
1435: steps. (<a href="#fragment-case">fragment case</a>)</li>
1436:
1437: <li>If <var title="">node</var> is a <code><a href="tabular-data.html#the-td-element">td</a></code> or
1438: <code><a href="tabular-data.html#the-th-element">th</a></code> element and <var title="">last</var> is false, then
1439: switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-intd" title="insertion
1440: mode: in cell">in cell</a>" and abort these steps.</li>
1441:
1442: <li>If <var title="">node</var> is a <code><a href="tabular-data.html#the-tr-element">tr</a></code> element, then
1443: switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-intr" title="insertion
1444: mode: in row">in row</a>" and abort these steps.</li>
1445:
1446: <li>If <var title="">node</var> is a <code><a href="tabular-data.html#the-tbody-element">tbody</a></code>,
1447: <code><a href="tabular-data.html#the-thead-element">thead</a></code>, or <code><a href="tabular-data.html#the-tfoot-element">tfoot</a></code> element, then switch the
1448: <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-intbody" title="insertion mode: in
1449: table body">in table body</a>" and abort these steps.</li>
1450:
1451: <li>If <var title="">node</var> is a <code><a href="tabular-data.html#the-caption-element">caption</a></code> element,
1452: then switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-incaption" title="insertion mode: in caption">in caption</a>" and abort
1453: these steps.</li>
1454:
1455: <li>If <var title="">node</var> is a <code><a href="tabular-data.html#the-colgroup-element">colgroup</a></code> element,
1456: then switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-incolgroup" title="insertion mode: in column group">in column group</a>" and
1457: abort these steps. (<a href="#fragment-case">fragment case</a>)</li>
1458:
1459: <li>If <var title="">node</var> is a <code><a href="tabular-data.html#the-table-element">table</a></code> element,
1460: then switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-intable" title="insertion mode: in table">in table</a>" and abort these
1461: steps.</li>
1462:
1463: <li>If <var title="">node</var> is an element from the <a href="#mathml-namespace">MathML
1464: namespace</a> or the <a href="#svg-namespace">SVG namespace</a>, then switch the
1465: <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-inforeign" title="insertion mode: in
1466: foreign content">in foreign content</a>", let the
1467: <a href="#secondary-insertion-mode">secondary insertion mode</a> be "<a href="#parsing-main-inbody" title="insertion
1468: mode: in body">in body</a>", and abort these steps.</li>
1469:
1470: <li>If <var title="">node</var> is a <code><a href="semantics.html#the-head-element">head</a></code> element,
1471: then switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-inbody" title="insertion mode: in body">in body</a>" ("<a href="#parsing-main-inbody" title="insertion mode: in body">in body</a>"! <em> not "<a href="#parsing-main-inhead" title="insertion mode: in head">in head</a>"</em>!) and abort
1472: these steps. (<a href="#fragment-case">fragment case</a>)</li> <!-- This is only
1473: here for now in case people think that the spec accidentally
1474: omitted it and try to "fix" it. Note that noscript-in-head is also
1475: handled this way. This is all intentional. The only thing it
1476: doesn't handle is the scripting-disabled fragment parsing case for
1477: a <head> element containing a <noscript> which itself contains
1478: something other than a <link> or a <style> element; you'd expect
1479: that to break out of the <noscript> but it doesn't. This is an edge
1480: case that doesn't affect the spec, since the algorithm for fragment
1481: parsing is only used for innerHTML/outerHTML/insertAdjacentHTML(),
1482: where we know scripting is enabled. (XXX except maybe if innerHTML
1483: is set from another browsing context on a document with designMode
1484: set?) -->
1485:
1486: <li>If <var title="">node</var> is a <code><a href="semantics.html#the-body-element">body</a></code> element,
1487: then switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-inbody" title="insertion mode: in body">in body</a>" and abort these
1488: steps.</li>
1489:
1.5 mike 1490: <li>If <var title="">node</var> is a <code><a href="obsolete.html#frameset">frameset</a></code> element,
1.1 mike 1491: then switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-inframeset" title="insertion mode: in frameset">in frameset</a>" and abort
1492: these steps. (<a href="#fragment-case">fragment case</a>)</li>
1493:
1494: <li>If <var title="">node</var> is an <code><a href="semantics.html#the-html-element">html</a></code> element,
1495: then: if the <a href="#head-element-pointer"><code title="">head</code> element
1496: pointer</a> is null, switch the <a href="#insertion-mode">insertion mode</a> to
1497: "<a href="#the-before-head-insertion-mode" title="insertion mode: before head">before head</a>",
1498: otherwise, switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#the-after-head-insertion-mode" title="insertion mode: after head">after head</a>". In either
1499: case, abort these steps. (<a href="#fragment-case">fragment case</a>)</li> <!-- XXX
1500: can the head element pointer ever be non-null when we're going
1501: through these steps? -->
1502:
1503: <li>If <var title="">last</var> is true, then switch the
1504: <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-inbody" title="insertion mode: in
1505: body">in body</a>" and abort these steps. (<a href="#fragment-case">fragment
1506: case</a>)</li>
1507:
1508: <li>Let <var title="">node</var> now be the node before <var title="">node</var> in the <a href="#stack-of-open-elements">stack of open
1509: elements</a>.</li>
1510:
1511: <li>Return to step 3.</li>
1512:
1513: </ol><h5 id="the-stack-of-open-elements"><span class="secno">9.2.3.2 </span>The stack of open elements</h5>
1514:
1515: <p>Initially, the <dfn id="stack-of-open-elements">stack of open elements</dfn> is empty. The
1516: stack grows downwards; the topmost node on the stack is the first
1517: one added to the stack, and the bottommost node of the stack is the
1518: most recently added node in the stack (notwithstanding when the
1519: stack is manipulated in a random access fashion as part of <a href="#adoptionAgency">the handling for misnested tags</a>).</p>
1520:
1521: <p>The "<a href="#the-before-html-insertion-mode" title="insertion mode: before html">before
1522: html</a>" <a href="#insertion-mode">insertion mode</a> creates the
1523: <code><a href="semantics.html#the-html-element">html</a></code> root element node, which is then added to the
1524: stack.</p>
1525:
1526: <p>In the <a href="#fragment-case">fragment case</a>, the <a href="#stack-of-open-elements">stack of open
1527: elements</a> is initialized to contain an <code><a href="semantics.html#the-html-element">html</a></code>
1528: element that is created as part of <a href="#html-fragment-parsing-algorithm" title="html fragment
1529: parsing algorithm">that algorithm</a>. (The <a href="#fragment-case">fragment
1530: case</a> skips the "<a href="#the-before-html-insertion-mode" title="insertion mode: before
1531: html">before html</a>" <a href="#insertion-mode">insertion mode</a>.)</p>
1532:
1533: <p>The <code><a href="semantics.html#the-html-element">html</a></code> node, however it is created, is the topmost
1534: node of the stack. It never gets popped off the stack.</p>
1535:
1536: <p>The <dfn id="current-node">current node</dfn> is the bottommost node in this
1537: stack.</p>
1538:
1539: <p>The <dfn id="current-table">current table</dfn> is the last <code><a href="tabular-data.html#the-table-element">table</a></code>
1540: element in the <a href="#stack-of-open-elements">stack of open elements</a>, if there is
1541: one. If there is no <code><a href="tabular-data.html#the-table-element">table</a></code> element in the <a href="#stack-of-open-elements">stack of
1542: open elements</a> (<a href="#fragment-case">fragment case</a>), then the
1543: <a href="#current-table">current table</a> is the first element in the <a href="#stack-of-open-elements">stack
1544: of open elements</a> (the <code><a href="semantics.html#the-html-element">html</a></code> element).</p>
1545:
1546: <p>Elements in the stack fall into the following categories:</p>
1547:
1548: <dl><dt><dfn id="special">Special</dfn></dt>
1549:
1550: <dd><p>The following HTML elements have varying levels of special
1551: parsing rules: <code><a href="semantics.html#the-address-element">address</a></code>, <code><a href="the-canvas-element.html#the-area-element">area</a></code>,
1552: <code><a href="semantics.html#the-article-element">article</a></code>, <code><a href="semantics.html#the-aside-element">aside</a></code>, <code><a href="semantics.html#the-base-element">base</a></code>,
1.5 mike 1553: <code><a href="obsolete.html#basefont">basefont</a></code>, <code>bgsound</code>,
1.1 mike 1554: <code><a href="semantics.html#the-blockquote-element">blockquote</a></code>, <code><a href="semantics.html#the-body-element">body</a></code>, <code><a href="semantics.html#the-br-element">br</a></code>,
1.5 mike 1555: <code><a href="obsolete.html#center">center</a></code>, <code><a href="tabular-data.html#the-col-element">col</a></code>, <code><a href="tabular-data.html#the-colgroup-element">colgroup</a></code>,
1.1 mike 1556: <code><a href="interactive-elements.html#the-command">command</a></code>, <code><a href="interactive-elements.html#datagrid">datagrid</a></code>, <code><a href="semantics.html#the-dd-element">dd</a></code>,
1.5 mike 1557: <code><a href="interactive-elements.html#the-details-element">details</a></code>, <code><a href="semantics.html#the-dialog-element">dialog</a></code>, <code><a href="obsolete.html#dir">dir</a></code>,
1.1 mike 1558: <code><a href="interactive-elements.html#the-div-element">div</a></code>, <code><a href="semantics.html#the-dl-element">dl</a></code>, <code><a href="semantics.html#the-dt-element">dt</a></code>,
1559: <code><a href="embedded-content-0.html#the-embed-element">embed</a></code>, <code><a href="forms.html#the-fieldset-element">fieldset</a></code>, <code><a href="embedded-content-0.html#the-figure-element">figure</a></code>,
1.5 mike 1560: <code><a href="semantics.html#the-footer-element">footer</a></code>, <code><a href="forms.html#the-form-element">form</a></code>, <code><a href="obsolete.html#frame">frame</a></code>,
1561: <code><a href="obsolete.html#frameset">frameset</a></code>, <code><a href="semantics.html#the-h1-h2-h3-h4-h5-and-h6-elements">h1</a></code>, <code><a href="semantics.html#the-h1-h2-h3-h4-h5-and-h6-elements">h2</a></code>,
1.1 mike 1562: <code><a href="semantics.html#the-h1-h2-h3-h4-h5-and-h6-elements">h3</a></code>, <code><a href="semantics.html#the-h1-h2-h3-h4-h5-and-h6-elements">h4</a></code>, <code><a href="semantics.html#the-h1-h2-h3-h4-h5-and-h6-elements">h5</a></code>, <code><a href="semantics.html#the-h1-h2-h3-h4-h5-and-h6-elements">h6</a></code>,
1563: <code><a href="semantics.html#the-head-element">head</a></code>, <code><a href="semantics.html#the-header-element">header</a></code>, <code><a href="semantics.html#the-hgroup-element">hgroup</a></code>,
1564: <code><a href="semantics.html#the-hr-element">hr</a></code>, <code><a href="embedded-content-0.html#the-iframe-element">iframe</a></code>, <!-- <code>image</code>,
1565: (commented out because this isn't an element that can end up on the
1566: stack, so it doesn't matter) --> <code><a href="embedded-content-0.html#the-img-element">img</a></code>,
1.5 mike 1567: <code><a href="forms.html#the-input-element">input</a></code>, <code><a href="obsolete.html#isindex-0">isindex</a></code>, <code><a href="semantics.html#the-li-element">li</a></code>,
1.1 mike 1568: <code><a href="semantics.html#the-link-element">link</a></code>, <code>listing</code>, <code><a href="interactive-elements.html#menus">menu</a></code>,
1.5 mike 1569: <code><a href="semantics.html#meta">meta</a></code>, <code><a href="semantics.html#the-nav-element">nav</a></code>, <code><a href="obsolete.html#noembed">noembed</a></code>,
1570: <code><a href="obsolete.html#noframes">noframes</a></code>, <code><a href="semantics.html#the-noscript-element">noscript</a></code>, <code><a href="semantics.html#the-ol-element">ol</a></code>,
1.1 mike 1571: <code><a href="semantics.html#the-p-element">p</a></code>, <code><a href="embedded-content-0.html#the-param-element">param</a></code>, <code>plaintext</code>,
1572: <code><a href="semantics.html#the-pre-element">pre</a></code>, <code><a href="semantics.html#script">script</a></code>, <code><a href="semantics.html#the-section-element">section</a></code>,
1.5 mike 1573: <code><a href="forms.html#the-select-element">select</a></code>, <code><a href="obsolete.html#spacer">spacer</a></code>, <code><a href="semantics.html#the-style-element">style</a></code>,
1.1 mike 1574: <code><a href="tabular-data.html#the-tbody-element">tbody</a></code>, <code><a href="forms.html#the-textarea-element">textarea</a></code>, <code><a href="tabular-data.html#the-tfoot-element">tfoot</a></code>,
1575: <code><a href="tabular-data.html#the-thead-element">thead</a></code>, <code><a href="semantics.html#the-title-element">title</a></code>, <code><a href="tabular-data.html#the-tr-element">tr</a></code>,
1576: <code><a href="semantics.html#the-ul-element">ul</a></code>, and <code>wbr</code>.</p></dd>
1577:
1578: <dt><dfn id="scoping">Scoping</dfn></dt>
1579: <dd><p>The following HTML elements introduce new <a href="#has-an-element-in-scope" title="has
1580: an element in scope">scopes</a> for various parts of the
1.5 mike 1581: parsing: <code><a href="obsolete.html#the-applet-element">applet</a></code>, <code><a href="forms.html#the-button-element">button</a></code>,
1582: <code><a href="tabular-data.html#the-caption-element">caption</a></code>, <code><a href="semantics.html#the-html-element">html</a></code>, <code><a href="obsolete.html#the-marquee-element-0">marquee</a></code>,
1.1 mike 1583: <code><a href="embedded-content-0.html#the-object-element">object</a></code>, <code><a href="tabular-data.html#the-table-element">table</a></code>, <code><a href="tabular-data.html#the-td-element">td</a></code>,
1584: <code><a href="tabular-data.html#the-th-element">th</a></code>, and SVG's <code>foreignObject</code>.</p></dd>
1585:
1586: <dt><dfn id="formatting">Formatting</dfn></dt>
1587: <dd><p>The following HTML elements are those that end up in the
1588: <a href="#list-of-active-formatting-elements">list of active formatting elements</a>: <code><a href="text-level-semantics.html#the-a-element">a</a></code>,
1.5 mike 1589: <code><a href="text-level-semantics.html#the-b-element">b</a></code>, <code><a href="obsolete.html#big">big</a></code>, <code><a href="text-level-semantics.html#the-code-element">code</a></code>,
1590: <code><a href="text-level-semantics.html#the-em-element">em</a></code>, <code><a href="obsolete.html#font">font</a></code>, <code><a href="text-level-semantics.html#the-i-element">i</a></code>,
1591: <code>nobr</code>, <code><a href="obsolete.html#s">s</a></code>, <code><a href="text-level-semantics.html#the-small-element">small</a></code>,
1592: <code><a href="obsolete.html#strike">strike</a></code>, <code><a href="text-level-semantics.html#the-strong-element">strong</a></code>, <code><a href="obsolete.html#tt">tt</a></code>, and
1593: <code><a href="obsolete.html#u">u</a></code>.</p></dd>
1.1 mike 1594:
1595: <dt><dfn id="phrasing">Phrasing</dfn></dt>
1596: <dd><p>All other elements found while parsing an HTML
1597: document.</p></dd>
1598:
1599: </dl><p>The <a href="#stack-of-open-elements">stack of open elements</a> is said to <dfn id="has-an-element-in-scope" title="has an element in scope">have an element in scope</dfn> when
1600: the following algorithm terminates in a match state:</p>
1601:
1602: <ol><li><p>Initialize <var title="">node</var> to be the <a href="#current-node">current
1603: node</a> (the bottommost node of the stack).</p></li>
1604:
1605: <li><p>If <var title="">node</var> is the target node, terminate in
1606: a match state.</p></li>
1607:
1608: <li><p>Otherwise, if <var title="">node</var> is one of the
1609: following elements, terminate in a failure state:</p>
1.5 mike 1610: <ul class="brief"><li><code><a href="obsolete.html#the-applet-element">applet</a></code> in the HTML namespace</li>
1.1 mike 1611: <li><code><a href="tabular-data.html#the-caption-element">caption</a></code> in the HTML namespace</li>
1612: <li><code><a href="semantics.html#the-html-element">html</a></code> in the HTML namespace</li> <!-- (This can only happen if the <var title="">node</var> is the topmost node of the <span>stack of open elements</span>, and prevents the next step from being invoked if there are no more elements in the stack.) -->
1613: <li><code><a href="tabular-data.html#the-table-element">table</a></code> in the HTML namespace</li>
1614: <li><code><a href="tabular-data.html#the-td-element">td</a></code> in the HTML namespace</li>
1615: <li><code><a href="tabular-data.html#the-th-element">th</a></code> in the HTML namespace</li>
1616: <li><code><a href="forms.html#the-button-element">button</a></code> in the HTML namespace</li>
1.5 mike 1617: <li><code><a href="obsolete.html#the-marquee-element-0">marquee</a></code> in the HTML namespace</li>
1.1 mike 1618: <li><code><a href="embedded-content-0.html#the-object-element">object</a></code> in the HTML namespace</li>
1619: <li><code title="">foreignObject</code> in the SVG namespace</li>
1620: </ul></li>
1621:
1622: <li><p>Otherwise, set <var title="">node</var> to the previous
1623: entry in the <a href="#stack-of-open-elements">stack of open elements</a> and return to step
1624: 2. (This will never fail, since the loop will always terminate in
1625: the previous step if the top of the stack — an
1626: <code><a href="semantics.html#the-html-element">html</a></code> element — is reached.)</p></li>
1627:
1628: </ol><p>The <a href="#stack-of-open-elements">stack of open elements</a> is said to <dfn id="has-an-element-in-table-scope" title="has an element in table scope">have an element in <em>table
1629: scope</em></dfn> when the following algorithm terminates in a match
1630: state:</p>
1631:
1632: <ol><li><p>Initialize <var title="">node</var> to be the <a href="#current-node">current
1633: node</a> (the bottommost node of the stack).</p></li>
1634:
1635: <li><p>If <var title="">node</var> is the target node, terminate in
1636: a match state.</p></li>
1637:
1638: <li><p>Otherwise, if <var title="">node</var> is one of the
1639: following elements, terminate in a failure state:</p>
1640: <ul class="brief"><li><code><a href="semantics.html#the-html-element">html</a></code> in the HTML namespace</li> <!-- (This can only happen if the <var title="">node</var> is the topmost node of the <span>stack of open elements</span>, and prevents the next step from being invoked if there are no more elements in the stack.) -->
1641: <li><code><a href="tabular-data.html#the-table-element">table</a></code> in the HTML namespace</li>
1642: </ul></li>
1643:
1644: <li><p>Otherwise, set <var title="">node</var> to the previous
1645: entry in the <a href="#stack-of-open-elements">stack of open elements</a> and return to step
1646: 2. (This will never fail, since the loop will always terminate in
1647: the previous step if the top of the stack — an
1648: <code><a href="semantics.html#the-html-element">html</a></code> element — is reached.)</p></li>
1649:
1650: </ol><p>Nothing happens if at any time any of the elements in the
1651: <a href="#stack-of-open-elements">stack of open elements</a> are moved to a new location in,
1652: or removed from, the <code>Document</code> tree. In particular, the
1653: stack is not changed in this situation. This can cause, amongst
1654: other strange effects, content to be appended to nodes that are no
1655: longer in the DOM.</p>
1656:
1657: <p class="note">In some cases (namely, when <a href="#adoptionAgency">closing misnested formatting elements</a>),
1658: the stack is manipulated in a random-access fashion.</p>
1659:
1660:
1661: <h5 id="the-list-of-active-formatting-elements"><span class="secno">9.2.3.3 </span>The list of active formatting elements</h5>
1662:
1663: <p>Initially, the <dfn id="list-of-active-formatting-elements">list of active formatting elements</dfn> is
1664: empty. It is used to handle mis-nested <a href="#formatting" title="formatting">formatting element tags</a>.</p>
1665:
1666: <p>The list contains elements in the <a href="#formatting">formatting</a>
1667: category, and scope markers. The scope markers are inserted when
1.5 mike 1668: entering <code><a href="obsolete.html#the-applet-element">applet</a></code> elements, buttons, <code><a href="embedded-content-0.html#the-object-element">object</a></code>
1.1 mike 1669: elements, marquees, table cells, and table captions, and are used to
1.5 mike 1670: prevent formatting from "leaking" <em>into</em> <code><a href="obsolete.html#the-applet-element">applet</a></code>
1.1 mike 1671: elements, buttons, <code><a href="embedded-content-0.html#the-object-element">object</a></code> elements, marquees, and
1672: tables.</p>
1673:
1674: <p class="note">The scope markers are unrelated to the concept of an
1675: element being <a href="#has-an-element-in-scope" title="has an element in scope">in
1676: scope</a>.</p>
1677:
1678: <p>In addition, each element in the <a href="#list-of-active-formatting-elements">list of active formatting
1679: elements</a> is associated with the token for which it was
1680: created, so that further elements can be created for that token if
1681: necessary.</p>
1682:
1683: <p>When the steps below require the UA to <dfn id="reconstruct-the-active-formatting-elements">reconstruct the
1684: active formatting elements</dfn>, the UA must perform the following
1685: steps:</p>
1686:
1687: <ol><li>If there are no entries in the <a href="#list-of-active-formatting-elements">list of active formatting
1688: elements</a>, then there is nothing to reconstruct; stop this
1689: algorithm.</li>
1690:
1691: <li>If the last (most recently added) entry in the <a href="#list-of-active-formatting-elements">list of
1692: active formatting elements</a> is a marker, or if it is an
1693: element that is in the <a href="#stack-of-open-elements">stack of open elements</a>, then
1694: there is nothing to reconstruct; stop this algorithm.</li>
1695:
1696: <li>Let <var title="">entry</var> be the last (most recently added)
1697: element in the <a href="#list-of-active-formatting-elements">list of active formatting
1698: elements</a>.</li>
1699:
1700: <li>If there are no entries before <var title="">entry</var> in the
1701: <a href="#list-of-active-formatting-elements">list of active formatting elements</a>, then jump to step
1702: 8.</li>
1703:
1704: <li>Let <var title="">entry</var> be the entry one earlier than
1705: <var title="">entry</var> in the <a href="#list-of-active-formatting-elements">list of active formatting
1706: elements</a>.</li>
1707:
1708: <li>If <var title="">entry</var> is neither a marker nor an element
1709: that is also in the <a href="#stack-of-open-elements">stack of open elements</a>, go to step
1710: 4.</li>
1711:
1712: <li>Let <var title="">entry</var> be the element one later than
1713: <var title="">entry</var> in the <a href="#list-of-active-formatting-elements">list of active formatting
1714: elements</a>.</li>
1715:
1716: <li><a href="#create-an-element-for-the-token">Create an element for the token</a> for which the
1717: element <var title="">entry</var> was created, to obtain <var title="">new element</var>.</li>
1718:
1719: <li>Append <var title="">new element</var> to the <a href="#current-node">current
1720: node</a> and push it onto the <a href="#stack-of-open-elements">stack of open
1721: elements</a> so that it is the new <a href="#current-node">current
1722: node</a>.</li>
1723:
1724: <li>Replace the entry for <var title="">entry</var> in the list
1725: with an entry for <var title="">new element</var>.</li>
1726:
1727: <li>If the entry for <var title="">new element</var> in the
1728: <a href="#list-of-active-formatting-elements">list of active formatting elements</a> is not the last
1729: entry in the list, return to step 7.</li>
1730:
1731: </ol><p>This has the effect of reopening all the formatting elements that
1732: were opened in the current body, cell, or caption (whichever is
1733: youngest) that haven't been explicitly closed.</p>
1734:
1735: <p class="note">The way this specification is written, the
1736: <a href="#list-of-active-formatting-elements">list of active formatting elements</a> always consists of
1737: elements in chronological order with the least recently added
1738: element first and the most recently added element last (except for
1739: while steps 8 to 11 of the above algorithm are being executed, of
1740: course).</p>
1741:
1742: <p>When the steps below require the UA to <dfn id="clear-the-list-of-active-formatting-elements-up-to-the-last-marker">clear the list of
1743: active formatting elements up to the last marker</dfn>, the UA must
1744: perform the following steps:</p>
1745:
1746: <ol><li>Let <var title="">entry</var> be the last (most recently added)
1747: entry in the <a href="#list-of-active-formatting-elements">list of active formatting elements</a>.</li>
1748:
1749: <li>Remove <var title="">entry</var> from the <a href="#list-of-active-formatting-elements">list of active
1750: formatting elements</a>.</li>
1751:
1752: <li>If <var title="">entry</var> was a marker, then stop the
1753: algorithm at this point. The list has been cleared up to the last
1754: marker.</li>
1755:
1756: <li>Go to step 1.</li>
1757:
1758: </ol><h5 id="the-element-pointers"><span class="secno">9.2.3.4 </span>The element pointers</h5>
1759:
1760: <p>Initially, the <dfn id="head-element-pointer"><code title="">head</code> element
1761: pointer</dfn> and the <dfn id="form-element-pointer"><code title="">form</code> element
1762: pointer</dfn> are both null.</p>
1763:
1764: <p>Once a <code><a href="semantics.html#the-head-element">head</a></code> element has been parsed (whether
1765: implicitly or explicitly) the <a href="#head-element-pointer"><code title="">head</code>
1766: element pointer</a> gets set to point to this node.</p>
1767:
1768: <p>The <a href="#form-element-pointer"><code title="">form</code> element pointer</a>
1769: points to the last <code><a href="forms.html#the-form-element">form</a></code> element that was opened and
1770: whose end tag has not yet been seen. It is used to make form
1771: controls associate with forms in the face of dramatically bad
1772: markup, for historical reasons.</p>
1773:
1774:
1775: <h5 id="other-parsing-state-flags"><span class="secno">9.2.3.5 </span>Other parsing state flags</h5>
1776:
1777: <p>The <dfn id="scripting-flag">scripting flag</dfn> is set to "enabled" if <a href="browsers.html#concept-n-script" title="concept-n-script">scripting was enabled</a> for the
1778: <code>Document</code> with which the parser is associated when the
1779: parser was created, and "disabled" otherwise.</p>
1780:
1781: <p class="note">The <a href="#scripting-flag">scripting flag</a> can be enabled even
1782: when the parser was originally created for the <a href="#html-fragment-parsing-algorithm">HTML fragment
1783: parsing algorithm</a>, even though <code><a href="semantics.html#script">script</a></code> elements
1784: don't execute in that case.</p>
1785:
1786: <p>The <dfn id="frameset-ok-flag">frameset-ok flag</dfn> is set to "ok" when the parser is
1787: created. It is set to "not ok" after certain tokens are seen.</p>
1788:
1789:
1790: <h4 id="tokenization"><span class="secno">9.2.4 </span><dfn>Tokenization</dfn></h4>
1791:
1792: <p>Implementations must act as if they used the following state
1793: machine to tokenize HTML. The state machine must start in the
1794: <a href="#data-state">data state</a>. Most states consume a single character,
1795: which may have various side-effects, and either switches the state
1796: machine to a new state to <em>reconsume</em> the same character, or
1797: switches it to a new state (to consume the next character), or
1798: repeats the same state (to consume the next character). Some states
1799: have more complicated behavior and can consume several characters
1800: before switching to another state.</p>
1801:
1802: <p>The exact behavior of certain states depends on a <dfn id="content-model-flag">content
1803: model flag</dfn> that is set after certain tokens are emitted. The
1804: flag has several states: <i title="">PCDATA</i>, <i title="">RCDATA</i>, <i title="">CDATA</i>, and <i title="">PLAINTEXT</i>. Initially, it must be in the PCDATA
1805: state. In the RCDATA and CDATA states, a further <dfn id="escape-flag">escape
1806: flag</dfn> is used to control the behavior of the tokenizer. It is
1807: either true or false, and initially must be set to the false
1808: state. The <a href="#insertion-mode">insertion mode</a> and the <a href="#stack-of-open-elements">stack of open
1809: elements</a> also affects tokenization.</p>
1810:
1811: <p>The output of the tokenization step is a series of zero or more
1812: of the following tokens: DOCTYPE, start tag, end tag, comment,
1813: character, end-of-file. DOCTYPE tokens have a name, a public
1814: identifier, a system identifier, and a <i>force-quirks
1815: flag</i>. When a DOCTYPE token is created, its name, public
1816: identifier, and system identifier must be marked as missing (which
1817: is a distinct state from the empty string), and the <i>force-quirks
1818: flag</i> must be set to <i>off</i> (its other state is
1819: <i>on</i>). Start and end tag tokens have a tag name, a
1820: <i>self-closing flag</i>, and a list of attributes, each of which
1821: has a name and a value. When a start or end tag token is created,
1822: its <i>self-closing flag</i> must be unset (its other state is that
1823: it be set), and its attributes list must be empty. Comment and
1824: character tokens have data.</p>
1825:
1826: <p>When a token is emitted, it must immediately be handled by the
1827: <a href="#tree-construction">tree construction</a> stage. The tree construction stage
1828: can affect the state of the <a href="#content-model-flag">content model flag</a>, and can
1829: insert additional characters into the stream. (For example, the
1830: <code><a href="semantics.html#script">script</a></code> element can result in scripts executing and
1831: using the <a href="dom.html#dynamic-markup-insertion">dynamic markup insertion</a> APIs to insert
1832: characters into the stream being tokenized.)</p>
1833:
1834: <p>When a start tag token is emitted with its <i>self-closing
1835: flag</i> set, if the flag is not <dfn id="acknowledge-self-closing-flag" title="acknowledge
1836: self-closing flag">acknowledged</dfn> when it is processed by the
1837: tree construction stage, that is a <a href="#parse-error">parse error</a>.</p>
1838:
1839: <p>When an end tag token is emitted, the <a href="#content-model-flag">content model
1840: flag</a> must be switched to the PCDATA state.</p>
1841:
1842: <p>When an end tag token is emitted with attributes, that is a
1843: <a href="#parse-error">parse error</a>.</p>
1844:
1845: <p>When an end tag token is emitted with its <i>self-closing
1846: flag</i> set, that is a <a href="#parse-error">parse error</a>.</p>
1847:
1848: <p>Before each step of the tokenizer, the user agent must first
1849: check the <a href="#parser-pause-flag">parser pause flag</a>. If it is true, then the
1850: tokenizer must abort the processing of any nested invocations of the
1851: tokenizer, yielding control back to the caller. If it is false, then
1852: the user agent may then check to see if either one of the scripts in
1853: the <a href="semantics.html#list-of-scripts-that-will-execute-as-soon-as-possible">list of scripts that will execute as soon as
1854: possible</a> or the first script in the <a href="semantics.html#list-of-scripts-that-will-execute-asynchronously">list of scripts
1855: that will execute asynchronously</a>, has <a href="semantics.html#completed-loading">completed
1856: loading</a>. If one has, then it must be <a href="semantics.html#executing-a-script-block" title="executing a
1857: script block">executed</a> and removed from its list.</p>
1858:
1859: <p>The tokenizer state machine consists of the states defined in the
1860: following subsections.</p>
1861:
1862: <!-- XXX should go through these reordering the entries so that
1863: they're in some consistent order, like, by Unicode, errors last, or
1864: something -->
1865:
1866: <h5 id="data-state"><span class="secno">9.2.4.1 </span><dfn>Data state</dfn></h5>
1867:
1868: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
1869:
1870: <dl class="switch"><dt>U+0026 AMPERSAND (&)</dt>
1871: <dd>When the <a href="#content-model-flag">content model flag</a> is set to one of the
1872: PCDATA or RCDATA states and the <a href="#escape-flag">escape flag</a> is
1873: false: switch to the <a href="#character-reference-data-state">character reference data
1874: state</a>.</dd> <dd>Otherwise: treat it as per the "anything
1875: else" entry below.</dd>
1876:
1877: <dt>U+002D HYPHEN-MINUS (-)</dt>
1878: <dd>
1879:
1880: <p>If the <a href="#content-model-flag">content model flag</a> is set to either the
1881: RCDATA state or the CDATA state, and the <a href="#escape-flag">escape flag</a>
1882: is false, and there are at least three characters before this
1883: one in the input stream, and the last four characters in the
1884: input stream, including this one, are U+003C LESS-THAN SIGN,
1885: U+0021 EXCLAMATION MARK, U+002D HYPHEN-MINUS, and U+002D
1886: HYPHEN-MINUS ("<!--"), then set the <a href="#escape-flag">escape flag</a>
1887: to true.</p>
1888:
1889: <p>In any case, emit the input character as a character
1890: token. Stay in the <a href="#data-state">data state</a>.</p>
1891:
1892: </dd>
1893:
1894: <dt>U+003C LESS-THAN SIGN (<)</dt>
1895: <dd>When the <a href="#content-model-flag">content model flag</a> is set to the PCDATA
1896: state: switch to the <a href="#tag-open-state">tag open state</a>.</dd>
1897: <dd>When the <a href="#content-model-flag">content model flag</a> is set to either the
1898: RCDATA state or the CDATA state, and the <a href="#escape-flag">escape flag</a>
1899: is false: switch to the <a href="#tag-open-state">tag open state</a>.</dd>
1900: <dd>Otherwise: treat it as per the "anything else" entry
1901: below.</dd>
1902:
1903: <dt>U+003E GREATER-THAN SIGN (>)</dt>
1904: <dd>
1905:
1906: <p>If the <a href="#content-model-flag">content model flag</a> is set to either the
1907: RCDATA state or the CDATA state, and the <a href="#escape-flag">escape
1908: flag</a> is true, and the last three characters in the input
1909: stream including this one are U+002D HYPHEN-MINUS, U+002D
1910: HYPHEN-MINUS, U+003E GREATER-THAN SIGN ("-->"), set the
1911: <a href="#escape-flag">escape flag</a> to false.</p> <!-- no need to check
1912: that there are enough characters, since you can only run into
1913: this if the flag is true in the first place, which requires four
1914: characters. -->
1915:
1916: <p>In any case, emit the input character as a character
1917: token. Stay in the <a href="#data-state">data state</a>.</p>
1918:
1919: </dd>
1920:
1921: <dt>EOF</dt>
1922: <dd>Emit an end-of-file token.</dd>
1923:
1924: <dt>Anything else</dt>
1925: <dd>Emit the input character as a character token. Stay in the
1926: <a href="#data-state">data state</a>.</dd>
1927:
1928: </dl><h5 id="character-reference-data-state"><span class="secno">9.2.4.2 </span><dfn>Character reference data state</dfn></h5>
1929:
1930: <p><i>(This cannot happen if the <a href="#content-model-flag">content model flag</a>
1931: is set to the CDATA state.)</i></p>
1932:
1933: <p>Attempt to <a href="#consume-a-character-reference">consume a character reference</a>, with no
1934: <a href="#additional-allowed-character">additional allowed character</a>.</p>
1935:
1936: <p>If nothing is returned, emit a U+0026 AMPERSAND character
1937: token.</p>
1938:
1939: <p>Otherwise, emit the character token that was returned.</p>
1940:
1941: <p>Finally, switch to the <a href="#data-state">data state</a>.</p>
1942:
1943:
1944: <h5 id="tag-open-state"><span class="secno">9.2.4.3 </span><dfn>Tag open state</dfn></h5>
1945:
1946: <p>The behavior of this state depends on the <a href="#content-model-flag">content model
1947: flag</a>.</p>
1948:
1949: <dl><dt>If the <a href="#content-model-flag">content model flag</a> is set to the RCDATA
1950: or CDATA states</dt>
1951:
1952: <dd>
1953:
1954: <p>Consume the <a href="#next-input-character">next input character</a>. If it is a
1955: U+002F SOLIDUS (/) character, switch to the <a href="#close-tag-open-state">close tag open
1956: state</a>. Otherwise, emit a U+003C LESS-THAN SIGN character
1957: token and reconsume the <a href="#current-input-character">current input character</a> in the
1958: <a href="#data-state">data state</a>.</p>
1959:
1960: </dd>
1961:
1962: <dt>If the <a href="#content-model-flag">content model flag</a> is set to the PCDATA
1963: state</dt>
1964:
1965: <dd>
1966:
1967: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
1968:
1969: <dl class="switch"><dt>U+0021 EXCLAMATION MARK (!)</dt>
1970: <dd>Switch to the <a href="#markup-declaration-open-state">markup declaration open state</a>.</dd>
1971:
1972: <dt>U+002F SOLIDUS (/)</dt>
1973: <dd>Switch to the <a href="#close-tag-open-state">close tag open state</a>.</dd>
1974:
1975: <dt>U+0041 LATIN CAPITAL LETTER A through to U+005A LATIN CAPITAL LETTER Z</dt>
1976: <dd>Create a new start tag token, set its tag name to the
1977: lowercase version of the input character (add 0x0020 to the
1978: character's code point), then switch to the <a href="#tag-name-state">tag name
1979: state</a>. (Don't emit the token yet; further details will
1980: be filled in before it is emitted.)</dd>
1981:
1982: <dt>U+0061 LATIN SMALL LETTER A through to U+007A LATIN SMALL LETTER Z</dt>
1983: <dd>Create a new start tag token, set its tag name to the input
1984: character, then switch to the <a href="#tag-name-state">tag name
1985: state</a>. (Don't emit the token yet; further details will
1986: be filled in before it is emitted.)</dd>
1987:
1988: <dt>U+003E GREATER-THAN SIGN (>)</dt>
1989: <dd><a href="#parse-error">Parse error</a>. Emit a U+003C LESS-THAN SIGN
1990: character token and a U+003E GREATER-THAN SIGN character
1991: token. Switch to the <a href="#data-state">data state</a>.</dd>
1992:
1993: <dt>U+003F QUESTION MARK (?)</dt>
1994: <dd><a href="#parse-error">Parse error</a>. Switch to the <a href="#bogus-comment-state">bogus
1995: comment state</a>.</dd>
1996:
1997: <dt>Anything else</dt>
1998: <dd><a href="#parse-error">Parse error</a>. Emit a U+003C LESS-THAN SIGN
1999: character token and reconsume the <a href="#current-input-character">current input character</a> in the
2000: <a href="#data-state">data state</a>.</dd>
2001:
2002: </dl></dd>
2003:
2004: </dl><h5 id="close-tag-open-state"><span class="secno">9.2.4.4 </span><dfn>Close tag open state</dfn></h5>
2005:
2006: <p>If the <a href="#content-model-flag">content model flag</a> is set to the RCDATA or
2007: CDATA states but no start tag token has ever been emitted by this
2008: instance of the tokenizer (<a href="#fragment-case">fragment case</a>), or, if the
2009: <a href="#content-model-flag">content model flag</a> is set to the RCDATA or CDATA states
2010: and the next few characters do not match the tag name of the last
2011: start tag token emitted (compared in an <a href="infrastructure.html#ascii-case-insensitive">ASCII
2012: case-insensitive</a> manner), or if they do but they are not
2013: immediately followed by one of the following characters:</p>
2014:
2015: <ul class="brief"><li>U+0009 CHARACTER TABULATION</li>
2016: <li>U+000A LINE FEED (LF)</li>
2017: <li>U+000C FORM FEED (FF)</li>
2018: <!--<li>U+000D CARRIAGE RETURN (CR)</li>-->
2019: <li>U+0020 SPACE</li>
2020: <li>U+003E GREATER-THAN SIGN (>)</li>
2021: <li>U+002F SOLIDUS (/)</li>
2022: <li>EOF</li>
2023: </ul><p>...then emit a U+003C LESS-THAN SIGN character token, a U+002F
2024: SOLIDUS character token, and switch to the <a href="#data-state">data state</a>
2025: to process the <a href="#next-input-character">next input character</a>.</p>
2026:
2027: <p>Otherwise, if the <a href="#content-model-flag">content model flag</a> is set to the
2028: PCDATA state, or if the next few characters <em>do</em> match that tag
2029: name, consume the <a href="#next-input-character">next input character</a>:</p>
2030:
2031: <dl class="switch"><dt>U+0041 LATIN CAPITAL LETTER A through to U+005A LATIN CAPITAL LETTER Z</dt>
2032: <dd>Create a new end tag token, set its tag name to the lowercase
2033: version of the input character (add 0x0020 to the character's
2034: code point), then switch to the <a href="#tag-name-state">tag name
2035: state</a>. (Don't emit the token yet; further details will be
2036: filled in before it is emitted.)</dd>
2037:
2038: <dt>U+0061 LATIN SMALL LETTER A through to U+007A LATIN SMALL LETTER Z</dt>
2039: <dd>Create a new end tag token, set its tag name to the input
2040: character, then switch to the <a href="#tag-name-state">tag name state</a>. (Don't
2041: emit the token yet; further details will be filled in before it
2042: is emitted.)</dd>
2043:
2044: <dt>U+003E GREATER-THAN SIGN (>)</dt>
2045: <dd><a href="#parse-error">Parse error</a>. Switch to the <a href="#data-state">data
2046: state</a>.</dd>
2047:
2048: <dt>EOF</dt>
2049: <dd><a href="#parse-error">Parse error</a>. Emit a U+003C LESS-THAN SIGN
2050: character token and a U+002F SOLIDUS character token. Reconsume
2051: the EOF character in the <a href="#data-state">data state</a>.</dd>
2052:
2053: <dt>Anything else</dt>
2054: <dd><a href="#parse-error">Parse error</a>. Switch to the <a href="#bogus-comment-state">bogus
2055: comment state</a>.</dd>
2056:
2057: </dl><h5 id="tag-name-state"><span class="secno">9.2.4.5 </span><dfn>Tag name state</dfn></h5>
2058:
2059: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
2060:
2061: <dl class="switch"><dt>U+0009 CHARACTER TABULATION</dt>
2062: <dt>U+000A LINE FEED (LF)</dt>
2063: <dt>U+000C FORM FEED (FF)</dt>
2064: <!--<dt>U+000D CARRIAGE RETURN (CR)</dt>-->
2065: <dt>U+0020 SPACE</dt>
2066: <dd>Switch to the <a href="#before-attribute-name-state">before attribute name state</a>.</dd>
2067:
2068: <dt>U+002F SOLIDUS (/)</dt>
2069: <dd>Switch to the <a href="#self-closing-start-tag-state">self-closing start tag state</a>.</dd>
2070:
2071: <dt>U+003E GREATER-THAN SIGN (>)</dt>
2072: <dd>Emit the current tag token. Switch to the <a href="#data-state">data
2073: state</a>.</dd>
2074:
2075: <dt>U+0041 LATIN CAPITAL LETTER A through to U+005A LATIN CAPITAL LETTER Z</dt>
2076: <dd>Append the lowercase version of the <a href="#current-input-character">current input character</a>
2077: (add 0x0020 to the character's code point) to the current tag
2078: token's tag name. Stay in the <a href="#tag-name-state">tag name state</a>.</dd>
2079:
2080: <dt>EOF</dt>
2081: <dd><a href="#parse-error">Parse error</a>. Reconsume the EOF character in the
2082: <a href="#data-state">data state</a>.</dd>
2083:
2084: <dt>Anything else</dt>
2085: <dd>Append the <a href="#current-input-character">current input character</a> to the current tag token's
2086: tag name. Stay in the <a href="#tag-name-state">tag name state</a>.</dd>
2087:
2088: </dl><h5 id="before-attribute-name-state"><span class="secno">9.2.4.6 </span><dfn>Before attribute name state</dfn></h5>
2089:
2090: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
2091:
2092: <dl class="switch"><dt>U+0009 CHARACTER TABULATION</dt>
2093: <dt>U+000A LINE FEED (LF)</dt>
2094: <dt>U+000C FORM FEED (FF)</dt>
2095: <!--<dt>U+000D CARRIAGE RETURN (CR)</dt>-->
2096: <dt>U+0020 SPACE</dt>
2097: <dd>Stay in the <a href="#before-attribute-name-state">before attribute name state</a>.</dd>
2098:
2099: <dt>U+002F SOLIDUS (/)</dt>
2100: <dd>Switch to the <a href="#self-closing-start-tag-state">self-closing start tag state</a>.</dd>
2101:
2102: <dt>U+003E GREATER-THAN SIGN (>)</dt>
2103: <dd>Emit the current tag token. Switch to the <a href="#data-state">data
2104: state</a>.</dd>
2105:
2106: <dt>U+0041 LATIN CAPITAL LETTER A through to U+005A LATIN CAPITAL LETTER Z</dt>
2107: <dd>Start a new attribute in the current tag token. Set that
2108: attribute's name to the lowercase version of the <a href="#current-input-character">current input
2109: character</a> (add 0x0020 to the character's code point), and its
2110: value to the empty string. Switch to the <a href="#attribute-name-state">attribute name
2111: state</a>.</dd>
2112:
2113: <dt>U+0022 QUOTATION MARK (")</dt>
2114: <dt>U+0027 APOSTROPHE (')</dt>
2115: <dt>U+003C LESS-THAN SIGN (<)</dt>
2116: <dt>U+003D EQUALS SIGN (=)</dt>
2117: <dd><a href="#parse-error">Parse error</a>. Treat it as per the "anything else"
2118: entry below.</dd>
2119:
2120: <dt>EOF</dt>
2121: <dd><a href="#parse-error">Parse error</a>. Reconsume the EOF character in the
2122: <a href="#data-state">data state</a>.</dd>
2123:
2124: <dt>Anything else</dt>
2125: <dd>Start a new attribute in the current tag token. Set that
2126: attribute's name to the <a href="#current-input-character">current input character</a>, and its value to
2127: the empty string. Switch to the <a href="#attribute-name-state">attribute name
2128: state</a>.</dd>
2129:
2130: </dl><h5 id="attribute-name-state"><span class="secno">9.2.4.7 </span><dfn>Attribute name state</dfn></h5>
2131:
2132: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
2133:
2134: <dl class="switch"><dt>U+0009 CHARACTER TABULATION</dt>
2135: <dt>U+000A LINE FEED (LF)</dt>
2136: <dt>U+000C FORM FEED (FF)</dt>
2137: <!--<dt>U+000D CARRIAGE RETURN (CR)</dt>-->
2138: <dt>U+0020 SPACE</dt>
2139: <dd>Switch to the <a href="#after-attribute-name-state">after attribute name state</a>.</dd>
2140:
2141: <dt>U+002F SOLIDUS (/)</dt>
2142: <dd>Switch to the <a href="#self-closing-start-tag-state">self-closing start tag state</a>.</dd>
2143:
2144: <dt>U+003D EQUALS SIGN (=)</dt>
2145: <dd>Switch to the <a href="#before-attribute-value-state">before attribute value state</a>.</dd>
2146:
2147: <dt>U+003E GREATER-THAN SIGN (>)</dt>
2148: <dd>Emit the current tag token. Switch to the <a href="#data-state">data
2149: state</a>.</dd>
2150:
2151: <dt>U+0041 LATIN CAPITAL LETTER A through to U+005A LATIN CAPITAL LETTER Z</dt>
2152: <dd>Append the lowercase version of the <a href="#current-input-character">current input character</a>
2153: (add 0x0020 to the character's code point) to the current
2154: attribute's name. Stay in the <a href="#attribute-name-state">attribute name
2155: state</a>.</dd>
2156:
2157: <dt>U+0022 QUOTATION MARK (")</dt>
2158: <dt>U+0027 APOSTROPHE (')</dt>
2159: <dt>U+003C LESS-THAN SIGN (<)</dt>
2160: <dd><a href="#parse-error">Parse error</a>. Treat it as per the "anything else"
2161: entry below.</dd>
2162:
2163: <dt>EOF</dt>
2164: <dd><a href="#parse-error">Parse error</a>. Reconsume the EOF character in the
2165: <a href="#data-state">data state</a>.</dd>
2166:
2167: <dt>Anything else</dt>
2168: <dd>Append the <a href="#current-input-character">current input character</a> to the current attribute's
2169: name. Stay in the <a href="#attribute-name-state">attribute name state</a>.</dd>
2170:
2171: </dl><p>When the user agent leaves the attribute name state (and before
2172: emitting the tag token, if appropriate), the complete attribute's
2173: name must be compared to the other attributes on the same token;
2174: if there is already an attribute on the token with the exact same
2175: name, then this is a <a href="#parse-error">parse error</a> and the new
2176: attribute must be dropped, along with the value that gets
2177: associated with it (if any).</p>
2178:
2179:
2180: <h5 id="after-attribute-name-state"><span class="secno">9.2.4.8 </span><dfn>After attribute name state</dfn></h5>
2181:
2182: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
2183:
2184: <dl class="switch"><dt>U+0009 CHARACTER TABULATION</dt>
2185: <dt>U+000A LINE FEED (LF)</dt>
2186: <dt>U+000C FORM FEED (FF)</dt>
2187: <!--<dt>U+000D CARRIAGE RETURN (CR)</dt>-->
2188: <dt>U+0020 SPACE</dt>
2189: <dd>Stay in the <a href="#after-attribute-name-state">after attribute name state</a>.</dd>
2190:
2191: <dt>U+002F SOLIDUS (/)</dt>
2192: <dd>Switch to the <a href="#self-closing-start-tag-state">self-closing start tag state</a>.</dd>
2193:
2194: <dt>U+003D EQUALS SIGN (=)</dt>
2195: <dd>Switch to the <a href="#before-attribute-value-state">before attribute value state</a>.</dd>
2196:
2197: <dt>U+003E GREATER-THAN SIGN (>)</dt>
2198: <dd>Emit the current tag token. Switch to the <a href="#data-state">data
2199: state</a>.</dd>
2200:
2201: <dt>U+0041 LATIN CAPITAL LETTER A through to U+005A LATIN CAPITAL LETTER Z</dt>
2202: <dd>Start a new attribute in the current tag token. Set that
2203: attribute's name to the lowercase version of the <a href="#current-input-character">current input character</a>
2204: (add 0x0020 to the character's code point), and its value to
2205: the empty string. Switch to the <a href="#attribute-name-state">attribute name
2206: state</a>.</dd>
2207:
2208: <dt>U+0022 QUOTATION MARK (")</dt>
2209: <dt>U+0027 APOSTROPHE (')</dt>
2210: <dt>U+003C LESS-THAN SIGN (<)</dt>
2211: <dd><a href="#parse-error">Parse error</a>. Treat it as per the "anything else"
2212: entry below.</dd>
2213:
2214: <dt>EOF</dt>
2215: <dd><a href="#parse-error">Parse error</a>. Reconsume the EOF character in the
2216: <a href="#data-state">data state</a>.</dd>
2217:
2218: <dt>Anything else</dt>
2219: <dd>Start a new attribute in the current tag token. Set that
2220: attribute's name to the <a href="#current-input-character">current input character</a>, and its value to
2221: the empty string. Switch to the <a href="#attribute-name-state">attribute name
2222: state</a>.</dd>
2223:
2224: </dl><h5 id="before-attribute-value-state"><span class="secno">9.2.4.9 </span><dfn>Before attribute value state</dfn></h5>
2225:
2226: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
2227:
2228: <dl class="switch"><dt>U+0009 CHARACTER TABULATION</dt>
2229: <dt>U+000A LINE FEED (LF)</dt>
2230: <dt>U+000C FORM FEED (FF)</dt>
2231: <!--<dt>U+000D CARRIAGE RETURN (CR)</dt>-->
2232: <dt>U+0020 SPACE</dt>
2233: <dd>Stay in the <a href="#before-attribute-value-state">before attribute value state</a>.</dd>
2234:
2235: <dt>U+0022 QUOTATION MARK (")</dt>
2236: <dd>Switch to the <a href="#attribute-value-double-quoted-state">attribute value (double-quoted) state</a>.</dd>
2237:
2238: <dt>U+0026 AMPERSAND (&)</dt>
2239: <dd>Switch to the <a href="#attribute-value-unquoted-state">attribute value (unquoted) state</a>
2240: and reconsume this input character.</dd>
2241:
2242: <dt>U+0027 APOSTROPHE (')</dt>
2243: <dd>Switch to the <a href="#attribute-value-single-quoted-state">attribute value (single-quoted) state</a>.</dd>
2244:
2245: <dt>U+003E GREATER-THAN SIGN (>)</dt>
2246: <dd><a href="#parse-error">Parse error</a>. Emit the current tag token. Switch to
2247: the <a href="#data-state">data state</a>.</dd>
2248:
2249: <dt>U+003C LESS-THAN SIGN (<)</dt>
2250: <dt>U+003D EQUALS SIGN (=)</dt>
2251: <dd><a href="#parse-error">Parse error</a>. Treat it as per the "anything else"
2252: entry below.</dd>
2253:
2254: <dt>EOF</dt>
2255: <dd><a href="#parse-error">Parse error</a>. Reconsume the EOF character in the
2256: <a href="#data-state">data state</a>.</dd>
2257:
2258: <dt>Anything else</dt>
2259: <dd>Append the <a href="#current-input-character">current input character</a> to the current
2260: attribute's value. Switch to the <a href="#attribute-value-unquoted-state">attribute value (unquoted)
2261: state</a>.</dd>
2262:
2263: </dl><h5 id="attribute-value-double-quoted-state"><span class="secno">9.2.4.10 </span><dfn>Attribute value (double-quoted) state</dfn></h5>
2264:
2265: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
2266:
2267: <dl class="switch"><dt>U+0022 QUOTATION MARK (")</dt>
2268: <dd>Switch to the <a href="#after-attribute-value-quoted-state">after attribute value (quoted)
2269: state</a>.</dd>
2270:
2271: <dt>U+0026 AMPERSAND (&)</dt>
2272: <dd>Switch to the <a href="#character-reference-in-attribute-value-state">character reference in attribute value
2273: state</a>, with the <a href="#additional-allowed-character">additional allowed character</a>
2274: being U+0022 QUOTATION MARK (").</dd>
2275:
2276: <dt>EOF</dt>
2277: <dd><a href="#parse-error">Parse error</a>. Reconsume the EOF character in the
2278: <a href="#data-state">data state</a>.</dd>
2279:
2280: <dt>Anything else</dt>
2281: <dd>Append the <a href="#current-input-character">current input character</a> to the current attribute's
2282: value. Stay in the <a href="#attribute-value-double-quoted-state">attribute value (double-quoted)
2283: state</a>.</dd>
2284:
2285: </dl><h5 id="attribute-value-single-quoted-state"><span class="secno">9.2.4.11 </span><dfn>Attribute value (single-quoted) state</dfn></h5>
2286:
2287: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
2288:
2289: <dl class="switch"><dt>U+0027 APOSTROPHE (')</dt>
2290: <dd>Switch to the <a href="#after-attribute-value-quoted-state">after attribute value (quoted)
2291: state</a>.</dd>
2292:
2293: <dt>U+0026 AMPERSAND (&)</dt>
2294: <dd>Switch to the <a href="#character-reference-in-attribute-value-state">character reference in attribute value
2295: state</a>, with the <a href="#additional-allowed-character">additional allowed character</a>
2296: being U+0027 APOSTROPHE (').</dd>
2297:
2298: <dt>EOF</dt>
2299: <dd><a href="#parse-error">Parse error</a>. Reconsume the EOF character in the
2300: <a href="#data-state">data state</a>.</dd>
2301:
2302: <dt>Anything else</dt>
2303: <dd>Append the <a href="#current-input-character">current input character</a> to the current attribute's
2304: value. Stay in the <a href="#attribute-value-single-quoted-state">attribute value (single-quoted)
2305: state</a>.</dd>
2306:
2307: </dl><h5 id="attribute-value-unquoted-state"><span class="secno">9.2.4.12 </span><dfn>Attribute value (unquoted) state</dfn></h5>
2308:
2309: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
2310:
2311: <dl class="switch"><dt>U+0009 CHARACTER TABULATION</dt>
2312: <dt>U+000A LINE FEED (LF)</dt>
2313: <dt>U+000C FORM FEED (FF)</dt>
2314: <!--<dt>U+000D CARRIAGE RETURN (CR)</dt>-->
2315: <dt>U+0020 SPACE</dt>
2316: <dd>Switch to the <a href="#before-attribute-name-state">before attribute name state</a>.</dd>
2317:
2318: <dt>U+0026 AMPERSAND (&)</dt>
2319: <dd>Switch to the <a href="#character-reference-in-attribute-value-state">character reference in attribute value
2320: state</a>, with no <a href="#additional-allowed-character">additional allowed
2321: character</a>.</dd>
2322:
2323: <dt>U+003E GREATER-THAN SIGN (>)</dt>
2324: <dd>Emit the current tag token. Switch to the <a href="#data-state">data
2325: state</a>.</dd>
2326:
2327: <dt>U+0022 QUOTATION MARK (")</dt>
2328: <dt>U+0027 APOSTROPHE (')</dt>
2329: <dt>U+003C LESS-THAN SIGN (<)</dt>
2330: <dt>U+003D EQUALS SIGN (=)</dt>
2331: <dd><a href="#parse-error">Parse error</a>. Treat it as per the "anything else"
2332: entry below.</dd>
2333:
2334: <dt>EOF</dt>
2335: <dd><a href="#parse-error">Parse error</a>. Reconsume the EOF character in the
2336: <a href="#data-state">data state</a>.</dd>
2337:
2338: <dt>Anything else</dt>
2339: <dd>Append the <a href="#current-input-character">current input character</a> to the current attribute's
2340: value. Stay in the <a href="#attribute-value-unquoted-state">attribute value (unquoted)
2341: state</a>.</dd>
2342:
2343: </dl><h5 id="character-reference-in-attribute-value-state"><span class="secno">9.2.4.13 </span><dfn>Character reference in attribute value state</dfn></h5>
2344:
2345: <p>Attempt to <a href="#consume-a-character-reference">consume a character reference</a>.</p>
2346:
2347: <p>If nothing is returned, append a U+0026 AMPERSAND character to
2348: the current attribute's value.</p>
2349:
2350: <p>Otherwise, append the returned character token to the current
2351: attribute's value.</p>
2352:
2353: <p>Finally, switch back to the attribute value state that you were
2354: in when were switched into this state.</p>
2355:
2356:
2357: <h5 id="after-attribute-value-quoted-state"><span class="secno">9.2.4.14 </span><dfn>After attribute value (quoted) state</dfn></h5>
2358:
2359: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
2360:
2361: <dl class="switch"><dt>U+0009 CHARACTER TABULATION</dt>
2362: <dt>U+000A LINE FEED (LF)</dt>
2363: <dt>U+000C FORM FEED (FF)</dt>
2364: <!--<dt>U+000D CARRIAGE RETURN (CR)</dt>-->
2365: <dt>U+0020 SPACE</dt>
2366: <dd>Switch to the <a href="#before-attribute-name-state">before attribute name state</a>.</dd>
2367:
2368: <dt>U+002F SOLIDUS (/)</dt>
2369: <dd>Switch to the <a href="#self-closing-start-tag-state">self-closing start tag state</a>.</dd>
2370:
2371: <dt>U+003E GREATER-THAN SIGN (>)</dt>
2372: <dd>Emit the current tag token. Switch to the <a href="#data-state">data
2373: state</a>.</dd>
2374:
2375: <dt>EOF</dt>
2376: <dd><a href="#parse-error">Parse error</a>. Reconsume the EOF character in the
2377: <a href="#data-state">data state</a>.</dd>
2378:
2379: <dt>Anything else</dt>
2380: <dd><a href="#parse-error">Parse error</a>. Reconsume the character in
2381: the <a href="#before-attribute-name-state">before attribute name state</a>.</dd>
2382:
2383: </dl><h5 id="self-closing-start-tag-state"><span class="secno">9.2.4.15 </span><dfn>Self-closing start tag state</dfn></h5>
2384:
2385: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
2386:
2387: <dl class="switch"><dt>U+003E GREATER-THAN SIGN (>)</dt>
2388: <dd>Set the <i>self-closing flag</i> of the current tag
2389: token. Emit the current tag token. Switch to the <a href="#data-state">data
2390: state</a>.</dd>
2391:
2392: <dt>EOF</dt>
2393: <dd><a href="#parse-error">Parse error</a>. Reconsume the EOF character in the
2394: <a href="#data-state">data state</a>.</dd>
2395:
2396: <dt>Anything else</dt>
2397: <dd><a href="#parse-error">Parse error</a>. Reconsume the character in
2398: the <a href="#before-attribute-name-state">before attribute name state</a>.</dd>
2399:
2400: </dl><h5 id="bogus-comment-state"><span class="secno">9.2.4.16 </span><dfn>Bogus comment state</dfn></h5>
2401:
2402: <p><i>(This can only happen if the <a href="#content-model-flag">content model
2403: flag</a> is set to the PCDATA state.)</i></p>
2404:
2405: <p>Consume every character up to and including the first U+003E
2406: GREATER-THAN SIGN character (>) or the end of the file (EOF),
2407: whichever comes first. Emit a comment token whose data is the
2408: concatenation of all the characters starting from and including
2409: the character that caused the state machine to switch into the
2410: bogus comment state, up to and including the character immediately
2411: before the last consumed character (i.e. up to the character just
2412: before the U+003E or EOF character). (If the comment was started
2413: by the end of the file (EOF), the token is empty.)</p>
2414:
2415: <p>Switch to the <a href="#data-state">data state</a>.</p>
2416:
2417: <p>If the end of the file was reached, reconsume the EOF
2418: character.</p>
2419:
2420:
2421: <h5 id="markup-declaration-open-state"><span class="secno">9.2.4.17 </span><dfn>Markup declaration open state</dfn></h5>
2422:
2423: <p><i>(This can only happen if the <a href="#content-model-flag">content model
2424: flag</a> is set to the PCDATA state.)</i></p>
2425:
2426: <p>If the next two characters are both U+002D HYPHEN-MINUS (-)
2427: characters, consume those two characters, create a comment token
2428: whose data is the empty string, and switch to the <a href="#comment-start-state">comment
2429: start state</a>.</p>
2430:
2431: <p>Otherwise, if the next seven characters are an <a href="infrastructure.html#ascii-case-insensitive">ASCII
2432: case-insensitive</a> match for the word "DOCTYPE", then consume
2433: those characters and switch to the <a href="#doctype-state">DOCTYPE state</a>.</p>
2434:
2435: <p>Otherwise, if the <a href="#insertion-mode">insertion mode</a> is "<a href="#parsing-main-inforeign" title="insertion mode: in foreign content">in foreign
2436: content</a>" and the <a href="#current-node">current node</a> is not an element
2437: in the <a href="#html-namespace-0">HTML namespace</a> and the next seven characters are
2438: an <span>ASCII case-sensitive</span> match for the string "[CDATA["
2439: (the five uppercase letters "CDATA" with a U+005B LEFT SQUARE
2440: BRACKET character before and after), then consume those characters
2441: and switch to the <a href="#cdata-section-state">CDATA section state</a> (which is
2442: unrelated to the <a href="#content-model-flag">content model flag</a>'s CDATA state).</p>
2443:
2444: <p>Otherwise, this is a <a href="#parse-error">parse error</a>. Switch to the
2445: <a href="#bogus-comment-state">bogus comment state</a>. The next character that is
2446: consumed, if any, is the first character that will be in the
2447: comment.</p>
2448:
2449:
2450: <h5 id="comment-start-state"><span class="secno">9.2.4.18 </span><dfn>Comment start state</dfn></h5>
2451:
2452: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
2453:
2454: <dl class="switch"><dt>U+002D HYPHEN-MINUS (-)</dt>
2455: <dd>Switch to the <a href="#comment-start-dash-state">comment start dash state</a>.</dd>
2456:
2457: <dt>U+003E GREATER-THAN SIGN (>)</dt>
2458: <dd><a href="#parse-error">Parse error</a>. Emit the comment token. Switch to the
2459: <a href="#data-state">data state</a>.</dd> <!-- see comment in comment end state
2460: -->
2461:
2462: <dt>EOF</dt>
2463: <dd><a href="#parse-error">Parse error</a>. Emit the comment token. Reconsume
2464: the EOF character in the <a href="#data-state">data state</a>.</dd>
2465:
2466: <dt>Anything else</dt>
2467: <dd>Append the input character to the comment token's
2468: data. Switch to the <a href="#comment-state">comment state</a>.</dd>
2469:
2470: </dl><h5 id="comment-start-dash-state"><span class="secno">9.2.4.19 </span><dfn>Comment start dash state</dfn></h5>
2471:
2472: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
2473:
2474: <dl class="switch"><dt>U+002D HYPHEN-MINUS (-)</dt>
2475: <dd>Switch to the <a href="#comment-end-state">comment end state</a></dd>
2476:
2477: <dt>U+003E GREATER-THAN SIGN (>)</dt>
2478: <dd><a href="#parse-error">Parse error</a>. Emit the comment token. Switch to
2479: the <a href="#data-state">data state</a>.</dd>
2480:
2481: <dt>EOF</dt>
2482: <dd><a href="#parse-error">Parse error</a>. Emit the comment token. Reconsume the
2483: EOF character in the <a href="#data-state">data state</a>.</dd> <!-- see comment
2484: in comment end state -->
2485:
2486: <dt>Anything else</dt>
2487: <dd>Append a U+002D HYPHEN-MINUS (-) character and the input
2488: character to the comment token's data. Switch to the
2489: <a href="#comment-state">comment state</a>.</dd>
2490:
2491: </dl><h5 id="comment-state"><span class="secno">9.2.4.20 </span><dfn id="comment">Comment state</dfn></h5>
2492:
2493: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
2494:
2495: <dl class="switch"><dt>U+002D HYPHEN-MINUS (-)</dt>
2496: <dd>Switch to the <a href="#comment-end-dash-state">comment end dash state</a></dd>
2497:
2498: <dt>EOF</dt>
2499: <dd><a href="#parse-error">Parse error</a>. Emit the comment token. Reconsume the
2500: EOF character in the <a href="#data-state">data state</a>.</dd> <!-- see comment
2501: in comment end state -->
2502:
2503: <dt>Anything else</dt>
2504: <dd>Append the input character to the comment token's data. Stay
2505: in the <a href="#comment-state">comment state</a>.</dd>
2506:
2507: </dl><h5 id="comment-end-dash-state"><span class="secno">9.2.4.21 </span><dfn>Comment end dash state</dfn></h5>
2508:
2509: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
2510:
2511: <dl class="switch"><dt>U+002D HYPHEN-MINUS (-)</dt>
2512: <dd>Switch to the <a href="#comment-end-state">comment end state</a></dd>
2513:
2514: <dt>EOF</dt>
2515: <dd><a href="#parse-error">Parse error</a>. Emit the comment token. Reconsume the
2516: EOF character in the <a href="#data-state">data state</a>.</dd> <!-- see comment
2517: in comment end state -->
2518:
2519: <dt>Anything else</dt>
2520: <dd>Append a U+002D HYPHEN-MINUS (-) character and the input
2521: character to the comment token's data. Switch to the
2522: <a href="#comment-state">comment state</a>.</dd>
2523:
2524: </dl><h5 id="comment-end-state"><span class="secno">9.2.4.22 </span><dfn>Comment end state</dfn></h5>
2525:
2526: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
2527:
2528: <dl class="switch"><dt>U+003E GREATER-THAN SIGN (>)</dt>
2529: <dd>Emit the comment token. Switch to the <a href="#data-state">data
2530: state</a>.</dd>
2531:
2532: <dt>U+002D HYPHEN-MINUS (-)</dt>
2533: <dd><a href="#parse-error">Parse error</a>. Append a U+002D HYPHEN-MINUS
2534: (-) character to the comment token's data. Stay in the
2535: <a href="#comment-end-state">comment end state</a>.</dd>
2536:
2537: <dt>U+0009 CHARACTER TABULATION</dt>
2538: <dt>U+000A LINE FEED (LF)</dt>
2539: <dt>U+000C FORM FEED (FF)</dt>
2540: <!--<dt>U+000D CARRIAGE RETURN (CR)</dt>-->
2541: <dt>U+0020 SPACE</dt>
2542: <dd><a href="#parse-error">Parse error</a>. Append two U+002D HYPHEN-MINUS (-)
2543: characters and the input character to the comment token's
2544: data. Switch to the <a href="#comment-end-space-state">comment end space state</a>.</dd>
2545:
2546: <dt>U+0021 EXCLAMATION MARK (!)</dt>
2547: <dd><a href="#parse-error">Parse error</a>. Switch to the <a href="#comment-end-bang-state">comment end bang
2548: state</a>.</dd>
2549:
2550: <dt>EOF</dt>
2551: <dd><a href="#parse-error">Parse error</a>. Emit the comment token. Reconsume
2552: the EOF character in the <a href="#data-state">data state</a>.</dd> <!-- For
2553: security reasons: otherwise, hostile user could put a <script> in
2554: a comment e.g. in a blog comment and then DOS the server so that
2555: the end tag isn't read, and then the commented <script> tag would
2556: be treated as live code -->
2557:
2558: <dt>Anything else</dt>
2559: <dd><a href="#parse-error">Parse error</a>. Append two U+002D HYPHEN-MINUS (-)
2560: characters and the input character to the comment token's
2561: data. Switch to the <a href="#comment-state">comment state</a>.</dd>
2562:
2563: </dl><h5 id="comment-end-bang-state"><span class="secno">9.2.4.23 </span><dfn>Comment end bang state</dfn></h5>
2564:
2565: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
2566:
2567: <dl class="switch"><dt>U+003E GREATER-THAN SIGN (>)</dt>
2568: <dd>Emit the comment token. Switch to the <a href="#data-state">data
2569: state</a>.</dd>
2570:
2571: <dt>U+002D HYPHEN-MINUS (-)</dt>
2572: <dd>Append two U+002D HYPHEN-MINUS (-) characters and a U+0021
2573: EXCLAMATION MARK (!) character to the comment token's data. Switch
2574: to the <a href="#comment-end-dash-state">comment end dash state</a>.</dd>
2575:
2576: <dt>EOF</dt>
2577: <dd><a href="#parse-error">Parse error</a>. Emit the comment token. Reconsume
2578: the EOF character in the <a href="#data-state">data state</a>.</dd> <!-- see
2579: comment in comment end state -->
2580:
2581: <dt>Anything else</dt>
2582: <dd>Append two U+002D HYPHEN-MINUS (-) characters, a U+0021
2583: EXCLAMATION MARK (!) character, and the input character to the
2584: comment token's data. Switch to the <a href="#comment-state">comment
2585: state</a>.</dd>
2586:
2587: </dl><h5 id="comment-end-space-state"><span class="secno">9.2.4.24 </span><dfn>Comment end space state</dfn></h5>
2588:
2589: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
2590:
2591: <dl class="switch"><dt>U+003E GREATER-THAN SIGN (>)</dt>
2592: <dd>Emit the comment token. Switch to the <a href="#data-state">data
2593: state</a>.</dd>
2594:
2595: <dt>U+002D HYPHEN-MINUS (-)</dt>
2596: <dd>Switch to the <a href="#comment-end-dash-state">comment end dash state</a>.</dd>
2597:
2598: <dt>U+0009 CHARACTER TABULATION</dt>
2599: <dt>U+000A LINE FEED (LF)</dt>
2600: <dt>U+000C FORM FEED (FF)</dt>
2601: <!--<dt>U+000D CARRIAGE RETURN (CR)</dt>-->
2602: <dt>U+0020 SPACE</dt>
2603: <dd>Append the input character to the comment token's data. Stay in
2604: the <a href="#comment-end-space-state">comment end space state</a>.</dd>
2605:
2606: <dt>EOF</dt>
2607: <dd><a href="#parse-error">Parse error</a>. Emit the comment token. Reconsume
2608: the EOF character in the <a href="#data-state">data state</a>.</dd> <!-- see
2609: comment in comment end state -->
2610:
2611: <dt>Anything else</dt>
2612: <dd>Append the input character to the comment token's data. Switch
2613: to the <a href="#comment-state">comment state</a>.</dd>
2614:
2615: </dl><h5 id="doctype-state"><span class="secno">9.2.4.25 </span><dfn>DOCTYPE state</dfn></h5>
2616:
2617: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
2618:
2619: <dl class="switch"><dt>U+0009 CHARACTER TABULATION</dt>
2620: <dt>U+000A LINE FEED (LF)</dt>
2621: <dt>U+000C FORM FEED (FF)</dt>
2622: <!--<dt>U+000D CARRIAGE RETURN (CR)</dt>-->
2623: <dt>U+0020 SPACE</dt>
2624: <dd>Switch to the <a href="#before-doctype-name-state">before DOCTYPE name state</a>.</dd>
2625:
2626: <dt>EOF</dt>
2627: <dd><a href="#parse-error">Parse error</a>. Create a new DOCTYPE token. Set its
2628: <i>force-quirks flag</i> to <i>on</i>. Emit the token. Reconsume
2629: the EOF character in the <a href="#data-state">data state</a>.</dd>
2630:
2631: <dt>Anything else</dt>
2632: <dd><a href="#parse-error">Parse error</a>. Reconsume the current
2633: character in the <a href="#before-doctype-name-state">before DOCTYPE name state</a>.</dd>
2634:
2635: </dl><h5 id="before-doctype-name-state"><span class="secno">9.2.4.26 </span><dfn>Before DOCTYPE name state</dfn></h5>
2636:
2637: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
2638:
2639: <dl class="switch"><dt>U+0009 CHARACTER TABULATION</dt>
2640: <dt>U+000A LINE FEED (LF)</dt>
2641: <dt>U+000C FORM FEED (FF)</dt>
2642: <!--<dt>U+000D CARRIAGE RETURN (CR)</dt>-->
2643: <dt>U+0020 SPACE</dt>
2644: <dd>Stay in the <a href="#before-doctype-name-state">before DOCTYPE name state</a>.</dd>
2645:
2646: <dt>U+003E GREATER-THAN SIGN (>)</dt>
2647: <dd><a href="#parse-error">Parse error</a>. Create a new DOCTYPE token. Set its
2648: <i>force-quirks flag</i> to <i>on</i>. Emit the token. Switch to
2649: the <a href="#data-state">data state</a>.</dd>
2650:
2651: <dt>U+0041 LATIN CAPITAL LETTER A through to U+005A LATIN CAPITAL LETTER Z</dt>
2652: <dd>Create a new DOCTYPE token. Set the token's name to the
2653: lowercase version of the input character (add 0x0020 to the
2654: character's code point). Switch to the <a href="#doctype-name-state">DOCTYPE name
2655: state</a>.</dd>
2656:
2657: <dt>EOF</dt>
2658: <dd><a href="#parse-error">Parse error</a>. Create a new DOCTYPE token. Set its
2659: <i>force-quirks flag</i> to <i>on</i>. Emit the token. Reconsume
2660: the EOF character in the <a href="#data-state">data state</a>.</dd>
2661:
2662: <dt>Anything else</dt>
2663: <dd>Create a new DOCTYPE token. Set the token's name to the
2664: <a href="#current-input-character">current input character</a>. Switch to the <a href="#doctype-name-state">DOCTYPE name
2665: state</a>.</dd>
2666:
2667: </dl><h5 id="doctype-name-state"><span class="secno">9.2.4.27 </span><dfn>DOCTYPE name state</dfn></h5>
2668:
2669: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
2670:
2671: <dl class="switch"><dt>U+0009 CHARACTER TABULATION</dt>
2672: <dt>U+000A LINE FEED (LF)</dt>
2673: <dt>U+000C FORM FEED (FF)</dt>
2674: <!--<dt>U+000D CARRIAGE RETURN (CR)</dt>-->
2675: <dt>U+0020 SPACE</dt>
2676: <dd>Switch to the <a href="#after-doctype-name-state">after DOCTYPE name state</a>.</dd>
2677:
2678: <dt>U+003E GREATER-THAN SIGN (>)</dt>
2679: <dd>Emit the current DOCTYPE token. Switch to the <a href="#data-state">data
2680: state</a>.</dd>
2681:
2682: <dt>U+0041 LATIN CAPITAL LETTER A through to U+005A LATIN CAPITAL LETTER Z</dt>
2683: <dd>Append the lowercase version of the input character (add 0x0020
2684: to the character's code point) to the current DOCTYPE token's
2685: name. Stay in the <a href="#doctype-name-state">DOCTYPE name state</a>.</dd>
2686:
2687: <dt>EOF</dt>
2688: <dd><a href="#parse-error">Parse error</a>. Set the DOCTYPE token's
2689: <i>force-quirks flag</i> to <i>on</i>. Emit that DOCTYPE token.
2690: Reconsume the EOF character in the <a href="#data-state">data state</a>.</dd>
2691:
2692: <dt>Anything else</dt>
2693: <dd>Append the <a href="#current-input-character">current input character</a> to the current DOCTYPE
2694: token's name. Stay in the <a href="#doctype-name-state">DOCTYPE name state</a>.</dd>
2695:
2696: </dl><h5 id="after-doctype-name-state"><span class="secno">9.2.4.28 </span><dfn>After DOCTYPE name state</dfn></h5>
2697:
2698: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
2699:
2700: <dl class="switch"><dt>U+0009 CHARACTER TABULATION</dt>
2701: <dt>U+000A LINE FEED (LF)</dt>
2702: <dt>U+000C FORM FEED (FF)</dt>
2703: <!--<dt>U+000D CARRIAGE RETURN (CR)</dt>-->
2704: <dt>U+0020 SPACE</dt>
2705: <dd>Stay in the <a href="#after-doctype-name-state">after DOCTYPE name state</a>.</dd>
2706:
2707: <dt>U+003E GREATER-THAN SIGN (>)</dt>
2708: <dd>Emit the current DOCTYPE token. Switch to the <a href="#data-state">data
2709: state</a>.</dd>
2710:
2711: <dt>EOF</dt>
2712: <dd><a href="#parse-error">Parse error</a>. Set the DOCTYPE token's
2713: <i>force-quirks flag</i> to <i>on</i>. Emit that DOCTYPE token.
2714: Reconsume the EOF character in the <a href="#data-state">data state</a>.</dd>
2715:
2716: <dt>Anything else</dt>
2717: <dd>
2718:
2719: <p>If the six characters starting from the <a href="#current-input-character">current input
2720: character</a> are an <a href="infrastructure.html#ascii-case-insensitive">ASCII case-insensitive</a> match
2721: for the word "PUBLIC", then consume those characters and switch to
2722: the <a href="#before-doctype-public-identifier-state">before DOCTYPE public identifier state</a>.</p>
2723:
2724: <p>Otherwise, if the six characters starting from the
2725: <a href="#current-input-character">current input character</a> are an <a href="infrastructure.html#ascii-case-insensitive">ASCII
2726: case-insensitive</a> match for the word "SYSTEM", then consume
2727: those characters and switch to the <a href="#before-doctype-system-identifier-state">before DOCTYPE system
2728: identifier state</a>.</p>
2729:
2730: <p>Otherwise, this is the <a href="#parse-error">parse error</a>. Set the
2731: DOCTYPE token's <i>force-quirks flag</i> to <i>on</i>. Switch to
2732: the <a href="#bogus-doctype-state">bogus DOCTYPE state</a>.</p>
2733:
2734: </dd>
2735:
2736: </dl><h5 id="before-doctype-public-identifier-state"><span class="secno">9.2.4.29 </span><dfn>Before DOCTYPE public identifier state</dfn></h5>
2737:
2738: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
2739:
2740: <dl class="switch"><dt>U+0009 CHARACTER TABULATION</dt>
2741: <dt>U+000A LINE FEED (LF)</dt>
2742: <dt>U+000C FORM FEED (FF)</dt>
2743: <!--<dt>U+000D CARRIAGE RETURN (CR)</dt>-->
2744: <dt>U+0020 SPACE</dt>
2745: <dd>Stay in the <a href="#before-doctype-public-identifier-state">before DOCTYPE public identifier state</a>.</dd>
2746:
2747: <dt>U+0022 QUOTATION MARK (")</dt>
2748: <dd>Set the DOCTYPE token's public identifier to the empty string
2749: (not missing), then switch to the <a href="#doctype-public-identifier-double-quoted-state">DOCTYPE public identifier
2750: (double-quoted) state</a>.</dd>
2751:
2752: <dt>U+0027 APOSTROPHE (')</dt>
2753: <dd>Set the DOCTYPE token's public identifier to the empty string
2754: (not missing), then switch to the <a href="#doctype-public-identifier-single-quoted-state">DOCTYPE public identifier
2755: (single-quoted) state</a>.</dd>
2756:
2757: <dt>U+003E GREATER-THAN SIGN (>)</dt>
2758: <dd><a href="#parse-error">Parse error</a>. Set the DOCTYPE token's
2759: <i>force-quirks flag</i> to <i>on</i>. Emit that DOCTYPE
2760: token. Switch to the <a href="#data-state">data state</a>.</dd>
2761:
2762: <dt>EOF</dt>
2763: <dd><a href="#parse-error">Parse error</a>. Set the DOCTYPE token's
2764: <i>force-quirks flag</i> to <i>on</i>. Emit that DOCTYPE token.
2765: Reconsume the EOF character in the <a href="#data-state">data state</a>.</dd>
2766:
2767: <dt>Anything else</dt>
2768: <dd><a href="#parse-error">Parse error</a>. Set the DOCTYPE token's
2769: <i>force-quirks flag</i> to <i>on</i>. Switch to the <a href="#bogus-doctype-state">bogus
2770: DOCTYPE state</a>.</dd>
2771:
2772: </dl><h5 id="doctype-public-identifier-double-quoted-state"><span class="secno">9.2.4.30 </span><dfn>DOCTYPE public identifier (double-quoted) state</dfn></h5>
2773:
2774: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
2775:
2776: <dl class="switch"><dt>U+0022 QUOTATION MARK (")</dt>
2777: <dd>Switch to the <a href="#after-doctype-public-identifier-state">after DOCTYPE public identifier state</a>.</dd>
2778:
2779: <dt>U+003E GREATER-THAN SIGN (>)</dt>
2780: <dd><a href="#parse-error">Parse error</a>. Set the DOCTYPE token's
2781: <i>force-quirks flag</i> to <i>on</i>. Emit that DOCTYPE
2782: token. Switch to the <a href="#data-state">data state</a>.</dd>
2783:
2784: <dt>EOF</dt>
2785: <dd><a href="#parse-error">Parse error</a>. Set the DOCTYPE token's
2786: <i>force-quirks flag</i> to <i>on</i>. Emit that DOCTYPE token.
2787: Reconsume the EOF character in the <a href="#data-state">data state</a>.</dd>
2788:
2789: <dt>Anything else</dt>
2790: <dd>Append the <a href="#current-input-character">current input character</a> to the current DOCTYPE
2791: token's public identifier. Stay in the <a href="#doctype-public-identifier-double-quoted-state">DOCTYPE public
2792: identifier (double-quoted) state</a>.</dd>
2793:
2794: </dl><h5 id="doctype-public-identifier-single-quoted-state"><span class="secno">9.2.4.31 </span><dfn>DOCTYPE public identifier (single-quoted) state</dfn></h5>
2795:
2796: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
2797:
2798: <dl class="switch"><dt>U+0027 APOSTROPHE (')</dt>
2799: <dd>Switch to the <a href="#after-doctype-public-identifier-state">after DOCTYPE public identifier state</a>.</dd>
2800:
2801: <dt>U+003E GREATER-THAN SIGN (>)</dt>
2802: <dd><a href="#parse-error">Parse error</a>. Set the DOCTYPE token's
2803: <i>force-quirks flag</i> to <i>on</i>. Emit that DOCTYPE
2804: token. Switch to the <a href="#data-state">data state</a>.</dd>
2805:
2806: <dt>EOF</dt>
2807: <dd><a href="#parse-error">Parse error</a>. Set the DOCTYPE token's
2808: <i>force-quirks flag</i> to <i>on</i>. Emit that DOCTYPE token.
2809: Reconsume the EOF character in the <a href="#data-state">data state</a>.</dd>
2810:
2811: <dt>Anything else</dt>
2812: <dd>Append the <a href="#current-input-character">current input character</a> to the current DOCTYPE
2813: token's public identifier. Stay in the <a href="#doctype-public-identifier-single-quoted-state">DOCTYPE public
2814: identifier (single-quoted) state</a>.</dd>
2815:
2816: </dl><h5 id="after-doctype-public-identifier-state"><span class="secno">9.2.4.32 </span><dfn>After DOCTYPE public identifier state</dfn></h5>
2817:
2818: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
2819:
2820: <dl class="switch"><dt>U+0009 CHARACTER TABULATION</dt>
2821: <dt>U+000A LINE FEED (LF)</dt>
2822: <dt>U+000C FORM FEED (FF)</dt>
2823: <!--<dt>U+000D CARRIAGE RETURN (CR)</dt>-->
2824: <dt>U+0020 SPACE</dt>
2825: <dd>Stay in the <a href="#after-doctype-public-identifier-state">after DOCTYPE public identifier state</a>.</dd>
2826:
2827: <dt>U+0022 QUOTATION MARK (")</dt>
2828: <dd>Set the DOCTYPE token's system identifier to the empty string
2829: (not missing), then switch to the <a href="#doctype-system-identifier-double-quoted-state">DOCTYPE system identifier
2830: (double-quoted) state</a>.</dd>
2831:
2832: <dt>U+0027 APOSTROPHE (')</dt>
2833: <dd>Set the DOCTYPE token's system identifier to the empty string
2834: (not missing), then switch to the <a href="#doctype-system-identifier-single-quoted-state">DOCTYPE system identifier
2835: (single-quoted) state</a>.</dd>
2836:
2837: <dt>U+003E GREATER-THAN SIGN (>)</dt>
2838: <dd>Emit the current DOCTYPE token. Switch to the <a href="#data-state">data
2839: state</a>.</dd>
2840:
2841: <dt>EOF</dt>
2842: <dd><a href="#parse-error">Parse error</a>. Set the DOCTYPE token's
2843: <i>force-quirks flag</i> to <i>on</i>. Emit that DOCTYPE token.
2844: Reconsume the EOF character in the <a href="#data-state">data state</a>.</dd>
2845:
2846: <dt>Anything else</dt>
2847: <dd><a href="#parse-error">Parse error</a>. Set the DOCTYPE token's
2848: <i>force-quirks flag</i> to <i>on</i>. Switch to the <a href="#bogus-doctype-state">bogus
2849: DOCTYPE state</a>.</dd>
2850:
2851: </dl><h5 id="before-doctype-system-identifier-state"><span class="secno">9.2.4.33 </span><dfn>Before DOCTYPE system identifier state</dfn></h5>
2852:
2853: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
2854:
2855: <dl class="switch"><dt>U+0009 CHARACTER TABULATION</dt>
2856: <dt>U+000A LINE FEED (LF)</dt>
2857: <dt>U+000C FORM FEED (FF)</dt>
2858: <!--<dt>U+000D CARRIAGE RETURN (CR)</dt>-->
2859: <dt>U+0020 SPACE</dt>
2860: <dd>Stay in the <a href="#before-doctype-system-identifier-state">before DOCTYPE system identifier state</a>.</dd>
2861:
2862: <dt>U+0022 QUOTATION MARK (")</dt>
2863: <dd>Set the DOCTYPE token's system identifier to the empty string
2864: (not missing), then switch to the <a href="#doctype-system-identifier-double-quoted-state">DOCTYPE system identifier
2865: (double-quoted) state</a>.</dd>
2866:
2867: <dt>U+0027 APOSTROPHE (')</dt>
2868: <dd>Set the DOCTYPE token's system identifier to the empty string
2869: (not missing), then switch to the <a href="#doctype-system-identifier-single-quoted-state">DOCTYPE system identifier
2870: (single-quoted) state</a>.</dd>
2871:
2872: <dt>U+003E GREATER-THAN SIGN (>)</dt>
2873: <dd><a href="#parse-error">Parse error</a>. Set the DOCTYPE token's
2874: <i>force-quirks flag</i> to <i>on</i>. Emit that DOCTYPE
2875: token. Switch to the <a href="#data-state">data state</a>.</dd>
2876:
2877: <dt>EOF</dt>
2878: <dd><a href="#parse-error">Parse error</a>. Set the DOCTYPE token's
2879: <i>force-quirks flag</i> to <i>on</i>. Emit that DOCTYPE token.
2880: Reconsume the EOF character in the <a href="#data-state">data state</a>.</dd>
2881:
2882: <dt>Anything else</dt>
2883: <dd><a href="#parse-error">Parse error</a>. Set the DOCTYPE token's
2884: <i>force-quirks flag</i> to <i>on</i>. Switch to the <a href="#bogus-doctype-state">bogus
2885: DOCTYPE state</a>.</dd>
2886:
2887: </dl><h5 id="doctype-system-identifier-double-quoted-state"><span class="secno">9.2.4.34 </span><dfn>DOCTYPE system identifier (double-quoted) state</dfn></h5>
2888:
2889: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
2890:
2891: <dl class="switch"><dt>U+0022 QUOTATION MARK (")</dt>
2892: <dd>Switch to the <a href="#after-doctype-system-identifier-state">after DOCTYPE system identifier state</a>.</dd>
2893:
2894: <dt>U+003E GREATER-THAN SIGN (>)</dt>
2895: <dd><a href="#parse-error">Parse error</a>. Set the DOCTYPE token's
2896: <i>force-quirks flag</i> to <i>on</i>. Emit that DOCTYPE
2897: token. Switch to the <a href="#data-state">data state</a>.</dd>
2898:
2899: <dt>EOF</dt>
2900: <dd><a href="#parse-error">Parse error</a>. Set the DOCTYPE token's
2901: <i>force-quirks flag</i> to <i>on</i>. Emit that DOCTYPE token.
2902: Reconsume the EOF character in the <a href="#data-state">data state</a>.</dd>
2903:
2904: <dt>Anything else</dt>
2905: <dd>Append the <a href="#current-input-character">current input character</a> to the current DOCTYPE
2906: token's system identifier. Stay in the <a href="#doctype-system-identifier-double-quoted-state">DOCTYPE system
2907: identifier (double-quoted) state</a>.</dd>
2908:
2909: </dl><h5 id="doctype-system-identifier-single-quoted-state"><span class="secno">9.2.4.35 </span><dfn>DOCTYPE system identifier (single-quoted) state</dfn></h5>
2910:
2911: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
2912:
2913: <dl class="switch"><dt>U+0027 APOSTROPHE (')</dt>
2914: <dd>Switch to the <a href="#after-doctype-system-identifier-state">after DOCTYPE system identifier state</a>.</dd>
2915:
2916: <dt>U+003E GREATER-THAN SIGN (>)</dt>
2917: <dd><a href="#parse-error">Parse error</a>. Set the DOCTYPE token's
2918: <i>force-quirks flag</i> to <i>on</i>. Emit that DOCTYPE
2919: token. Switch to the <a href="#data-state">data state</a>.</dd>
2920:
2921: <dt>EOF</dt>
2922: <dd><a href="#parse-error">Parse error</a>. Set the DOCTYPE token's
2923: <i>force-quirks flag</i> to <i>on</i>. Emit that DOCTYPE token.
2924: Reconsume the EOF character in the <a href="#data-state">data state</a>.</dd>
2925:
2926: <dt>Anything else</dt>
2927: <dd>Append the <a href="#current-input-character">current input character</a> to the current DOCTYPE
2928: token's system identifier. Stay in the <a href="#doctype-system-identifier-single-quoted-state">DOCTYPE system
2929: identifier (single-quoted) state</a>.</dd>
2930:
2931: </dl><h5 id="after-doctype-system-identifier-state"><span class="secno">9.2.4.36 </span><dfn>After DOCTYPE system identifier state</dfn></h5>
2932:
2933: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
2934:
2935: <dl class="switch"><dt>U+0009 CHARACTER TABULATION</dt>
2936: <dt>U+000A LINE FEED (LF)</dt>
2937: <dt>U+000C FORM FEED (FF)</dt>
2938: <!--<dt>U+000D CARRIAGE RETURN (CR)</dt>-->
2939: <dt>U+0020 SPACE</dt>
2940: <dd>Stay in the <a href="#after-doctype-system-identifier-state">after DOCTYPE system identifier state</a>.</dd>
2941:
2942: <dt>U+003E GREATER-THAN SIGN (>)</dt>
2943: <dd>Emit the current DOCTYPE token. Switch to the <a href="#data-state">data
2944: state</a>.</dd>
2945:
2946: <dt>EOF</dt>
2947: <dd><a href="#parse-error">Parse error</a>. Set the DOCTYPE token's
2948: <i>force-quirks flag</i> to <i>on</i>. Emit that DOCTYPE token.
2949: Reconsume the EOF character in the <a href="#data-state">data state</a>.</dd>
2950:
2951: <dt>Anything else</dt>
2952: <dd><a href="#parse-error">Parse error</a>. Switch to the <a href="#bogus-doctype-state">bogus DOCTYPE
2953: state</a>. (This does <em>not</em> set the DOCTYPE token's
2954: <i>force-quirks flag</i> to <i>on</i>.)</dd>
2955:
2956: </dl><h5 id="bogus-doctype-state"><span class="secno">9.2.4.37 </span><dfn>Bogus DOCTYPE state</dfn></h5>
2957:
2958: <p>Consume the <a href="#next-input-character">next input character</a>:</p>
2959:
2960: <dl class="switch"><dt>U+003E GREATER-THAN SIGN (>)</dt>
2961: <dd>Emit the DOCTYPE token. Switch to the <a href="#data-state">data
2962: state</a>.</dd>
2963:
2964: <dt>EOF</dt>
2965: <dd>Emit the DOCTYPE token. Reconsume the EOF character in the
2966: <a href="#data-state">data state</a>.</dd>
2967:
2968: <dt>Anything else</dt>
2969: <dd>Stay in the <a href="#bogus-doctype-state">bogus DOCTYPE state</a>.</dd>
2970:
2971: </dl><h5 id="cdata-section-state"><span class="secno">9.2.4.38 </span><dfn>CDATA section state</dfn></h5>
2972:
2973: <p><i>(This can only happen if the <a href="#content-model-flag">content model
2974: flag</a> is set to the PCDATA state, and is unrelated to the
2975: <a href="#content-model-flag">content model flag</a>'s CDATA state.)</i></p>
2976:
2977: <p>Consume every character up to the next occurrence of the three
2978: character sequence U+005D RIGHT SQUARE BRACKET U+005D RIGHT SQUARE
2979: BRACKET U+003E GREATER-THAN SIGN (<code title="">]]></code>), or the
2980: end of the file (EOF), whichever comes first. Emit a series of
2981: character tokens consisting of all the characters consumed except
2982: the matching three character sequence at the end (if one was found
2983: before the end of the file).</p>
2984:
2985: <p>Switch to the <a href="#data-state">data state</a>.</p>
2986:
2987: <p>If the end of the file was reached, reconsume the EOF
2988: character.</p>
2989:
2990:
2991:
2992: <h5 id="tokenizing-character-references"><span class="secno">9.2.4.39 </span>Tokenizing character references</h5>
2993:
2994: <p>This section defines how to <dfn id="consume-a-character-reference">consume a character
2995: reference</dfn>. This definition is used when parsing character
2996: references <a href="#character-reference-data-state" title="character reference data state">in
2997: text</a> and <a href="#character-reference-in-attribute-value-state" title="character reference in attribute value
2998: state">in attributes</a>.</p>
2999:
3000: <p>The behavior depends on the identity of the next character (the
3001: one immediately after the U+0026 AMPERSAND character):</p>
3002:
3003: <dl class="switch"><dt>U+0009 CHARACTER TABULATION</dt>
3004: <dt>U+000A LINE FEED (LF)</dt>
3005: <dt>U+000C FORM FEED (FF)</dt>
3006: <!--<dt>U+000D CARRIAGE RETURN (CR)</dt>-->
3007: <dt>U+0020 SPACE</dt>
3008: <dt>U+003C LESS-THAN SIGN</dt>
3009: <dt>U+0026 AMPERSAND</dt>
3010: <dt>EOF</dt>
3011: <dt>The <dfn id="additional-allowed-character">additional allowed character</dfn>, if there is one</dt>
3012:
3013: <dd>Not a character reference. No characters are consumed, and
3014: nothing is returned. (This is not an error, either.)</dd>
3015:
3016:
3017: <dt>U+0023 NUMBER SIGN (#)</dt>
3018:
3019: <dd>
3020:
3021: <p>Consume the U+0023 NUMBER SIGN.</p>
3022:
3023: <p>The behavior further depends on the character after the U+0023
3024: NUMBER SIGN:</p>
3025:
3026: <dl class="switch"><dt>U+0078 LATIN SMALL LETTER X</dt>
3027: <dt>U+0058 LATIN CAPITAL LETTER X</dt>
3028:
3029: <dd>
3030:
3031: <p>Consume the X.</p>
3032:
3033: <p>Follow the steps below, but using the range of characters
3034: U+0030 DIGIT ZERO through to U+0039 DIGIT NINE, U+0061 LATIN
3035: SMALL LETTER A through to U+0066 LATIN SMALL LETTER F, and
3036: U+0041 LATIN CAPITAL LETTER A, through to U+0046 LATIN CAPITAL
3037: LETTER F (in other words, 0-9, A-F, a-f).</p>
3038:
3039: <p>When it comes to interpreting the number, interpret it as a
3040: hexadecimal number.</p>
3041:
3042: </dd>
3043:
3044:
3045: <dt>Anything else</dt>
3046:
3047: <dd>
3048:
3049: <p>Follow the steps below, but using the range of characters
3050: U+0030 DIGIT ZERO through to U+0039 DIGIT NINE (i.e. just
3051: 0-9).</p>
3052:
3053: <p>When it comes to interpreting the number, interpret it as a
3054: decimal number.</p>
3055:
3056: </dd>
3057:
3058: </dl><p>Consume as many characters as match the range of characters
3059: given above.</p>
3060:
3061: <p>If no characters match the range, then don't consume any
3062: characters (and unconsume the U+0023 NUMBER SIGN character and, if
3063: appropriate, the X character). This is a <a href="#parse-error">parse
3064: error</a>; nothing is returned.</p>
3065:
3066: <p>Otherwise, if the next character is a U+003B SEMICOLON, consume
3067: that too. If it isn't, there is a <a href="#parse-error">parse
3068: error</a>.</p>
3069:
3070: <p>If one or more characters match the range, then take them all
3071: and interpret the string of characters as a number (either
3072: hexadecimal or decimal as appropriate).</p>
3073:
3074: <p>If that number is one of the numbers in the first column of the
3075: following table, then this is a <a href="#parse-error">parse error</a>. Find the
3076: row with that number in the first column, and return a character
3077: token for the Unicode character given in the second column of that
3078: row.</p>
3079:
3080: <table><thead><tr><th>Number </th><th colspan="2">Unicode character
3081: </th></tr></thead><tbody><tr><td>0x00 </td><td>U+FFFD </td><td>REPLACEMENT CHARACTER
3082: </td></tr><tr><td>0x0D </td><td>U+000A </td><td>LINE FEED (LF)
3083: </td></tr><tr><td>0x80 </td><td>U+20AC </td><td>EURO SIGN ('€')
3084: </td></tr><tr><td>0x81 </td><td>U+0081 </td><td><control>
3085: </td></tr><tr><td>0x82 </td><td>U+201A </td><td>SINGLE LOW-9 QUOTATION MARK ('‚')
3086: </td></tr><tr><td>0x83 </td><td>U+0192 </td><td>LATIN SMALL LETTER F WITH HOOK ('ƒ')
3087: </td></tr><tr><td>0x84 </td><td>U+201E </td><td>DOUBLE LOW-9 QUOTATION MARK ('„')
3088: </td></tr><tr><td>0x85 </td><td>U+2026 </td><td>HORIZONTAL ELLIPSIS ('…')
3089: </td></tr><tr><td>0x86 </td><td>U+2020 </td><td>DAGGER ('†')
3090: </td></tr><tr><td>0x87 </td><td>U+2021 </td><td>DOUBLE DAGGER ('‡')
3091: </td></tr><tr><td>0x88 </td><td>U+02C6 </td><td>MODIFIER LETTER CIRCUMFLEX ACCENT ('ˆ')
3092: </td></tr><tr><td>0x89 </td><td>U+2030 </td><td>PER MILLE SIGN ('‰')
3093: </td></tr><tr><td>0x8A </td><td>U+0160 </td><td>LATIN CAPITAL LETTER S WITH CARON ('Š')
3094: </td></tr><tr><td>0x8B </td><td>U+2039 </td><td>SINGLE LEFT-POINTING ANGLE QUOTATION MARK ('‹')
3095: </td></tr><tr><td>0x8C </td><td>U+0152 </td><td>LATIN CAPITAL LIGATURE OE ('Œ')
3096: </td></tr><tr><td>0x8D </td><td>U+008D </td><td><control>
3097: </td></tr><tr><td>0x8E </td><td>U+017D </td><td>LATIN CAPITAL LETTER Z WITH CARON ('Ž')
3098: </td></tr><tr><td>0x8F </td><td>U+008F </td><td><control>
3099: </td></tr><tr><td>0x90 </td><td>U+0090 </td><td><control>
3100: </td></tr><tr><td>0x91 </td><td>U+2018 </td><td>LEFT SINGLE QUOTATION MARK ('‘')
3101: </td></tr><tr><td>0x92 </td><td>U+2019 </td><td>RIGHT SINGLE QUOTATION MARK ('’')
3102: </td></tr><tr><td>0x93 </td><td>U+201C </td><td>LEFT DOUBLE QUOTATION MARK ('“')
3103: </td></tr><tr><td>0x94 </td><td>U+201D </td><td>RIGHT DOUBLE QUOTATION MARK ('”')
3104: </td></tr><tr><td>0x95 </td><td>U+2022 </td><td>BULLET ('•')
3105: </td></tr><tr><td>0x96 </td><td>U+2013 </td><td>EN DASH ('–')
3106: </td></tr><tr><td>0x97 </td><td>U+2014 </td><td>EM DASH ('—')
3107: </td></tr><tr><td>0x98 </td><td>U+02DC </td><td>SMALL TILDE ('˜')
3108: </td></tr><tr><td>0x99 </td><td>U+2122 </td><td>TRADE MARK SIGN ('™')
3109: </td></tr><tr><td>0x9A </td><td>U+0161 </td><td>LATIN SMALL LETTER S WITH CARON ('š')
3110: </td></tr><tr><td>0x9B </td><td>U+203A </td><td>SINGLE RIGHT-POINTING ANGLE QUOTATION MARK ('›')
3111: </td></tr><tr><td>0x9C </td><td>U+0153 </td><td>LATIN SMALL LIGATURE OE ('œ')
3112: </td></tr><tr><td>0x9D </td><td>U+009D </td><td><control>
3113: </td></tr><tr><td>0x9E </td><td>U+017E </td><td>LATIN SMALL LETTER Z WITH CARON ('ž')
3114: </td></tr><tr><td>0x9F </td><td>U+0178 </td><td>LATIN CAPITAL LETTER Y WITH DIAERESIS ('Ÿ')
3115: </td></tr></tbody></table><p>Otherwise, return a character token for the Unicode character
3116: whose code point is that number.
3117:
3118: <!-- this is the same as the equivalent list in the input stream
3119: section -->
3120: If the number is in the range 0x0001 to 0x0008, <!-- HT, LF
3121: allowed --> <!-- U+000B is in the next list --> <!-- FF, CR
3122: allowed --> 0x000E to 0x001F, <!-- ASCII allowed --> 0x007F <!--to
3123: 0x0084, (0x0085 NEL not allowed), 0x0086--> to 0x009F, 0xD800 to
3124: 0xDFFF<!-- surrogates not allowed -->, 0xFDD0 to 0xFDEF, or is one
3125: of 0x000B, 0xFFFE, 0xFFFF, 0x1FFFE, 0x1FFFF, 0x2FFFE, 0x2FFFF,
3126: 0x3FFFE, 0x3FFFF, 0x4FFFE, 0x4FFFF, 0x5FFFE, 0x5FFFF, 0x6FFFE,
3127: 0x6FFFF, 0x7FFFE, 0x7FFFF, 0x8FFFE, 0x8FFFF, 0x9FFFE, 0x9FFFF,
3128: 0xAFFFE, 0xAFFFF, 0xBFFFE, 0xBFFFF, 0xCFFFE, 0xCFFFF, 0xDFFFE,
3129: 0xDFFFF, 0xEFFFE, 0xEFFFF, 0xFFFFE, 0xFFFFF, 0x10FFFE, or
3130: 0x10FFFF, or is higher than 0x10FFFF, then this is a <a href="#parse-error">parse
3131: error</a>.</p>
3132:
3133: </dd>
3134:
3135:
3136: <dt>Anything else</dt>
3137:
3138: <dd>
3139:
3140: <p>Consume the maximum number of characters possible, with the
3141: consumed characters matching one of the identifiers in the first
3142: column of the <a href="named-character-references.html#named-character-references">named character references</a> table (in a
3143: <a href="infrastructure.html#case-sensitive">case-sensitive</a> manner).</p>
3144:
3145: <p>If no match can be made, then this is a <a href="#parse-error">parse
3146: error</a>. No characters are consumed, and nothing is
3147: returned.</p>
3148:
3149: <p>If the last character matched is not a U+003B SEMICOLON (<code title="">;</code>), there is a <a href="#parse-error">parse error</a>.</p>
3150:
3151: <p>If the character reference is being consumed <a href="#character-reference-in-attribute-value-state" title="character reference in attribute value state">as part of an
3152: attribute</a>, and the last character matched is not a U+003B
3153: SEMICOLON (<code title="">;</code>), and the next character is in
3154: the range U+0030 DIGIT ZERO to U+0039 DIGIT NINE, U+0041 LATIN
3155: CAPITAL LETTER A to U+005A LATIN CAPITAL LETTER Z, or U+0061 LATIN
3156: SMALL LETTER A to U+007A LATIN SMALL LETTER Z, then, for
3157: historical reasons, all the characters that were matched after the
3158: U+0026 AMPERSAND (&) must be unconsumed, and nothing is
3159: returned.</p>
3160:
3161: <p>Otherwise, return a character token for the character
3162: corresponding to the character reference name (as given by the
3163: second column of the <a href="named-character-references.html#named-character-references">named character references</a>
3164: table).</p>
3165:
3166: <div class="example">
3167:
3168: <p>If the markup contains <code title="">I'm &notit; I tell
3169: you</code>, the character reference is parsed as "not", as in,
3170: <code title="">I'm ¬it; I tell you</code>. But if the markup
3171: was <code title="">I'm &notin; I tell you</code>, the
3172: character reference would be parsed as "notin;", resulting in
3173: <code title="">I'm ∉ I tell you</code>.</p>
3174:
3175: </div>
3176:
3177: </dd>
3178:
3179: </dl><h4 id="tree-construction"><span class="secno">9.2.5 </span><dfn>Tree construction</dfn></h4>
3180:
3181: <p>The input to the tree construction stage is a sequence of tokens
3182: from the <a href="#tokenization">tokenization</a> stage. The tree construction
3183: stage is associated with a DOM <code>Document</code> object when a
3184: parser is created. The "output" of this stage consists of
3185: dynamically modifying or extending that document's DOM tree.</p>
3186:
3187: <p>This specification does not define when an interactive user agent
3188: has to render the <code>Document</code> so that it is available to
3189: the user, or when it has to begin accepting user input.</p>
3190:
3191: <p>As each token is emitted from the tokenizer, the user agent must
3192: process the token according to the rules given in the section
3193: corresponding to the current <a href="#insertion-mode">insertion mode</a>.</p>
3194:
3195: <p>When the steps below require the UA to <dfn id="insert-a-character">insert a
3196: character</dfn> into a node, if that node has a child immediately
3197: before where the character is to be inserted, and that child is a
3198: <code>Text</code> node, and that <code>Text</code> node was the last
3199: node that the parser inserted into the document, then the character
3200: must be appended to that <code>Text</code> node; otherwise, a new
3201: <code>Text</code> node whose data is just that character must be
3202: inserted in the appropriate place.</p>
3203:
3204: <div class="example">
3205:
3206: <p>Here are some sample inputs to the parser and the corresponding
3207: number of text nodes that they result in, assuming a user agent
3208: that executes scripts.</p>
3209:
3210: <table><thead><tr><th>Input </th><th>Number of text nodes
3211: </th></tr></thead><tbody><tr><td><pre>A<script>
3212: var script = document.getElementsByTagName('script')[0];
3213: document.body.removeChild(script);
3214: </script>B</pre>
3215: </td><td>Two adjacent text nodes in the document, containing "A" and "B".
3216: </td></tr><tr><td><pre>A<script>
3217: var text = document.createTextNode('B');
3218: document.body.appendChild(text);
3219: </script>C</pre>
3220: </td><td>Four text nodes; "A" before the script, the script's contents, "B" after the script, and then, immediately after that, "C".
3221: </td></tr><tr><td><pre>A<script>
3222: var text = document.getElementsByTagName('script')[0].firstChild;
3223: text.data = 'B';
3224: document.body.appendChild(text);
3225: </script>B</pre>
3226: </td><td>Two adjacent text nodes in the document, containing "A" and "BB".
3227: </td></tr><tr><td><pre>A<table>B<tr>C</tr>C</table></pre>
3228: </td><td>Three adjacent text nodes before the table, containing "A", "B", and "CC" respectively. (This is caused by <a href="#foster-parent" title="foster parent">foster parenting</a>.)
3229: </td></tr><tr><td><pre>A<table><tr> B</tr> B</table></pre>
3230: </td><td>Two adjacent text nodes before the table, containing "A" and " B B" (space-B-space-B) respectively. (This is caused by <a href="#foster-parent" title="foster parent">foster parenting</a>.)
3231: </td></tr><tr><td><pre>A<table><tr> B</tr> </em>C</table></pre>
3232: </td><td>Three adjacent text nodes before the table, containing "A", " B" (space-B), and "C" respectively, and one text node inside the table (as a child of a <code><a href="tabular-data.html#the-tbody-element">tbody</a></code>) with a single space character. (Space characters separated from non-space characters by non-character tokens are not affected by <a href="#foster-parent" title="foster parent">foster parenting</a>, even if those other tokens then get ignored.)
3233: </td></tr></tbody></table></div>
3234:
3235: <p id="mutation-during-parsing">DOM mutation events must not fire
3236: for changes caused by the UA parsing the document. (Conceptually,
3237: the parser is not mutating the DOM, it is constructing it.) This
3238: includes the parsing of any content inserted using <code title="dom-document-write"><a href="dom.html#dom-document-write">document.write()</a></code> and <code title="dom-document-writeln"><a href="dom.html#dom-document-writeln">document.writeln()</a></code> calls. <a href="references.html#references">[DOM3EVENTS]</a></p>
3239:
3240: <p class="note">Not all of the tag names mentioned below are
3241: conformant tag names in this specification; many are included to
3242: handle legacy content. They still form part of the algorithm that
3243: implementations are required to implement to claim conformance.</p>
3244:
3245: <p class="note">The algorithm described below places no limit on the
3246: depth of the DOM tree generated, or on the length of tag names,
3247: attribute names, attribute values, text nodes, etc. While
3248: implementors are encouraged to avoid arbitrary limits, it is
3249: recognized that <a href="infrastructure.html#hardwareLimitations">practical
3250: concerns</a> will likely force user agents to impose nesting
3251: depths.</p>
3252:
3253:
3254: <h5 id="creating-and-inserting-elements"><span class="secno">9.2.5.1 </span>Creating and inserting elements</h5>
3255:
3256: <p>When the steps below require the UA to <dfn id="create-an-element-for-the-token" title="create an
3257: element for the token">create an element for a token</dfn> in a
3258: particular namespace, the UA must create a node implementing the
3259: interface appropriate for the element type corresponding to the tag
3260: name of the token in the given namespace (as given in the
3261: specification that defines that element, e.g. for an <code><a href="text-level-semantics.html#the-a-element">a</a></code>
3262: element in the <a href="#html-namespace-0">HTML namespace</a>, this specification
3263: defines it to be the <code><a href="text-level-semantics.html#htmlanchorelement">HTMLAnchorElement</a></code> interface), with
3264: the tag name being the name of that element, with the node being in
3265: the given namespace, and with the attributes on the node being those
3266: given in the given token.</p>
3267:
3268: <p>The interface appropriate for an element in the <a href="#html-namespace-0">HTML
3269: namespace</a> that is not defined in this specification is
3270: <code><a href="dom.html#htmlelement">HTMLElement</a></code>. Element in other namespaces whose
3271: interface is not defined by that namespace's specification must use
3272: the interface <code>Element</code>.</p>
3273:
3274: <p>When a <a href="forms.html#category-reset" title="category-reset">resettable</a> element is
3275: created in this manner, its <a href="forms.html#concept-form-reset-control" title="concept-form-reset-control">reset algorithm</a> must be
3276: invoked once the attributes are set. (This initializes the element's
3277: <a href="forms.html#concept-fe-value" title="concept-fe-value">value</a> and <a href="forms.html#concept-fe-checked" title="concept-fe-checked">checkedness</a> based on the element's
3278: attributes.)</p>
3279:
3280: <hr><p>When the steps below require the UA to <dfn id="insert-an-html-element">insert an HTML
3281: element</dfn> for a token, the UA must first <a href="#create-an-element-for-the-token">create an element
3282: for the token</a> in the <a href="#html-namespace-0">HTML namespace</a>, and then
3283: append this node to the <a href="#current-node">current node</a>, and push it onto
3284: the <a href="#stack-of-open-elements">stack of open elements</a> so that it is the new
3285: <a href="#current-node">current node</a>.</p>
3286:
3287: <p>The steps below may also require that the UA insert an HTML
3288: element in a particular place, in which case the UA must follow the
3289: same steps except that it must insert or append the new node in the
3290: location specified instead of appending it to the <a href="#current-node">current
3291: node</a>. (This happens in particular during the parsing of
3292: tables with invalid content.)</p>
3293:
3294: <p>If an element created by the <a href="#insert-an-html-element">insert an HTML element</a>
3295: algorithm is a <a href="forms.html#form-associated-element">form-associated element</a>, and the
3296: <a href="#form-element-pointer"><code title="">form</code> element pointer</a> is not null,
3297: and the newly created element doesn't have a <code title="attr-fae-form"><a href="forms.html#attr-fae-form">form</a></code> attribute, the user agent must
3298: <a href="forms.html#concept-form-association" title="concept-form-association">associate</a> the newly
3299: created element with the <code><a href="forms.html#the-form-element">form</a></code> element pointed to by the
3300: <a href="#form-element-pointer"><code title="">form</code> element pointer</a> before
3301: inserting it wherever it is to be inserted.</p>
3302:
3303: <hr><p>When the steps below require the UA to <dfn id="insert-a-foreign-element">insert a foreign
3304: element</dfn> for a token, the UA must first <a href="#create-an-element-for-the-token">create an element
3305: for the token</a> in the given namespace, and then append this
3306: node to the <a href="#current-node">current node</a>, and push it onto the
3307: <a href="#stack-of-open-elements">stack of open elements</a> so that it is the new
3308: <a href="#current-node">current node</a>. If the newly created element has an <code title="">xmlns</code> attribute in the <a href="#xmlns-namespace">XMLNS namespace</a>
3309: whose value is not exactly the same as the element's namespace, that
3310: is a <a href="#parse-error">parse error</a>. Similarly, if the newly created
3311: element has an <code title="">xmlns:xlink</code> attribute in the
3312: <a href="#xmlns-namespace">XMLNS namespace</a> whose value is not the <a href="#xlink-namespace">XLink
3313: Namespace</a>, that is a <a href="#parse-error">parse error</a>.</p>
3314:
3315: <p>When the steps below require the user agent to <dfn id="adjust-mathml-attributes">adjust MathML
3316: attributes</dfn> for a token, then, if the token has an attribute
3317: named <code title="">definitionurl</code>, change its name to <code title="">definitionURL</code> (note the case difference).</p>
3318:
3319: <p>When the steps below require the user agent to <dfn id="adjust-svg-attributes">adjust SVG
3320: attributes</dfn> for a token, then, for each attribute on the token
3321: whose attribute name is one of the ones in the first column of the
3322: following table, change the attribute's name to the name given in
3323: the corresponding cell in the second column. (This fixes the case of
3324: SVG attributes that are not all lowercase.)</p>
3325:
3326: <table><thead><tr><th> Attribute name on token </th><th> Attribute name on element
3327: </th></tr></thead><tbody><tr><td> <code title="">attributename</code> </td><td> <code title="">attributeName</code>
3328: </td></tr><tr><td> <code title="">attributetype</code> </td><td> <code title="">attributeType</code>
3329: </td></tr><tr><td> <code title="">basefrequency</code> </td><td> <code title="">baseFrequency</code>
3330: </td></tr><tr><td> <code title="">baseprofile</code> </td><td> <code title="">baseProfile</code>
3331: </td></tr><tr><td> <code title="">calcmode</code> </td><td> <code title="">calcMode</code>
3332: </td></tr><tr><td> <code title="">clippathunits</code> </td><td> <code title="">clipPathUnits</code>
3333: </td></tr><tr><td> <code title="">contentscripttype</code> </td><td> <code title="">contentScriptType</code>
3334: </td></tr><tr><td> <code title="">contentstyletype</code> </td><td> <code title="">contentStyleType</code>
3335: </td></tr><tr><td> <code title="">diffuseconstant</code> </td><td> <code title="">diffuseConstant</code>
3336: </td></tr><tr><td> <code title="">edgemode</code> </td><td> <code title="">edgeMode</code>
3337: </td></tr><tr><td> <code title="">externalresourcesrequired</code> </td><td> <code title="">externalResourcesRequired</code>
3338: </td></tr><tr><td> <code title="">filterres</code> </td><td> <code title="">filterRes</code>
3339: </td></tr><tr><td> <code title="">filterunits</code> </td><td> <code title="">filterUnits</code>
3340: </td></tr><tr><td> <code title="">glyphref</code> </td><td> <code title="">glyphRef</code>
3341: </td></tr><tr><td> <code title="">gradienttransform</code> </td><td> <code title="">gradientTransform</code>
3342: </td></tr><tr><td> <code title="">gradientunits</code> </td><td> <code title="">gradientUnits</code>
3343: </td></tr><tr><td> <code title="">kernelmatrix</code> </td><td> <code title="">kernelMatrix</code>
3344: </td></tr><tr><td> <code title="">kernelunitlength</code> </td><td> <code title="">kernelUnitLength</code>
3345: </td></tr><tr><td> <code title="">keypoints</code> </td><td> <code title="">keyPoints</code>
3346: </td></tr><tr><td> <code title="">keysplines</code> </td><td> <code title="">keySplines</code>
3347: </td></tr><tr><td> <code title="">keytimes</code> </td><td> <code title="">keyTimes</code>
3348: </td></tr><tr><td> <code title="">lengthadjust</code> </td><td> <code title="">lengthAdjust</code>
3349: </td></tr><tr><td> <code title="">limitingconeangle</code> </td><td> <code title="">limitingConeAngle</code>
3350: </td></tr><tr><td> <code title="">markerheight</code> </td><td> <code title="">markerHeight</code>
3351: </td></tr><tr><td> <code title="">markerunits</code> </td><td> <code title="">markerUnits</code>
3352: </td></tr><tr><td> <code title="">markerwidth</code> </td><td> <code title="">markerWidth</code>
3353: </td></tr><tr><td> <code title="">maskcontentunits</code> </td><td> <code title="">maskContentUnits</code>
3354: </td></tr><tr><td> <code title="">maskunits</code> </td><td> <code title="">maskUnits</code>
3355: </td></tr><tr><td> <code title="">numoctaves</code> </td><td> <code title="">numOctaves</code>
3356: </td></tr><tr><td> <code title="">pathlength</code> </td><td> <code title="">pathLength</code>
3357: </td></tr><tr><td> <code title="">patterncontentunits</code> </td><td> <code title="">patternContentUnits</code>
3358: </td></tr><tr><td> <code title="">patterntransform</code> </td><td> <code title="">patternTransform</code>
3359: </td></tr><tr><td> <code title="">patternunits</code> </td><td> <code title="">patternUnits</code>
3360: </td></tr><tr><td> <code title="">pointsatx</code> </td><td> <code title="">pointsAtX</code>
3361: </td></tr><tr><td> <code title="">pointsaty</code> </td><td> <code title="">pointsAtY</code>
3362: </td></tr><tr><td> <code title="">pointsatz</code> </td><td> <code title="">pointsAtZ</code>
3363: </td></tr><tr><td> <code title="">preservealpha</code> </td><td> <code title="">preserveAlpha</code>
3364: </td></tr><tr><td> <code title="">preserveaspectratio</code> </td><td> <code title="">preserveAspectRatio</code>
3365: </td></tr><tr><td> <code title="">primitiveunits</code> </td><td> <code title="">primitiveUnits</code>
3366: </td></tr><tr><td> <code title="">refx</code> </td><td> <code title="">refX</code>
3367: </td></tr><tr><td> <code title="">refy</code> </td><td> <code title="">refY</code>
3368: </td></tr><tr><td> <code title="">repeatcount</code> </td><td> <code title="">repeatCount</code>
3369: </td></tr><tr><td> <code title="">repeatdur</code> </td><td> <code title="">repeatDur</code>
3370: </td></tr><tr><td> <code title="">requiredextensions</code> </td><td> <code title="">requiredExtensions</code>
3371: </td></tr><tr><td> <code title="">requiredfeatures</code> </td><td> <code title="">requiredFeatures</code>
3372: </td></tr><tr><td> <code title="">specularconstant</code> </td><td> <code title="">specularConstant</code>
3373: </td></tr><tr><td> <code title="">specularexponent</code> </td><td> <code title="">specularExponent</code>
3374: </td></tr><tr><td> <code title="">spreadmethod</code> </td><td> <code title="">spreadMethod</code>
3375: </td></tr><tr><td> <code title="">startoffset</code> </td><td> <code title="">startOffset</code>
3376: </td></tr><tr><td> <code title="">stddeviation</code> </td><td> <code title="">stdDeviation</code>
3377: </td></tr><tr><td> <code title="">stitchtiles</code> </td><td> <code title="">stitchTiles</code>
3378: </td></tr><tr><td> <code title="">surfacescale</code> </td><td> <code title="">surfaceScale</code>
3379: </td></tr><tr><td> <code title="">systemlanguage</code> </td><td> <code title="">systemLanguage</code>
3380: </td></tr><tr><td> <code title="">tablevalues</code> </td><td> <code title="">tableValues</code>
3381: </td></tr><tr><td> <code title="">targetx</code> </td><td> <code title="">targetX</code>
3382: </td></tr><tr><td> <code title="">targety</code> </td><td> <code title="">targetY</code>
3383: </td></tr><tr><td> <code title="">textlength</code> </td><td> <code title="">textLength</code>
3384: </td></tr><tr><td> <code title="">viewbox</code> </td><td> <code title="">viewBox</code>
3385: </td></tr><tr><td> <code title="">viewtarget</code> </td><td> <code title="">viewTarget</code>
3386: </td></tr><tr><td> <code title="">xchannelselector</code> </td><td> <code title="">xChannelSelector</code>
3387: </td></tr><tr><td> <code title="">ychannelselector</code> </td><td> <code title="">yChannelSelector</code>
3388: </td></tr><tr><td> <code title="">zoomandpan</code> </td><td> <code title="">zoomAndPan</code>
3389: </td></tr></tbody></table><p>When the steps below require the user agent to <dfn id="adjust-foreign-attributes">adjust
3390: foreign attributes</dfn> for a token, then, if any of the attributes
3391: on the token match the strings given in the first column of the
3392: following table, let the attribute be a namespaced attribute, with
3393: the prefix being the string given in the corresponding cell in the
3394: second column, the local name being the string given in the
3395: corresponding cell in the third column, and the namespace being the
3396: namespace given in the corresponding cell in the fourth
3397: column. (This fixes the use of namespaced attributes, in particular
3398: <a href="dom.html#attr-xml-lang" title="attr-xml-lang"><code title="">lang</code> attributes in
3399: the <span>XML namespace</span></a>.)</p>
3400:
3401: <table><thead><tr><th> Attribute name </th><th> Prefix </th><th> Local name </th><th> Namespace
3402: </th></tr></thead><tbody><tr><td> <code title="">xlink:actuate</code> </td><td> <code title="">xlink</code> </td><td> <code title="">actuate</code> </td><td> <a href="#xlink-namespace">XLink namespace</a>
3403: </td></tr><tr><td> <code title="">xlink:arcrole</code> </td><td> <code title="">xlink</code> </td><td> <code title="">arcrole</code> </td><td> <a href="#xlink-namespace">XLink namespace</a>
3404: </td></tr><tr><td> <code title="">xlink:href</code> </td><td> <code title="">xlink</code> </td><td> <code title="">href</code> </td><td> <a href="#xlink-namespace">XLink namespace</a>
3405: </td></tr><tr><td> <code title="">xlink:role</code> </td><td> <code title="">xlink</code> </td><td> <code title="">role</code> </td><td> <a href="#xlink-namespace">XLink namespace</a>
3406: </td></tr><tr><td> <code title="">xlink:show</code> </td><td> <code title="">xlink</code> </td><td> <code title="">show</code> </td><td> <a href="#xlink-namespace">XLink namespace</a>
3407: </td></tr><tr><td> <code title="">xlink:title</code> </td><td> <code title="">xlink</code> </td><td> <code title="">title</code> </td><td> <a href="#xlink-namespace">XLink namespace</a>
3408: </td></tr><tr><td> <code title="">xlink:type</code> </td><td> <code title="">xlink</code> </td><td> <code title="">type</code> </td><td> <a href="#xlink-namespace">XLink namespace</a>
3409: </td></tr><tr><td> <code title="">xml:base</code> </td><td> <code title="">xml</code> </td><td> <code title="">base</code> </td><td> <a href="#xml-namespace">XML namespace</a> <!-- attr-xml-base -->
3410: </td></tr><tr><td> <code title="">xml:lang</code> </td><td> <code title="">xml</code> </td><td> <code title="">lang</code> </td><td> <a href="#xml-namespace">XML namespace</a>
3411: </td></tr><tr><td> <code title="">xml:space</code> </td><td> <code title="">xml</code> </td><td> <code title="">space</code> </td><td> <a href="#xml-namespace">XML namespace</a>
3412: </td></tr><tr><td> <code title="">xmlns</code> </td><td> (none) </td><td> <code title="">xmlns</code> </td><td> <a href="#xmlns-namespace">XMLNS namespace</a>
3413: </td></tr><tr><td> <code title="">xmlns:xlink</code> </td><td> <code title="">xmlns</code> </td><td> <code title="">xlink</code> </td><td> <a href="#xmlns-namespace">XMLNS namespace</a>
3414: </td></tr></tbody></table><hr><p>The <dfn id="generic-cdata-element-parsing-algorithm">generic CDATA element parsing algorithm</dfn> and the
3415: <dfn id="generic-rcdata-element-parsing-algorithm">generic RCDATA element parsing algorithm</dfn> consist of the
3416: following steps. These algorithms are always invoked in response to
3417: a start tag token.</p>
3418:
3419: <ol><li><p><a href="#insert-an-html-element">Insert an HTML element</a> for the token.</p></li>
3420:
3421: <li><p>If the algorithm that was invoked is the <a href="#generic-cdata-element-parsing-algorithm">generic CDATA
3422: element parsing algorithm</a>, switch the tokenizer's
3423: <a href="#content-model-flag">content model flag</a> to the CDATA state; otherwise the
3424: algorithm invoked was the <a href="#generic-rcdata-element-parsing-algorithm">generic RCDATA element parsing
3425: algorithm</a>, switch the tokenizer's <a href="#content-model-flag">content model
3426: flag</a> to the RCDATA state.</p></li>
3427:
3428: <li><p>Let the <a href="#original-insertion-mode">original insertion mode</a> be the current
3429: <a href="#insertion-mode">insertion mode</a>.</p>
3430:
3431: </li><li><p>Then, switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-incdata" title="insertion mode: in CDATA/RCDATA">in
3432: CDATA/RCDATA</a>".</p></li>
3433:
3434: </ol><h5 id="closing-elements-that-have-implied-end-tags"><span class="secno">9.2.5.2 </span>Closing elements that have implied end tags</h5>
3435:
3436: <p>When the steps below require the UA to <dfn id="generate-implied-end-tags">generate implied end
3437: tags</dfn>, then, while the <a href="#current-node">current node</a> is a
3438: <code><a href="semantics.html#the-dd-element">dd</a></code> element, a <code><a href="semantics.html#the-dt-element">dt</a></code> element, an
3439: <code><a href="semantics.html#the-li-element">li</a></code> element, an <code><a href="forms.html#the-option-element">option</a></code> element, an
3440: <code><a href="forms.html#the-optgroup-element">optgroup</a></code> element, a <code><a href="semantics.html#the-p-element">p</a></code> element, an
3441: <code><a href="text-level-semantics.html#the-rp-element">rp</a></code> element, or an <code><a href="text-level-semantics.html#the-rt-element">rt</a></code> element, the UA must
3442: pop the <a href="#current-node">current node</a> off the <a href="#stack-of-open-elements">stack of open
3443: elements</a>.</p>
3444:
3445: <p>If a step requires the UA to generate implied end tags but lists
3446: an element to exclude from the process, then the UA must perform the
3447: above steps as if that element was not in the above list.</p>
3448:
3449:
3450: <h5 id="foster-parenting"><span class="secno">9.2.5.3 </span>Foster parenting</h5>
3451:
3452: <p>Foster parenting happens when content is misnested in tables.</p>
3453:
3454: <p>When a node <var title="">node</var> is to be <dfn id="foster-parent" title="foster
3455: parent">foster parented</dfn>, the node <var title="">node</var>
3456: must be inserted into the <i><a href="#foster-parent-element">foster parent element</a></i>.</p>
3457:
3458: <p>The <dfn id="foster-parent-element">foster parent element</dfn> is the parent element of the
3459: last <code><a href="tabular-data.html#the-table-element">table</a></code> element in the <a href="#stack-of-open-elements">stack of open
3460: elements</a>, if there is a <code><a href="tabular-data.html#the-table-element">table</a></code> element and it has
3461: such a parent element. If there is no <code><a href="tabular-data.html#the-table-element">table</a></code> element in
3462: the <a href="#stack-of-open-elements">stack of open elements</a> (<a href="#fragment-case">fragment
3463: case</a>), then the <i><a href="#foster-parent-element">foster parent element</a></i> is the first
3464: element in the <a href="#stack-of-open-elements">stack of open elements</a> (the
3465: <code><a href="semantics.html#the-html-element">html</a></code> element). Otherwise, if there is a
3466: <code><a href="tabular-data.html#the-table-element">table</a></code> element in the <a href="#stack-of-open-elements">stack of open
3467: elements</a>, but the last <code><a href="tabular-data.html#the-table-element">table</a></code> element in the
3468: <a href="#stack-of-open-elements">stack of open elements</a> has no parent, or its parent
3469: node is not an element, then the <i><a href="#foster-parent-element">foster parent element</a></i> is
3470: the element before the last <code><a href="tabular-data.html#the-table-element">table</a></code> element in the
3471: <a href="#stack-of-open-elements">stack of open elements</a>.</p>
3472:
3473: <p>If the <i><a href="#foster-parent-element">foster parent element</a></i> is the parent element of the
3474: last <code><a href="tabular-data.html#the-table-element">table</a></code> element in the <a href="#stack-of-open-elements">stack of open
3475: elements</a>, then <var title="">node</var> must be inserted
3476: immediately <em>before</em> the last <code><a href="tabular-data.html#the-table-element">table</a></code> element in
3477: the <a href="#stack-of-open-elements">stack of open elements</a> in the <i><a href="#foster-parent-element">foster parent
3478: element</a></i>; otherwise, <var title="">node</var> must be
3479: <em>appended</em> to the <i><a href="#foster-parent-element">foster parent element</a></i>.</p>
3480:
3481:
3482:
3483: <h5 id="the-initial-insertion-mode"><span class="secno">9.2.5.4 </span>The "<dfn title="insertion mode: initial">initial</dfn>" insertion mode</h5>
3484:
3485: <p>When the <a href="#insertion-mode">insertion mode</a> is "<a href="#the-initial-insertion-mode" title="insertion
3486: mode: initial">initial</a>", tokens must be handled as follows:</p>
3487:
3488: <dl class="switch"><dt>A character token that is one of U+0009 CHARACTER
3489: TABULATION, U+000A LINE FEED (LF), U+000C FORM FEED (FF),
3490: <!--U+000D CARRIAGE RETURN (CR),--> or U+0020 SPACE</dt>
3491: <dd>
3492: <p>Ignore the token.</p>
3493: </dd>
3494:
3495: <dt>A comment token</dt>
3496: <dd>
3497: <p>Append a <code>Comment</code> node to the <code>Document</code>
3498: object with the <code title="">data</code> attribute set to the
3499: data given in the comment token.</p>
3500: </dd>
3501:
3502: <dt>A DOCTYPE token</dt>
3503: <dd>
3504:
3505: <p>If the DOCTYPE token's name is not a
3506: <a href="infrastructure.html#case-sensitive">case-sensitive</a> match for the string "<code title="">html</code>", or the token's public identifier is not
3507: missing, or the token's system identifier is neither missing nor a
3508: <a href="infrastructure.html#case-sensitive">case-sensitive</a> match for the string
3509: "<code>about:legacy-compat</code>", and none of the sets of
3510: conditions in the following list are matched, then there is a
3511: <a href="#parse-error">parse error</a>. If one of the sets of conditions in the
3512: following list is matched, then there is an <dfn id="obsolete-permitted-doctype">obsolete
3513: permitted DOCTYPE</dfn>.</p>
3514:
3515: <ul><!-- only things that trigger no-quirks mode and were valid in
3516: some other spec are allowed in this list --><li>The DOCTYPE token's name is an <a href="infrastructure.html#ascii-case-insensitive">ASCII
3517: case-insensitive</a> match for the string "<code title="">HTML</code>", the token's public identifier is the
3518: <a href="infrastructure.html#case-sensitive">case-sensitive</a> string "<code title="">-//W3C//DTD HTML 4.0//EN</code>", and the
3519: token's system identifier is either missing or the
3520: <a href="infrastructure.html#case-sensitive">case-sensitive</a> string "<code title="">http://www.w3.org/TR/REC-html40/strict.dtd</code>".</li>
3521:
3522: <li>The DOCTYPE token's name is an <a href="infrastructure.html#ascii-case-insensitive">ASCII
3523: case-insensitive</a> match for the string "<code title="">HTML</code>", the token's public identifier is the
3524: <a href="infrastructure.html#case-sensitive">case-sensitive</a> string "<code title="">-//W3C//DTD HTML 4.01//EN</code>", and the
3525: token's system identifier is either missing or the
3526: <a href="infrastructure.html#case-sensitive">case-sensitive</a> string "<code title="">http://www.w3.org/TR/html4/strict.dtd</code>".</li>
3527:
3528: <li>The DOCTYPE token's name is an <a href="infrastructure.html#ascii-case-insensitive">ASCII
3529: case-insensitive</a> match for the string "<code title="">HTML</code>", the token's public identifier is the
3530: <a href="infrastructure.html#case-sensitive">case-sensitive</a> string "<code title="">-//W3C//DTD XHTML 1.0 Strict//EN</code>",
3531: and the token's system identifier is the
3532: <a href="infrastructure.html#case-sensitive">case-sensitive</a> string "<code title="">http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd</code>".</li>
3533:
3534: <li>The DOCTYPE token's name is an <a href="infrastructure.html#ascii-case-insensitive">ASCII
3535: case-insensitive</a> match for the string "<code title="">HTML</code>", the token's public identifier is the
3536: <a href="infrastructure.html#case-sensitive">case-sensitive</a> string "<code title="">-//W3C//DTD XHTML 1.1//EN</code>", and the
3537: token's system identifier is the <a href="infrastructure.html#case-sensitive">case-sensitive</a>
3538: string "<code title="">http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd</code>".</li>
3539:
3540: </ul><p>Conformance checkers may, based on the values (including
3541: presence or lack thereof) of the DOCTYPE token's name, public
3542: identifier, or system identifier, switch to a conformance checking
3543: mode for another language (e.g. based on the DOCTYPE token a
3544: conformance checker could recognize that the document is an
3545: HTML 4-era document, and defer to an HTML 4 conformance
3546: checker.)</p>
3547:
3548: <p>Append a <code>DocumentType</code> node to the
3549: <code>Document</code> node, with the <code title="">name</code>
3550: attribute set to the name given in the DOCTYPE token, or the empty
3551: string if the name was missing; the <code title="">publicId</code>
3552: attribute set to the public identifier given in the DOCTYPE token,
3553: or the empty string if the public identifier was missing; the
3554: <code title="">systemId</code> attribute set to the system
3555: identifier given in the DOCTYPE token, or the empty string if the
3556: system identifier was missing; and the other attributes specific
3557: to <code>DocumentType</code> objects set to null and empty lists
3558: as appropriate. Associate the <code>DocumentType</code> node with
3559: the <code>Document</code> object so that it is returned as the
3560: value of the <code title="">doctype</code> attribute of the
3561: <code>Document</code> object.</p>
3562:
3563: <p id="quirks-mode-doctypes">Then, if the DOCTYPE token matches
3564: one of the conditions in the following list, then set the
3565: <code>Document</code> to <a href="dom.html#quirks-mode">quirks mode</a>:</p>
3566:
3567: <ul class="brief"><li> The <i>force-quirks flag</i> is set to <i>on</i>. </li>
3568: <li> The name is set to anything other than "<code title="">HTML</code>". </li>
3569: <li> The public identifier starts with: "<code title="">+//Silmaril//dtd html Pro v0r11 19970101//<!--EN--></code>" </li>
3570: <li> The public identifier starts with: "<code title="">-//AdvaSoft Ltd//DTD HTML 3.0 asWedit + extensions//<!--EN--></code>" </li>
3571: <li> The public identifier starts with: "<code title="">-//AS//DTD HTML 3.0 asWedit + extensions//<!--EN--></code>" </li>
3572: <li> The public identifier starts with: "<code title="">-//IETF//DTD HTML 2.0 Level 1//<!--EN--></code>" </li>
3573: <li> The public identifier starts with: "<code title="">-//IETF//DTD HTML 2.0 Level 2//<!--EN--></code>" </li>
3574: <li> The public identifier starts with: "<code title="">-//IETF//DTD HTML 2.0 Strict Level 1//<!--EN--></code>" </li>
3575: <li> The public identifier starts with: "<code title="">-//IETF//DTD HTML 2.0 Strict Level 2//<!--EN--></code>" </li>
3576: <li> The public identifier starts with: "<code title="">-//IETF//DTD HTML 2.0 Strict//<!--EN--></code>" </li>
3577: <li> The public identifier starts with: "<code title="">-//IETF//DTD HTML 2.0//<!--EN--></code>" </li>
3578: <li> The public identifier starts with: "<code title="">-//IETF//DTD HTML 2.1E//<!--EN--></code>" </li>
3579: <li> The public identifier starts with: "<code title="">-//IETF//DTD HTML 3.0//<!--EN--></code>" </li>
3580: <!--<li> The public identifier is set to: "<code title="">-//IETF//DTD HTML 3.0//EN//</code>" </li>-->
3581: <li> The public identifier starts with: "<code title="">-//IETF//DTD HTML 3.2 Final//<!--EN--></code>" </li>
3582: <li> The public identifier starts with: "<code title="">-//IETF//DTD HTML 3.2//<!--EN--></code>" </li>
3583: <li> The public identifier starts with: "<code title="">-//IETF//DTD HTML 3//<!--EN--></code>" </li>
3584: <li> The public identifier starts with: "<code title="">-//IETF//DTD HTML Level 0//<!--EN--></code>" </li>
3585: <!--<li> The public identifier is set to: "<code title="">-//IETF//DTD HTML Level 0//EN//2.0</code>" </li>-->
3586: <li> The public identifier starts with: "<code title="">-//IETF//DTD HTML Level 1//<!--EN--></code>" </li>
3587: <!--<li> The public identifier is set to: "<code title="">-//IETF//DTD HTML Level 1//EN//2.0</code>" </li>-->
3588: <li> The public identifier starts with: "<code title="">-//IETF//DTD HTML Level 2//<!--EN--></code>" </li>
3589: <!--<li> The public identifier is set to: "<code title="">-//IETF//DTD HTML Level 2//EN//2.0</code>" </li>-->
3590: <li> The public identifier starts with: "<code title="">-//IETF//DTD HTML Level 3//<!--EN--></code>" </li>
3591: <!--<li> The public identifier is set to: "<code title="">-//IETF//DTD HTML Level 3//EN//3.0</code>" </li>-->
3592: <li> The public identifier starts with: "<code title="">-//IETF//DTD HTML Strict Level 0//<!--EN--></code>" </li>
3593: <!--<li> The public identifier is set to: "<code title="">-//IETF//DTD HTML Strict Level 0//EN//2.0</code>" </li>-->
3594: <li> The public identifier starts with: "<code title="">-//IETF//DTD HTML Strict Level 1//<!--EN--></code>" </li>
3595: <!--<li> The public identifier is set to: "<code title="">-//IETF//DTD HTML Strict Level 1//EN//2.0</code>" </li>-->
3596: <li> The public identifier starts with: "<code title="">-//IETF//DTD HTML Strict Level 2//<!--EN--></code>" </li>
3597: <!--<li> The public identifier is set to: "<code title="">-//IETF//DTD HTML Strict Level 2//EN//2.0</code>" </li>-->
3598: <li> The public identifier starts with: "<code title="">-//IETF//DTD HTML Strict Level 3//<!--EN--></code>" </li>
3599: <!--<li> The public identifier is set to: "<code title="">-//IETF//DTD HTML Strict Level 3//EN//3.0</code>" </li>-->
3600: <li> The public identifier starts with: "<code title="">-//IETF//DTD HTML Strict//<!--EN--></code>" </li>
3601: <!--<li> The public identifier is set to: "<code title="">-//IETF//DTD HTML Strict//EN//2.0</code>" </li>-->
3602: <!--<li> The public identifier is set to: "<code title="">-//IETF//DTD HTML Strict//EN//3.0</code>" </li>-->
3603: <li> The public identifier starts with: "<code title="">-//IETF//DTD HTML//<!--EN--></code>" </li>
3604: <!--<li> The public identifier is set to: "<code title="">-//IETF//DTD HTML//EN//2.0</code>" </li>-->
3605: <!--<li> The public identifier is set to: "<code title="">-//IETF//DTD HTML//EN//3.0</code>" </li>-->
3606: <li> The public identifier starts with: "<code title="">-//Metrius//DTD Metrius Presentational//<!--EN--></code>" </li>
3607: <li> The public identifier starts with: "<code title="">-//Microsoft//DTD Internet Explorer 2.0 HTML Strict//<!--EN--></code>" </li>
3608: <li> The public identifier starts with: "<code title="">-//Microsoft//DTD Internet Explorer 2.0 HTML//<!--EN--></code>" </li>
3609: <li> The public identifier starts with: "<code title="">-//Microsoft//DTD Internet Explorer 2.0 Tables//<!--EN--></code>" </li>
3610: <li> The public identifier starts with: "<code title="">-//Microsoft//DTD Internet Explorer 3.0 HTML Strict//<!--EN--></code>" </li>
3611: <li> The public identifier starts with: "<code title="">-//Microsoft//DTD Internet Explorer 3.0 HTML//<!--EN--></code>" </li>
3612: <li> The public identifier starts with: "<code title="">-//Microsoft//DTD Internet Explorer 3.0 Tables//<!--EN--></code>" </li>
3613: <li> The public identifier starts with: "<code title="">-//Netscape Comm. Corp.//DTD HTML//<!--EN--></code>" </li>
3614: <li> The public identifier starts with: "<code title="">-//Netscape Comm. Corp.//DTD Strict HTML//<!--EN--></code>" </li>
3615: <li> The public identifier starts with: "<code title="">-//O'Reilly and Associates//DTD HTML 2.0//<!--EN--></code>" </li>
3616: <li> The public identifier starts with: "<code title="">-//O'Reilly and Associates//DTD HTML Extended 1.0//<!--EN--></code>" </li>
3617: <li> The public identifier starts with: "<code title="">-//O'Reilly and Associates//DTD HTML Extended Relaxed 1.0//<!--EN--></code>" </li>
3618: <li> The public identifier starts with: "<code title="">-//SoftQuad Software//DTD HoTMetaL PRO 6.0::19990601::extensions to HTML 4.0//<!--EN--></code>" </li>
3619: <li> The public identifier starts with: "<code title="">-//SoftQuad//DTD HoTMetaL PRO 4.0::19971010::extensions to HTML 4.0//<!--EN--></code>" </li>
3620: <li> The public identifier starts with: "<code title="">-//Spyglass//DTD HTML 2.0 Extended//<!--EN--></code>" </li>
3621: <li> The public identifier starts with: "<code title="">-//SQ//DTD HTML 2.0 HoTMetaL + extensions//<!--EN--></code>" </li>
3622: <li> The public identifier starts with: "<code title="">-//Sun Microsystems Corp.//DTD HotJava HTML//<!--EN--></code>" </li>
3623: <li> The public identifier starts with: "<code title="">-//Sun Microsystems Corp.//DTD HotJava Strict HTML//<!--EN--></code>" </li>
3624: <li> The public identifier starts with: "<code title="">-//W3C//DTD HTML 3 1995-03-24//<!--EN--></code>" </li>
3625: <li> The public identifier starts with: "<code title="">-//W3C//DTD HTML 3.2 Draft//<!--EN--></code>" </li>
3626: <li> The public identifier starts with: "<code title="">-//W3C//DTD HTML 3.2 Final//<!--EN--></code>" </li>
3627: <li> The public identifier starts with: "<code title="">-//W3C//DTD HTML 3.2//<!--EN--></code>" </li>
3628: <li> The public identifier starts with: "<code title="">-//W3C//DTD HTML 3.2S Draft//<!--EN--></code>" </li>
3629: <li> The public identifier starts with: "<code title="">-//W3C//DTD HTML 4.0 Frameset//<!--EN--></code>" </li>
3630: <li> The public identifier starts with: "<code title="">-//W3C//DTD HTML 4.0 Transitional//<!--EN--></code>" </li>
3631: <li> The public identifier starts with: "<code title="">-//W3C//DTD HTML Experimental 19960712//<!--EN--></code>" </li>
3632: <li> The public identifier starts with: "<code title="">-//W3C//DTD HTML Experimental 970421//<!--EN--></code>" </li>
3633: <li> The public identifier starts with: "<code title="">-//W3C//DTD W3 HTML//<!--EN--></code>" </li>
3634: <li> The public identifier starts with: "<code title="">-//W3O//DTD W3 HTML 3.0//<!--EN--></code>" </li>
3635: <!--<li> The public identifier is set to: "<code title="">-//W3O//DTD W3 HTML 3.0//EN//</code>" </li>-->
3636: <li> The public identifier is set to: "<code title="">-//W3O//DTD W3 HTML Strict 3.0//EN//</code>" </li>
3637: <li> The public identifier starts with: "<code title="">-//WebTechs//DTD Mozilla HTML 2.0//<!--EN--></code>" </li>
3638: <li> The public identifier starts with: "<code title="">-//WebTechs//DTD Mozilla HTML//<!--EN--></code>" </li>
3639: <li> The public identifier is set to: "<code title="">-/W3C/DTD HTML 4.0 Transitional/EN</code>" </li>
3640: <li> The public identifier is set to: "<code title="">HTML</code>" </li>
3641: <li> The system identifier is set to: "<code title="">http://www.ibm.com/data/dtd/v11/ibmxhtml1-transitional.dtd</code>" </li>
3642: <li> The system identifier is missing and the public identifier starts with: "<code title="">-//W3C//DTD HTML 4.01 Frameset//<!--EN--></code>" </li>
3643: <li> The system identifier is missing and the public identifier starts with: "<code title="">-//W3C//DTD HTML 4.01 Transitional//<!--EN--></code>" </li>
3644: </ul><p>Otherwise, if the DOCTYPE token matches one of the conditions
3645: in the following list, then set the <code>Document</code> to
3646: <a href="dom.html#limited-quirks-mode">limited quirks mode</a>:</p>
3647:
3648: <ul class="brief"><li> The public identifier starts with: "<code title="">-//W3C//DTD XHTML 1.0 Frameset//<!--EN--></code>" </li>
3649: <li> The public identifier starts with: "<code title="">-//W3C//DTD XHTML 1.0 Transitional//<!--EN--></code>" </li>
3650: <li> The system identifier is not missing and the public identifier starts with: "<code title="">-//W3C//DTD HTML 4.01 Frameset//<!--EN--></code>" </li>
3651: <li> The system identifier is not missing and the public identifier starts with: "<code title="">-//W3C//DTD HTML 4.01 Transitional//<!--EN--></code>" </li>
3652: </ul><p>The name, system identifier, and public identifier strings must
3653: be compared to the values given in the lists above in an
3654: <a href="infrastructure.html#ascii-case-insensitive">ASCII case-insensitive</a> manner. A system identifier
3655: whose value is the empty string is not considered missing for the
3656: purposes of the conditions above.</p>
3657:
3658: <p>Then, switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#the-before-html-insertion-mode" title="insertion mode: before html">before html</a>".</p>
3659:
3660: </dd>
3661:
3662: <dt>Anything else</dt>
3663: <dd>
3664:
3665: <p><a href="#parse-error">Parse error</a>.</p>
3666:
3667: <p>Set the <code>Document</code> to <a href="dom.html#quirks-mode">quirks mode</a>.</p>
3668:
3669: <p>Switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#the-before-html-insertion-mode" title="insertion mode: before html">before html</a>", then
3670: reprocess the current token.</p>
3671:
3672: </dd>
3673:
3674: </dl><h5 id="the-before-html-insertion-mode"><span class="secno">9.2.5.5 </span>The "<dfn title="insertion mode: before html">before html</dfn>" insertion mode</h5>
3675:
3676: <p>When the <a href="#insertion-mode">insertion mode</a> is "<a href="#the-before-html-insertion-mode" title="insertion
3677: mode: before html">before html</a>", tokens must be handled as follows:</p>
3678:
3679: <dl class="switch"><dt>A DOCTYPE token</dt>
3680: <dd>
3681: <p><a href="#parse-error">Parse error</a>. Ignore the token.</p>
3682: </dd>
3683:
3684: <dt>A comment token</dt>
3685: <dd>
3686: <p>Append a <code>Comment</code> node to the <code>Document</code>
3687: object with the <code title="">data</code> attribute set to the
3688: data given in the comment token.</p>
3689: </dd>
3690:
3691: <dt>A character token that is one of U+0009 CHARACTER
3692: TABULATION, U+000A LINE FEED (LF), U+000C FORM FEED (FF),
3693: <!--U+000D CARRIAGE RETURN (CR),--> or U+0020 SPACE</dt>
3694: <dd>
3695: <p>Ignore the token.</p>
3696: </dd>
3697:
3698: <dt>A start tag whose tag name is "html"</dt>
3699: <dd>
3700:
3701: <p><a href="#create-an-element-for-the-token">Create an element for the token</a> in the <a href="#html-namespace-0">HTML
3702: namespace</a>. Append it to the <code>Document</code>
3703: object. Put this element in the <a href="#stack-of-open-elements">stack of open
3704: elements</a>.</p>
3705:
3706: <p id="parser-appcache">If the <code>Document</code> is being
3707: loaded as part of <a href="history.html#navigate" title="navigate">navigation</a> of a
3708: <a href="browsers.html#browsing-context">browsing context</a>, then: if the newly created element
3709: has a <code title="attr-html-manifest"><a href="semantics.html#attr-html-manifest">manifest</a></code> attribute,
3710: then <a href="infrastructure.html#resolve-a-url" title="resolve a url">resolve</a> the value of that
3711: attribute to an <a href="infrastructure.html#absolute-url">absolute URL</a>, relative to the newly
3712: created element, and if that is successful, run the <a href="offline.html#concept-appcache-init" title="concept-appcache-init">application cache selection
3713: algorithm</a> with the resulting <a href="infrastructure.html#absolute-url">absolute URL</a>;
3714: otherwise, if there is no such attribute or resolving it fails,
3715: run the <a href="offline.html#concept-appcache-init" title="concept-appcache-init">application cache
3716: selection algorithm</a> with no manifest. The algorithm must be
3717: passed the <code>Document</code> object.</p>
3718:
3719: <p>Switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#the-before-head-insertion-mode" title="insertion mode: before head">before head</a>".</p>
3720:
3721: </dd>
3722:
3723: <dt>Anything else</dt>
3724: <dd>
3725:
3726: <p>Create an <code><a href="semantics.html#the-html-element">html</a></code> element. Append it to the
3727: <code>Document</code> object. Put this element in the <a href="#stack-of-open-elements">stack
3728: of open elements</a>.</p>
3729:
3730: <p>If the <code>Document</code> is being loaded as part of <a href="history.html#navigate" title="navigate">navigation</a> of a <a href="browsers.html#browsing-context">browsing
3731: context</a>, then: run the <a href="offline.html#concept-appcache-init" title="concept-appcache-init">application cache selection
3732: algorithm</a> with no manifest, passing it the
3733: <code>Document</code> object.</p>
3734:
3735: <p>Switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#the-before-head-insertion-mode" title="insertion mode: before head">before head</a>", then
3736: reprocess the current token.</p>
3737:
3738: <p class="XXX">Should probably make end tags be ignored, so
3739: that "</head><!-- --><html>" puts the comment before the
3740: root node (or should we?)</p>
3741:
3742: </dd>
3743:
3744: </dl><p>The root element can end up being removed from the
3745: <code>Document</code> object, e.g. by scripts; nothing in particular
3746: happens in such cases, content continues being appended to the nodes
3747: as described in the next section.</p>
3748:
3749:
3750: <h5 id="the-before-head-insertion-mode"><span class="secno">9.2.5.6 </span>The "<dfn title="insertion mode: before head">before head</dfn>" insertion mode</h5>
3751:
3752: <p>When the <a href="#insertion-mode">insertion mode</a> is "<a href="#the-before-head-insertion-mode" title="insertion
3753: mode: before head">before head</a>", tokens must be handled as follows:</p>
3754:
3755: <dl class="switch"><dt>A character token that is one of U+0009 CHARACTER
3756: TABULATION, U+000A LINE FEED (LF), U+000C FORM FEED (FF),
3757: <!--U+000D CARRIAGE RETURN (CR),--> or U+0020 SPACE</dt>
3758: <dd>
3759: <p>Ignore the token.</p> <!-- :-( -->
3760: </dd>
3761:
3762: <dt>A comment token</dt>
3763: <dd>
3764: <p>Append a <code>Comment</code> node to the <a href="#current-node">current
3765: node</a> with the <code title="">data</code> attribute set to
3766: the data given in the comment token.</p>
3767: </dd>
3768:
3769: <dt>A DOCTYPE token</dt>
3770: <dd>
3771: <p><a href="#parse-error">Parse error</a>. Ignore the token.</p>
3772: </dd>
3773:
3774: <dt>A start tag whose tag name is "html"</dt>
3775: <dd>
3776: <p>Process the token <a href="#using-the-rules-for">using the rules for</a> the "<a href="#parsing-main-inbody" title="insertion mode: in body">in body</a>" <a href="#insertion-mode">insertion
3777: mode</a>.</p>
3778: </dd>
3779:
3780: <dt>A start tag whose tag name is "head"</dt>
3781: <dd>
3782:
3783: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token.</p>
3784:
3785: <p>Set the <a href="#head-element-pointer"><code title="">head</code> element pointer</a>
3786: to the newly created <code><a href="semantics.html#the-head-element">head</a></code> element.</p>
3787:
3788: <p>Switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-inhead" title="insertion mode: in head">in head</a>".</p>
3789:
3790: </dd>
3791:
3792: <dt>An end tag whose tag name is one of: "head", "body", "html", "br"</dt>
3793: <dd>
3794:
3795: <p>Act as if a start tag token with the tag name "head" and no
3796: attributes had been seen, then reprocess the current token.</p>
3797:
3798: </dd>
3799:
3800: <dt>Any other end tag</dt>
3801: <dd>
3802:
3803: <p><a href="#parse-error">Parse error</a>. Ignore the token.</p>
3804:
3805: </dd>
3806:
3807: <dt>Anything else</dt>
3808: <dd>
3809:
3810: <p>Act as if a start tag token with the tag name "head" and no
3811: attributes had been seen, then reprocess the current
3812: token.</p>
3813:
3814: <p class="note">This will result in an empty <code><a href="semantics.html#the-head-element">head</a></code>
3815: element being generated, with the current token being
3816: reprocessed in the "<a href="#the-after-head-insertion-mode" title="insertion mode: after
3817: head">after head</a>" <a href="#insertion-mode">insertion mode</a>.</p>
3818:
3819: </dd>
3820:
3821: </dl><h5 id="parsing-main-inhead"><span class="secno">9.2.5.7 </span>The "<dfn title="insertion mode: in head">in head</dfn>" insertion mode</h5>
3822:
3823: <p>When the <a href="#insertion-mode">insertion mode</a> is "<a href="#parsing-main-inhead" title="insertion
3824: mode: in head">in head</a>", tokens must be handled as follows:</p>
3825:
3826: <dl class="switch"><dt>A character token that is one of U+0009 CHARACTER
3827: TABULATION, U+000A LINE FEED (LF), U+000C FORM FEED (FF),
3828: <!--U+000D CARRIAGE RETURN (CR),--> or U+0020 SPACE</dt>
3829: <dd>
3830: <p><a href="#insert-a-character" title="insert a character">Insert the character</a> into
3831: the <a href="#current-node">current node</a>.</p>
3832: </dd>
3833:
3834: <dt>A comment token</dt>
3835: <dd>
3836: <p>Append a <code>Comment</code> node to the <a href="#current-node">current
3837: node</a> with the <code title="">data</code> attribute set to
3838: the data given in the comment token.</p>
3839: </dd>
3840:
3841: <dt>A DOCTYPE token</dt>
3842: <dd>
3843: <p><a href="#parse-error">Parse error</a>. Ignore the token.</p>
3844: </dd>
3845:
3846: <dt>A start tag whose tag name is "html"</dt>
3847: <dd>
3848: <p>Process the token <a href="#using-the-rules-for">using the rules for</a> the "<a href="#parsing-main-inbody" title="insertion mode: in body">in body</a>" <a href="#insertion-mode">insertion
3849: mode</a>.</p>
3850: </dd>
3851:
3852: <dt>A start tag whose tag name is one of: "base", "command",
3853: "link"</dt>
3854: <dd>
3855:
3856: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token. Immediately
3857: pop the <a href="#current-node">current node</a> off the <a href="#stack-of-open-elements">stack of open
3858: elements</a>.</p>
3859:
3860: <p><a href="#acknowledge-self-closing-flag" title="acknowledge self-closing flag">Acknowledge the
3861: token's <i>self-closing flag</i></a>, if it is set.</p>
3862:
3863: </dd>
3864:
3865: <dt>A start tag whose tag name is "meta"</dt>
3866: <dd>
3867:
3868: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token. Immediately
3869: pop the <a href="#current-node">current node</a> off the <a href="#stack-of-open-elements">stack of open
3870: elements</a>.</p>
3871:
3872: <p><a href="#acknowledge-self-closing-flag" title="acknowledge self-closing flag">Acknowledge the
3873: token's <i>self-closing flag</i></a>, if it is set.</p>
3874:
3875: <p id="meta-charset-during-parse">If the element has a <code title="attr-meta-charset"><a href="semantics.html#attr-meta-charset">charset</a></code> attribute, and its
3876: value is a supported encoding, and the <a href="#concept-encoding-confidence" title="concept-encoding-confidence">confidence</a> is
3877: currently <i>tentative</i>, then <a href="#change-the-encoding">change the
3878: encoding</a> to the encoding given by the value of the
3879: <code title="attr-meta-charset"><a href="semantics.html#attr-meta-charset">charset</a></code> attribute.</p>
3880:
3881: <p>Otherwise, if the element has a <code title="attr-meta-charset"><a href="semantics.html#attr-meta-charset">content</a></code> attribute, and
3882: applying the <a href="infrastructure.html#algorithm-for-extracting-an-encoding-from-a-content-type">algorithm for extracting an encoding from a
3883: Content-Type</a> to its value returns a supported encoding
3884: <var title="">encoding</var>, and the <a href="#concept-encoding-confidence" title="concept-encoding-confidence">confidence</a> is
3885: currently <i>tentative</i>, then <a href="#change-the-encoding">change the
3886: encoding</a> to the encoding <var title="">encoding</var>.</p>
3887:
3888: </dd>
3889:
3890: <dt>A start tag whose tag name is "title"</dt>
3891: <dd>
3892: <p>Follow the <a href="#generic-rcdata-element-parsing-algorithm">generic RCDATA element parsing algorithm</a>.</p>
3893: </dd>
3894:
3895: <dt>A start tag whose tag name is "noscript", if the <a href="#scripting-flag">scripting flag</a> is enabled</dt>
3896: <dt>A start tag whose tag name is one of: "noframes", "style"</dt>
3897: <dd>
3898: <p>Follow the <a href="#generic-cdata-element-parsing-algorithm">generic CDATA element parsing algorithm</a>.</p>
3899: </dd>
3900:
3901: <dt>A start tag whose tag name is "noscript", if the <a href="#scripting-flag">scripting flag</a> is disabled</dt>
3902: <dd>
3903:
3904: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token.</p>
3905:
3906: <p>Switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-inheadnoscript" title="insertion mode: in head noscript">in head
3907: noscript</a>".</p>
3908:
3909: </dd>
3910:
3911: <dt id="scriptTag">A start tag whose tag name is "script"</dt>
3912: <dd>
3913:
3914: <ol><li><p><a href="#create-an-element-for-the-token">Create an element for the token</a> in the
3915: <a href="#html-namespace-0">HTML namespace</a>.</p></li>
3916:
3917: <li>
3918:
3919: <p>Mark the element as being <a href="semantics.html#parser-inserted">"parser-inserted"</a>.</p>
3920:
3921: <p class="note">This ensures that, if the script is external,
3922: any <code title="dom-document-write"><a href="dom.html#dom-document-write">document.write()</a></code>
3923: calls in the script will execute in-line, instead of blowing the
3924: document away, as would happen in most other cases. It also
3925: prevents the script from executing until the end tag is
3926: seen.</p>
3927:
3928: </li>
3929:
3930: <li><p>If the parser was originally created for the <a href="#html-fragment-parsing-algorithm">HTML
3931: fragment parsing algorithm</a>, then mark the
3932: <code><a href="semantics.html#script">script</a></code> element as <a href="semantics.html#already-executed">"already
3933: executed"</a>. (<a href="#fragment-case">fragment case</a>)</p></li>
3934:
3935: <li><p>Append the new element to the <a href="#current-node">current node</a>
3936: and push it onto the <a href="#stack-of-open-elements">stack of open
3937: elements</a>.</p></li>
3938:
3939: <li><p>Switch the tokenizer's <a href="#content-model-flag">content model flag</a> to
3940: the CDATA state.</p></li>
3941:
3942: <li><p>Let the <a href="#original-insertion-mode">original insertion mode</a> be the current
3943: <a href="#insertion-mode">insertion mode</a>.</p>
3944:
3945: </li><li><p>Switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-incdata" title="insertion mode: in CDATA/RCDATA">in
3946: CDATA/RCDATA</a>".</p></li>
3947:
3948: </ol></dd>
3949:
3950: <dt>An end tag whose tag name is "head"</dt>
3951: <dd>
3952:
3953: <p>Pop the <a href="#current-node">current node</a> (which will be the
3954: <code><a href="semantics.html#the-head-element">head</a></code> element) off the <a href="#stack-of-open-elements">stack of open
3955: elements</a>.</p>
3956:
3957: <p>Switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#the-after-head-insertion-mode" title="insertion mode: after head">after head</a>".</p>
3958:
3959: </dd>
3960:
3961: <dt>An end tag whose tag name is one of: "body", "html", "br"</dt>
3962: <dd>
3963: <p>Act as described in the "anything else" entry below.</p>
3964: </dd>
3965:
3966: <dt>A start tag whose tag name is "head"</dt>
3967: <dt>Any other end tag</dt>
3968: <dd>
3969: <p><a href="#parse-error">Parse error</a>. Ignore the token.</p>
3970: </dd>
3971:
3972: <dt>Anything else</dt>
3973: <dd>
3974:
3975: <!-- can't get here with an EOF and a fragment case -->
3976:
3977: <p>Act as if an end tag token with the tag name "head" had
3978: been seen, and reprocess the current token.</p>
3979:
3980: <p class="XXX">In certain UAs, <a href="https://bugzilla.mozilla.org/attachment.cgi?id=180157&action=view">some
3981: elements</a> don't trigger the "in body" mode straight away,
3982: but instead get put into the head. Do we want to copy
3983: that?</p>
3984:
3985: </dd>
3986:
3987: </dl><h5 id="parsing-main-inheadnoscript"><span class="secno">9.2.5.8 </span>The "<dfn title="insertion mode: in head noscript">in head noscript</dfn>" insertion mode</h5>
3988:
3989: <p>When the <a href="#insertion-mode">insertion mode</a> is "<a href="#parsing-main-inheadnoscript" title="insertion
3990: mode: in head noscript">in head noscript</a>", tokens must be handled as follows:</p>
3991:
3992: <dl class="switch"><dt>A DOCTYPE token</dt>
3993: <dd>
3994: <p><a href="#parse-error">Parse error</a>. Ignore the token.</p>
3995: </dd>
3996:
3997: <dt>A start tag whose tag name is "html"</dt>
3998: <dd>
3999: <p>Process the token <a href="#using-the-rules-for">using the rules for</a> the "<a href="#parsing-main-inbody" title="insertion mode: in body">in body</a>" <a href="#insertion-mode">insertion
4000: mode</a>.</p>
4001: </dd>
4002:
4003: <dt>An end tag whose tag name is "noscript"</dt>
4004: <dd>
4005:
4006: <p>Pop the <a href="#current-node">current node</a> (which will be a
4007: <code><a href="semantics.html#the-noscript-element">noscript</a></code> element) from the <a href="#stack-of-open-elements">stack of open
4008: elements</a>; the new <a href="#current-node">current node</a> will be a
4009: <code><a href="semantics.html#the-head-element">head</a></code> element.</p>
4010:
4011: <p>Switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-inhead" title="insertion mode: in head">in head</a>".</p>
4012:
4013: </dd>
4014:
4015: <dt>A character token that is one of U+0009 CHARACTER
4016: TABULATION, U+000A LINE FEED (LF), U+000C FORM FEED (FF),
4017: <!--U+000D CARRIAGE RETURN (CR),--> or U+0020 SPACE</dt>
4018: <dt>A comment token</dt>
4019: <dt>A start tag whose tag name is one of: "link", "meta", "noframes", "style"</dt>
4020: <dd>
4021: <p>Process the token <a href="#using-the-rules-for">using the rules for</a> the "<a href="#parsing-main-inhead" title="insertion mode: in head">in head</a>" <a href="#insertion-mode">insertion
4022: mode</a>.</p>
4023: </dd>
4024:
4025: <dt>An end tag whose tag name is "br"</dt>
4026: <dd>
4027: <p>Act as described in the "anything else" entry below.</p>
4028: </dd>
4029:
4030: <dt>A start tag whose tag name is one of: "head", "noscript"</dt>
4031: <dt>Any other end tag</dt>
4032: <dd>
4033: <p><a href="#parse-error">Parse error</a>. Ignore the token.</p>
4034: </dd>
4035:
4036: <dt>Anything else</dt>
4037: <dd>
4038:
4039: <!-- can't get here with an EOF and a fragment case -->
4040:
4041: <p><a href="#parse-error">Parse error</a>. Act as if an end tag with the tag
4042: name "noscript" had been seen and reprocess the current
4043: token.</p>
4044:
4045: </dd>
4046:
4047: </dl><h5 id="the-after-head-insertion-mode"><span class="secno">9.2.5.9 </span>The "<dfn title="insertion mode: after head">after head</dfn>" insertion mode</h5>
4048:
4049: <p>When the <a href="#insertion-mode">insertion mode</a> is "<a href="#the-after-head-insertion-mode" title="insertion
4050: mode: after head">after head</a>", tokens must be handled as follows:</p>
4051:
4052: <dl class="switch"><dt>A character token that is one of U+0009 CHARACTER
4053: TABULATION, U+000A LINE FEED (LF), U+000C FORM FEED (FF),
4054: <!--U+000D CARRIAGE RETURN (CR),--> or U+0020 SPACE</dt>
4055: <dd>
4056: <p><a href="#insert-a-character" title="insert a character">Insert the character</a> into
4057: the <a href="#current-node">current node</a>.</p>
4058: </dd>
4059:
4060: <dt>A comment token</dt>
4061: <dd>
4062: <p>Append a <code>Comment</code> node to the <a href="#current-node">current
4063: node</a> with the <code title="">data</code> attribute set to
4064: the data given in the comment token.</p>
4065: </dd>
4066:
4067: <dt>A DOCTYPE token</dt>
4068: <dd>
4069: <p><a href="#parse-error">Parse error</a>. Ignore the token.</p>
4070: </dd>
4071:
4072: <dt>A start tag whose tag name is "html"</dt>
4073: <dd>
4074: <p>Process the token <a href="#using-the-rules-for">using the rules for</a> the "<a href="#parsing-main-inbody" title="insertion mode: in body">in body</a>" <a href="#insertion-mode">insertion
4075: mode</a>.</p>
4076: </dd>
4077:
4078: <dt>A start tag whose tag name is "body"</dt>
4079: <dd>
4080:
4081: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token.</p>
4082:
4083: <p>Set the <a href="#frameset-ok-flag">frameset-ok flag</a> to "not ok".</p>
4084:
4085: <p>Switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-inbody" title="insertion mode: in body">in body</a>".</p>
4086:
4087: </dd>
4088:
4089: <dt>A start tag whose tag name is "frameset"</dt>
4090: <dd>
4091:
4092: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token.</p>
4093:
4094: <p>Switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-inframeset" title="insertion mode: in frameset">in frameset</a>".</p>
4095:
4096: </dd>
4097:
4098: <dt>A start tag token whose tag name is one of: "base", "link",
4099: "meta", "noframes", "script", "style", "title"</dt>
4100: <dd>
4101:
4102: <p><a href="#parse-error">Parse error</a>.</p>
4103:
4104: <p>Push the node pointed to by the <a href="#head-element-pointer"><code title="">head</code> element pointer</a> onto the
4105: <a href="#stack-of-open-elements">stack of open elements</a>.</p>
4106:
4107: <p>Process the token <a href="#using-the-rules-for">using the rules for</a> the "<a href="#parsing-main-inhead" title="insertion mode: in head">in head</a>" <a href="#insertion-mode">insertion
4108: mode</a>.</p>
4109:
4110: <p>Remove the node pointed to by the <a href="#head-element-pointer"><code title="">head</code> element pointer</a> from the <a href="#stack-of-open-elements">stack
4111: of open elements</a>.</p>
4112:
4113: <p class="note">The <a href="#head-element-pointer"><code title="">head</code> element
4114: pointer</a> cannot be null at this point.</p>
4115:
4116: </dd>
4117:
4118: <dt>An end tag whose tag name is one of: "body", "html", "br"</dt>
4119: <dd>
4120: <p>Act as described in the "anything else" entry below.</p>
4121: </dd>
4122:
4123: <dt>A start tag whose tag name is "head"</dt>
4124: <dt>Any other end tag</dt>
4125: <dd>
4126: <p><a href="#parse-error">Parse error</a>. Ignore the token.</p>
4127: </dd>
4128:
4129: <dt>Anything else</dt>
4130: <dd>
4131: <p>Act as if a start tag token with the tag name "body" and no
4132: attributes had been seen, then set the <a href="#frameset-ok-flag">frameset-ok
4133: flag</a> back to "ok", and then reprocess the current
4134: token.</p>
4135: </dd>
4136:
4137: </dl><h5 id="parsing-main-inbody"><span class="secno">9.2.5.10 </span>The "<dfn title="insertion mode: in body">in body</dfn>" insertion mode</h5>
4138:
4139: <p>When the <a href="#insertion-mode">insertion mode</a> is "<a href="#parsing-main-inbody" title="insertion
4140: mode: in body">in body</a>", tokens must be handled as follows:</p>
4141:
4142: <dl class="switch"><dt>A character token</dt>
4143: <dd>
4144:
4145: <p><a href="#reconstruct-the-active-formatting-elements">Reconstruct the active formatting elements</a>, if
4146: any.</p>
4147:
4148: <p><a href="#insert-a-character" title="insert a character">Insert the token's
4149: character</a> into the <a href="#current-node">current node</a>.</p>
4150:
4151: <p>If the token is not one of U+0009 CHARACTER TABULATION, U+000A
4152: LINE FEED (LF), U+000C FORM FEED (FF), <!--U+000D CARRIAGE RETURN
4153: (CR),--> or U+0020 SPACE, then set the <a href="#frameset-ok-flag">frameset-ok
4154: flag</a> to "not ok".</p>
4155:
4156: </dd>
4157:
4158: <dt>A comment token</dt>
4159: <dd>
4160: <p>Append a <code>Comment</code> node to the <a href="#current-node">current
4161: node</a> with the <code title="">data</code> attribute set to
4162: the data given in the comment token.</p>
4163: </dd>
4164:
4165: <dt>A DOCTYPE token</dt>
4166: <dd>
4167: <p><a href="#parse-error">Parse error</a>. Ignore the token.</p>
4168: </dd>
4169:
4170: <dt>A start tag whose tag name is "html"</dt>
4171: <dd>
4172: <p><a href="#parse-error">Parse error</a>. For each attribute on the token,
4173: check to see if the attribute is already present on the top
4174: element of the <a href="#stack-of-open-elements">stack of open elements</a>. If it is not,
4175: add the attribute and its corresponding value to that element.</p>
4176: </dd>
4177:
4178: <dt>A start tag token whose tag name is one of: "base", "command",
4179: "link", "meta", "noframes", "script", "style", "title"</dt>
4180: <dd>
4181: <p>Process the token <a href="#using-the-rules-for">using the rules for</a> the "<a href="#parsing-main-inhead" title="insertion mode: in head">in head</a>" <a href="#insertion-mode">insertion
4182: mode</a>.</p>
4183: </dd>
4184:
4185: <dt>A start tag whose tag name is "body"</dt>
4186: <dd>
4187:
4188: <p><a href="#parse-error">Parse error</a>.</p>
4189:
4190: <p>If the second element on the <a href="#stack-of-open-elements">stack of open
4191: elements</a> is not a <code><a href="semantics.html#the-body-element">body</a></code> element, or, if the
4192: <a href="#stack-of-open-elements">stack of open elements</a> has only one node on it,
4193: then ignore the token. (<a href="#fragment-case">fragment case</a>)</p>
4194:
4195: <p>Otherwise, for each attribute on the token, check to see if
4196: the attribute is already present on the <code><a href="semantics.html#the-body-element">body</a></code>
4197: element (the second element) on the <a href="#stack-of-open-elements">stack of open
4198: elements</a>. If it is not, add the attribute and its
4199: corresponding value to that element.</p>
4200:
4201: </dd>
4202:
4203: <dt>A start tag whose tag name is "frameset"</dt>
4204: <dd>
4205:
4206: <p><a href="#parse-error">Parse error</a>.</p>
4207:
4208: <p>If the second element on the <a href="#stack-of-open-elements">stack of open
4209: elements</a> is not a <code><a href="semantics.html#the-body-element">body</a></code> element, or, if the
4210: <a href="#stack-of-open-elements">stack of open elements</a> has only one node on it,
4211: then ignore the token. (<a href="#fragment-case">fragment case</a>)</p>
4212:
4213: <p>If the <a href="#frameset-ok-flag">frameset-ok flag</a> is set to "not ok", ignore
4214: the token.</p>
4215:
4216: <p>Otherwise, run the following steps:</p>
4217:
4218: <ol><li><p>Remove the second element on the <a href="#stack-of-open-elements">stack of open
4219: elements</a> from its parent node, if it has one.</p></li>
4220:
4221: <li><p>Pop all the nodes from the bottom of the <a href="#stack-of-open-elements">stack of
4222: open elements</a>, from the <a href="#current-node">current node</a> up to,
4223: but not including, the root <code><a href="semantics.html#the-html-element">html</a></code> element.</p>
4224:
4225: </li><li><p><a href="#insert-an-html-element">Insert an HTML element</a> for the
4226: token.</p></li>
4227:
4228: <li><p>Switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-inframeset" title="insertion mode: in frameset">in frameset</a>".</p>
4229:
4230: </li></ol></dd>
4231:
4232: <dt>An end-of-file token</dt>
4233: <dd>
4234:
4235: <p>If there is a node in the <a href="#stack-of-open-elements">stack of open elements</a>
4236: that is not either a <code><a href="semantics.html#the-dd-element">dd</a></code> element, a <code><a href="semantics.html#the-dt-element">dt</a></code>
4237: element, an <code><a href="semantics.html#the-li-element">li</a></code> element, a <code><a href="semantics.html#the-p-element">p</a></code> element, a
4238: <code><a href="tabular-data.html#the-tbody-element">tbody</a></code> element, a <code><a href="tabular-data.html#the-td-element">td</a></code> element, a
4239: <code><a href="tabular-data.html#the-tfoot-element">tfoot</a></code> element, a <code><a href="tabular-data.html#the-th-element">th</a></code> element, a
4240: <code><a href="tabular-data.html#the-thead-element">thead</a></code> element, a <code><a href="tabular-data.html#the-tr-element">tr</a></code> element, the
4241: <code><a href="semantics.html#the-body-element">body</a></code> element, or the <code><a href="semantics.html#the-html-element">html</a></code> element, then
4242: this is a <a href="#parse-error">parse error</a>.</p> <!-- (some of those are
4243: fragment cases) -->
4244:
4245: <p><a href="#stop-parsing">Stop parsing</a>.</p>
4246:
4247: </dd>
4248:
4249: <dt>An end tag whose tag name is "body"</dt>
4250: <dd>
4251:
4252: <p>If the <a href="#stack-of-open-elements">stack of open elements</a> does not <a href="#has-an-element-in-scope" title="has an element in scope">have a <code>body</code> element
4253: in scope</a>, this is a <a href="#parse-error">parse error</a>; ignore the
4254: token.</p>
4255:
4256: <!-- if we get here, the insertion mode here is forcibly "in
4257: body". -->
4258:
4259: <p>Otherwise, if there is a node in the <a href="#stack-of-open-elements">stack of open
4260: elements</a> that is not either a <code><a href="semantics.html#the-dd-element">dd</a></code> element, a
4261: <code><a href="semantics.html#the-dt-element">dt</a></code> element, an <code><a href="semantics.html#the-li-element">li</a></code> element, an
4262: <code><a href="forms.html#the-optgroup-element">optgroup</a></code> element, an <code><a href="forms.html#the-option-element">option</a></code> element, a
4263: <code><a href="semantics.html#the-p-element">p</a></code> element, an <code><a href="text-level-semantics.html#the-rp-element">rp</a></code> element, an
4264: <code><a href="text-level-semantics.html#the-rt-element">rt</a></code> element, a <code><a href="tabular-data.html#the-tbody-element">tbody</a></code> element, a
4265: <code><a href="tabular-data.html#the-td-element">td</a></code> element, a <code><a href="tabular-data.html#the-tfoot-element">tfoot</a></code> element, a
4266: <code><a href="tabular-data.html#the-th-element">th</a></code> element, a <code><a href="tabular-data.html#the-thead-element">thead</a></code> element, a
4267: <code><a href="tabular-data.html#the-tr-element">tr</a></code> element, the <code><a href="semantics.html#the-body-element">body</a></code> element, or the
4268: <code><a href="semantics.html#the-html-element">html</a></code> element, then this is a <a href="#parse-error">parse
4269: error</a>.</p> <!-- (some of those are fragment cases, e.g. for
4270: <tbody> you'd have hit the first paragraph since the <body>
4271: wouldn't be in scope, unless it was a fragment case) -->
4272:
4273: <!-- If we ever change the frameset-ok flag to an insertion mode,
4274: then we'd have to somehow keep track of its state when we switch
4275: to after-body. -->
4276:
4277: <p>Switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-afterbody" title="insertion mode: after body">after body</a>".</p>
4278:
4279: </dd>
4280:
4281: <dt>An end tag whose tag name is "html"</dt>
4282: <dd>
4283:
4284: <p>Act as if an end tag with tag name "body" had been seen,
4285: then, if that token wasn't ignored, reprocess the current
4286: token.</p>
4287:
4288: <p class="note">The fake end tag token here can only be
4289: ignored in the <a href="#fragment-case">fragment case</a>.</p>
4290:
4291: </dd>
4292:
4293: <!-- start tags for non-phrasing flow content elements -->
4294:
4295: <!-- the normal ones -->
4296: <dt>A start tag whose tag name is one of: "address", "article",
4297: "aside", "blockquote", "center", "datagrid", "details", "dialog",
4298: "dir", "div", "dl", "fieldset", "figure", "footer", "header",
4299: "hgroup", "menu", "nav", "ol", "p", "section", "ul"</dt>
4300: <dd>
4301:
4302: <!-- As of May 2008 this doesn't match any browser exactly, but is
4303: as close to what IE does as I can get without doing the non-tree
4304: DOM nonsense, and thus should actually afford better compatibility
4305: when implemented by the other browsers. -->
4306:
4307: <p>If the <a href="#stack-of-open-elements">stack of open elements</a> <a href="#has-an-element-in-scope" title="has
4308: an element in scope">has a <code>p</code> element in
4309: scope</a>, then act as if an end tag with the tag name
4310: "p" had been seen.</p>
4311:
4312: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token.</p>
4313:
4314: </dd>
4315:
4316: <!-- as normal, but close h1-h6 if it's the current node -->
4317: <dt>A start tag whose tag name is one of: "h1", "h2", "h3", "h4",
4318: "h5", "h6"</dt>
4319: <dd>
4320:
4321: <p>If the <a href="#stack-of-open-elements">stack of open elements</a> <a href="#has-an-element-in-scope" title="has
4322: an element in scope">has a <code>p</code> element in
4323: scope</a>, then act as if an end tag with the tag name
4324: "p" had been seen.</p>
4325:
4326: <p>If the <a href="#current-node">current node</a> is an element whose tag name
4327: is one of "h1", "h2", "h3", "h4", "h5", or "h6", then this is a
4328: <a href="#parse-error">parse error</a>; pop the <a href="#current-node">current node</a> off
4329: the <a href="#stack-of-open-elements">stack of open elements</a>.</p>
4330: <!-- See https://bugs.webkit.org/show_bug.cgi?id=12646 -->
4331:
4332: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token.</p>
4333:
4334: </dd>
4335:
4336: <!-- as normal, but drops leading newline -->
4337: <dt>A start tag whose tag name is one of: "pre", "listing"</dt>
4338: <dd>
4339:
4340: <p>If the <a href="#stack-of-open-elements">stack of open elements</a> <a href="#has-an-element-in-scope" title="has
4341: an element in scope">has a <code>p</code> element in
4342: scope</a>, then act as if an end tag with the tag name
4343: "p" had been seen.</p>
4344:
4345: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token.</p>
4346:
4347: <p>If the next token is a U+000A LINE FEED (LF) character
4348: token, then ignore that token and move on to the next
4349: one. (Newlines at the start of <code><a href="semantics.html#the-pre-element">pre</a></code> blocks are
4350: ignored as an authoring convenience.)</p>
4351:
4352: <p>Set the <a href="#frameset-ok-flag">frameset-ok flag</a> to "not ok".</p>
4353:
4354: </dd>
4355:
4356: <!-- as normal, but interacts with the form element pointer -->
4357: <dt>A start tag whose tag name is "form"</dt>
4358: <dd>
4359:
4360: <p>If the <a href="#form-element-pointer"><code title="form">form</code> element
4361: pointer</a> is not null, then this is a <a href="#parse-error">parse
4362: error</a>; ignore the token.</p>
4363:
4364: <p>Otherwise:</p>
4365:
4366: <p>If the <a href="#stack-of-open-elements">stack of open elements</a> <a href="#has-an-element-in-scope" title="has
4367: an element in scope">has a <code>p</code> element in
4368: scope</a>, then act as if an end tag with the tag name
4369: "p" had been seen.</p>
4370:
4371: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token, and set the
4372: <a href="#form-element-pointer"><code title="form">form</code> element pointer</a> to
4373: point to the element created.</p>
4374:
4375: </dd>
4376:
4377: <!-- as normal, but imply </li> when there's another <li> open in weird cases -->
4378: <dt>A start tag whose tag name is "li"</dt>
4379: <dd>
4380:
4381: <p>Run the following algorithm:</p>
4382:
4383: <ol><li><p>Set the <a href="#frameset-ok-flag">frameset-ok flag</a> to "not ok".</p></li>
4384:
4385: <li><p>Initialize <var title="">node</var> to be the <a href="#current-node">current
4386: node</a> (the bottommost node of the stack).</p></li>
4387:
4388: <li><p>If <var title="">node</var> is an <code><a href="semantics.html#the-li-element">li</a></code> element,
4389: then act as if an end tag with the tag name "li" had
4390: been seen, then jump to the last step.</p></li>
4391:
4392: <li><p><i>Loop</i>: If <var title="">node</var> is not in the
4393: <a href="#formatting">formatting</a> category, and is not in the
4394: <a href="#phrasing">phrasing</a> category, and is not an
4395: <code><a href="semantics.html#the-address-element">address</a></code>, <code><a href="interactive-elements.html#the-div-element">div</a></code>, or <code><a href="semantics.html#the-p-element">p</a></code>
4396: element, then jump to the last step.</p></li> <!-- an element
4397: <foo> is in this list if the following markup:
4398:
4399: <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><body><ol><li><foo><li>
4400:
4401: ...results in the second <li> not being (in any way) a descendant
4402: of the first <li>, or if <foo> is a formatting element that gets
4403: reopened later. -->
4404:
4405: <li><p>Otherwise, set <var title="">node</var> to the previous
4406: entry in the <a href="#stack-of-open-elements">stack of open elements</a> and return to
4407: the step labeled <i>loop</i>.</p></li>
4408:
4409: <li>
4410:
4411: <p>This is the last step.</p>
4412:
4413: <p>If the <a href="#stack-of-open-elements">stack of open elements</a> <a href="#has-an-element-in-scope" title="has
4414: an element in scope">has a <code>p</code> element in
4415: scope</a>, then act as if an end tag with the tag name
4416: "p" had been seen.</p>
4417:
4418: <p>Finally, <a href="#insert-an-html-element">insert an HTML element</a> for the
4419: token.</p>
4420:
4421: </li>
4422:
4423: </ol></dd>
4424:
4425: <!-- as normal, but imply </dt> or </dd> when there's another <dt> or <dd> open in weird cases -->
4426: <dt>A start tag whose tag name is one of: "dd", "dt"</dt>
4427: <dd>
4428:
4429: <p>Run the following algorithm:</p>
4430:
4431: <ol><li><p>Set the <a href="#frameset-ok-flag">frameset-ok flag</a> to "not ok".</p></li>
4432:
4433: <li><p>Initialize <var title="">node</var> to be the <a href="#current-node">current
4434: node</a> (the bottommost node of the stack).</p></li>
4435:
4436: <li><p><i>Loop</i>: If <var title="">node</var> is a
4437: <code><a href="semantics.html#the-dd-element">dd</a></code> or <code><a href="semantics.html#the-dt-element">dt</a></code> element, then act as if an end
4438: tag with the same tag name as <var title="">node</var> had been
4439: seen, then jump to the last step.</p></li>
4440:
4441: <li><p>If <var title="">node</var> is not in the
4442: <a href="#formatting">formatting</a> category, and is not in the
4443: <a href="#phrasing">phrasing</a> category, and is not an
4444: <code><a href="semantics.html#the-address-element">address</a></code>, <code><a href="interactive-elements.html#the-div-element">div</a></code>, or <code><a href="semantics.html#the-p-element">p</a></code>
4445: element, then jump to the last step.</p></li> <!-- an element
4446: <foo> is in this list if the following markup:
4447:
4448: <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><body><dl><dt><foo><dt>
4449:
4450: ...results in the second <dt> not being (in any way) a descendant
4451: of the first <dt>, or if <foo> is a formatting element that gets
4452: reopened later. -->
4453:
4454: <li><p>Otherwise, set <var title="">node</var> to the previous
4455: entry in the <a href="#stack-of-open-elements">stack of open elements</a> and return to
4456: the step labeled <i>loop</i>.</p></li>
4457:
4458: <li>
4459:
4460: <p>This is the last step.</p>
4461:
4462: <p>If the <a href="#stack-of-open-elements">stack of open elements</a> <a href="#has-an-element-in-scope" title="has
4463: an element in scope">has a <code>p</code> element in
4464: scope</a>, then act as if an end tag with the tag name
4465: "p" had been seen.</p>
4466:
4467: <p>Finally, <a href="#insert-an-html-element">insert an HTML element</a> for the
4468: token.</p>
4469:
4470: </li>
4471:
4472: </ol></dd>
4473:
4474: <!-- same as normal, but effectively ends parsing -->
4475: <dt>A start tag whose tag name is "plaintext"</dt>
4476: <dd>
4477:
4478: <p>If the <a href="#stack-of-open-elements">stack of open elements</a> <a href="#has-an-element-in-scope" title="has
4479: an element in scope">has a <code>p</code> element in
4480: scope</a>, then act as if an end tag with the tag name
4481: "p" had been seen.</p>
4482:
4483: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token.</p>
4484:
4485: <p>Switch the <a href="#content-model-flag">content model flag</a> to the PLAINTEXT
4486: state.</p>
4487:
4488: <p class="note">Once a start tag with the tag name "plaintext"
4489: has been seen, that will be the last token ever seen other
4490: than character tokens (and the end-of-file token), because
4491: there is no way to switch the <a href="#content-model-flag">content model flag</a>
4492: out of the PLAINTEXT state.</p>
4493:
4494: </dd>
4495:
4496: <!-- end tags for non-phrasing flow content elements -->
4497:
4498: <!-- the normal ones -->
4499: <dt>An end tag whose tag name is one of: "address", "article",
4500: "aside", "blockquote", "center", "datagrid", "details", "dialog",
4501: "dir", "div", "dl", "fieldset", "figure", "footer", "header",
4502: "hgroup", "listing", "menu", "nav", "ol", "pre", "section",
4503: "ul"</dt>
4504: <dd>
4505:
4506: <p>If the <a href="#stack-of-open-elements">stack of open elements</a> does not <a href="#has-an-element-in-scope" title="has an element in scope">have an element in scope</a>
4507: with the same tag name as that of the token, then this is a
4508: <a href="#parse-error">parse error</a>; ignore the token.</p>
4509:
4510: <p>Otherwise, run these steps:</p>
4511:
4512: <ol><li><p><a href="#generate-implied-end-tags">Generate implied end tags</a>.</p></li>
4513:
4514: <li><p>If the <a href="#current-node">current node</a> is not an element with
4515: the same tag name as that of the token, then this is a
4516: <a href="#parse-error">parse error</a>.</p></li>
4517:
4518: <li><p>Pop elements from the <a href="#stack-of-open-elements">stack of open elements</a>
4519: until an element with the same tag name as the token has been
4520: popped from the stack.</p></li>
4521:
4522: </ol></dd>
4523:
4524: <!-- removes the form element pointer instead of the matching node -->
4525: <dt>An end tag whose tag name is "form"</dt>
4526: <dd>
4527:
4528: <p>Let <var title="">node</var> be the element that the
4529: <a href="#form-element-pointer"><code title="">form</code> element pointer</a> is set
4530: to.</p>
4531:
4532: <p>Set the <a href="#form-element-pointer"><code title="">form</code> element pointer</a>
4533: to null.</p>
4534:
4535: <p>If <var title="">node</var> is null or the <a href="#stack-of-open-elements">stack of open
4536: elements</a> does not <a href="#has-an-element-in-scope" title="has an element in
4537: scope">have <var title="">node</var> in scope</a>, then this is
4538: a <a href="#parse-error">parse error</a>; ignore the token.</p>
4539:
4540: <p>Otherwise, run these steps:</p>
4541:
4542: <ol><li><p><a href="#generate-implied-end-tags">Generate implied end tags</a>.</p></li>
4543:
4544: <li><p>If the <a href="#current-node">current node</a> is not <var title="">node</var>, then this is a <a href="#parse-error">parse
4545: error</a>.</p></li>
4546:
4547: <li><p>Remove <var title="">node</var> from the <a href="#stack-of-open-elements">stack of
4548: open elements</a>.</p></li>
4549:
4550: </ol></dd>
4551:
4552: <!-- as normal, except </p> implies <p> if there's no <p> in scope, and needs care as the elements have optional tags -->
4553: <dt>An end tag whose tag name is "p"</dt>
4554: <dd>
4555:
4556: <p>If the <a href="#stack-of-open-elements">stack of open elements</a> does not <a href="#has-an-element-in-scope" title="has an element in scope">have an element in scope</a>
4557: with the same tag name as that of the token, then this is a
4558: <a href="#parse-error">parse error</a>; act as if a start tag with the tag name
4559: "p" had been seen, then reprocess the current token.</p>
4560:
4561: <p>Otherwise, run these steps:</p>
4562:
4563: <ol><li><p><a href="#generate-implied-end-tags">Generate implied end tags</a>, except
4564: for elements with the same tag name as the token.</p></li>
4565:
4566: <li><p>If the <a href="#current-node">current node</a> is not an element with
4567: the same tag name as that of the token, then this is a
4568: <a href="#parse-error">parse error</a>.</p></li>
4569:
4570: <li><p>Pop elements from the <a href="#stack-of-open-elements">stack of open elements</a>
4571: until an element with the same tag name as the token has been
4572: popped from the stack.</p></li>
4573:
4574: </ol></dd>
4575:
4576: <!-- as normal, but needs care as the elements have optional tags -->
4577: <dt>An end tag whose tag name is one of: "dd", "dt", "li"</dt>
4578: <dd>
4579:
4580: <p>If the <a href="#stack-of-open-elements">stack of open elements</a> does not <a href="#has-an-element-in-scope" title="has an element in scope">have an element in scope</a>
4581: with the same tag name as that of the token, then this is a
4582: <a href="#parse-error">parse error</a>; ignore the token.</p>
4583:
4584: <p>Otherwise, run these steps:</p>
4585:
4586: <ol><li><p><a href="#generate-implied-end-tags">Generate implied end tags</a>, except
4587: for elements with the same tag name as the token.</p></li>
4588:
4589: <li><p>If the <a href="#current-node">current node</a> is not an element with
4590: the same tag name as that of the token, then this is a
4591: <a href="#parse-error">parse error</a>.</p></li>
4592:
4593: <li><p>Pop elements from the <a href="#stack-of-open-elements">stack of open elements</a>
4594: until an element with the same tag name as the token has been
4595: popped from the stack.</p></li>
4596:
4597: </ol></dd>
4598:
4599: <!-- as normal, except acts as a closer for any of the h1-h6 elements -->
4600: <dt>An end tag whose tag name is one of: "h1", "h2", "h3", "h4", "h5", "h6"</dt>
4601: <dd>
4602:
4603: <p>If the <a href="#stack-of-open-elements">stack of open elements</a> does not <a href="#has-an-element-in-scope" title="has an element in scope">have an element in scope</a>
4604: whose tag name is one of "h1", "h2", "h3", "h4", "h5", or "h6",
4605: then this is a <a href="#parse-error">parse error</a>; ignore the token.</p>
4606:
4607: <p>Otherwise, run these steps:</p>
4608:
4609: <ol><li><p><a href="#generate-implied-end-tags">Generate implied end tags</a>.</p></li>
4610:
4611: <li><p>If the <a href="#current-node">current node</a> is not an element with
4612: the same tag name as that of the token, then this is a
4613: <a href="#parse-error">parse error</a>.</p></li>
4614:
4615: <li><p>Pop elements from the <a href="#stack-of-open-elements">stack of open elements</a>
4616: until an element whose tag name is one of "h1", "h2", "h3", "h4",
4617: "h5", or "h6" has been popped from the stack.</p></li>
4618:
4619: </ol></dd>
4620:
4621: <dt>An end tag whose tag name is "sarcasm"</dt>
4622: <dd>
4623: <p>Take a deep breath, then act as described in the "any other end
4624: tag" entry below.</p>
4625: </dd>
4626:
4627: <!-- ADOPTION AGENCY ELEMENTS
4628: Mozilla-only: bdo blink del ins sub sup q
4629: Safari-only: code dfn kbd nobr samp var wbr
4630: Both: a b big em font i s small strike strong tt u -->
4631:
4632: <dt>A start tag whose tag name is "a"</dt>
4633: <dd>
4634:
4635: <p>If the <a href="#list-of-active-formatting-elements">list of active formatting elements</a>
4636: contains an element whose tag name is "a" between the end of
4637: the list and the last marker on the list (or the start of the
4638: list if there is no marker on the list), then this is a
4639: <a href="#parse-error">parse error</a>; act as if an end tag with the tag
4640: name "a" had been seen, then remove that element from the
4641: <a href="#list-of-active-formatting-elements">list of active formatting elements</a> and the
4642: <a href="#stack-of-open-elements">stack of open elements</a> if the end tag didn't
4643: already remove it (it might not have if the element is not
4644: <a href="#has-an-element-in-table-scope" title="has an element in table scope">in table
4645: scope</a>).</p>
4646:
4647: <p class="example">In the non-conforming stream
4648: <code><a href="a">a<table><a href="b">b</table>x</code>,
4649: the first <code><a href="text-level-semantics.html#the-a-element">a</a></code> element would be closed upon seeing
4650: the second one, and the "x" character would be inside a link
4651: to "b", not to "a". This is despite the fact that the outer
4652: <code><a href="text-level-semantics.html#the-a-element">a</a></code> element is not in table scope (meaning that a
4653: regular <code></a></code> end tag at the start of the table
4654: wouldn't close the outer <code><a href="text-level-semantics.html#the-a-element">a</a></code> element).</p>
4655:
4656: <p><a href="#reconstruct-the-active-formatting-elements">Reconstruct the active formatting elements</a>, if
4657: any.</p>
4658:
4659: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token. Add that
4660: element to the <a href="#list-of-active-formatting-elements">list of active formatting
4661: elements</a>.</p>
4662:
4663: </dd>
4664:
4665: <dt>A start tag whose tag name is one of: "b", "big", "code", "em",
4666: "font", "i", "s", "small", "strike", "strong", "tt", "u"</dt>
4667: <dd>
4668:
4669: <p><a href="#reconstruct-the-active-formatting-elements">Reconstruct the active formatting elements</a>, if
4670: any.</p>
4671:
4672: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token. Add that
4673: element to the <a href="#list-of-active-formatting-elements">list of active formatting
4674: elements</a>.</p>
4675:
4676: </dd>
4677:
4678: <dt>A start tag whose tag name is "nobr"</dt>
4679: <dd>
4680:
4681: <p><a href="#reconstruct-the-active-formatting-elements">Reconstruct the active formatting elements</a>, if
4682: any.</p>
4683:
4684: <p>If the <a href="#stack-of-open-elements">stack of open elements</a> <a href="#has-an-element-in-scope" title="has an
4685: element in scope">has a <code>nobr</code> element in scope</a>,
4686: then this is a <a href="#parse-error">parse error</a>; act as if an end tag with
4687: the tag name "nobr" had been seen, then once again
4688: <a href="#reconstruct-the-active-formatting-elements">reconstruct the active formatting elements</a>, if
4689: any.</p>
4690:
4691: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token. Add that
4692: element to the <a href="#list-of-active-formatting-elements">list of active formatting
4693: elements</a>.</p>
4694:
4695: </dd>
4696:
4697: <dt id="adoptionAgency">An end tag whose tag name is one of: "a",
4698: "b", "big", "code", "em", "font", "i", "nobr", "s", "small",
4699: "strike", "strong", "tt", "u"</dt>
4700: <dd>
4701:
4702: <p>Follow these steps:</p>
4703:
4704: <ol><li>
4705:
4706: <p>Let the <var title="">formatting element</var> be the
4707: last element in the <a href="#list-of-active-formatting-elements">list of active formatting
4708: elements</a> that:</p>
4709:
4710: <ul><li>is between the end of the list and the last scope
4711: marker in the list, if any, or the start of the list
4712: otherwise, and</li>
4713:
4714: <li>has the same tag name as the token.</li>
4715:
4716: </ul><p>If there is no such node, or, if that node is also in the
4717: <a href="#stack-of-open-elements">stack of open elements</a> but the element is not <a href="#has-an-element-in-scope" title="has an element in scope">in scope</a>, then this is a
4718: <a href="#parse-error">parse error</a>; ignore the token, and abort these
4719: steps.</p>
4720:
4721: <p>Otherwise, if there is such a node, but that node is not
4722: in the <a href="#stack-of-open-elements">stack of open elements</a>, then this is a
4723: <a href="#parse-error">parse error</a>; remove the element from the list,
4724: and abort these steps.</p>
4725:
4726: <p>Otherwise, there is a <var title="">formatting
4727: element</var> and that element is in <a href="#stack-of-open-elements" title="stack of
4728: open elements">the stack</a> and is <a href="#has-an-element-in-scope" title="has an
4729: element in scope">in scope</a>. If the element is not the
4730: <a href="#current-node">current node</a>, this is a <a href="#parse-error">parse
4731: error</a>. In any case, proceed with the algorithm as
4732: written in the following steps.</p>
4733:
4734: </li>
4735:
4736: <li><p>Let the <var title="">furthest block</var> be the
4737: topmost node in the <a href="#stack-of-open-elements">stack of open elements</a> that
4738: is lower in the stack than the <var title="">formatting
4739: element</var>, and is not an element in the
4740: <a href="#phrasing">phrasing</a> or <a href="#formatting">formatting</a>
4741: categories. There might not be one.</p></li>
4742:
4743: <li><p>If there is no <var title="">furthest block</var>,
4744: then the UA must skip the subsequent steps and instead just
4745: pop all the nodes from the bottom of the <a href="#stack-of-open-elements">stack of open
4746: elements</a>, from the <a href="#current-node">current node</a> up to and
4747: including the <var title="">formatting element</var>, and
4748: remove the <var title="">formatting element</var> from the
4749: <a href="#list-of-active-formatting-elements">list of active formatting elements</a>.</p></li>
4750:
4751: <li><p>Let the <var title="">common ancestor</var> be the element
4752: immediately above the <var title="">formatting element</var> in the
4753: <a href="#stack-of-open-elements">stack of open elements</a>.</p></li>
4754:
4755: <li><p>Let a bookmark note the position of the <var title="">formatting element</var> in the <a href="#list-of-active-formatting-elements">list of active
4756: formatting elements</a> relative to the elements on either
4757: side of it in the list.</p></li>
4758:
4759: <li>
4760:
4761: <p>Let <var title="">node</var> and <var title="">last node</var> be the
4762: <var title="">furthest block</var>. Follow these steps:</p>
4763:
4764: <ol><li>Let <var title="">node</var> be the element immediately
4765: above <var title="">node</var> in the <a href="#stack-of-open-elements">stack of open
4766: elements</a>.</li>
4767:
4768: <li>If <var title="">node</var> is not in the <a href="#list-of-active-formatting-elements">list of
4769: active formatting elements</a>, then remove <var title="">node</var> from the <a href="#stack-of-open-elements">stack of open
4770: elements</a> and then go back to step 1.</li>
4771:
4772: <li>Otherwise, if <var title="">node</var> is the <var title="">formatting element</var>, then go to the next step
4773: in the overall algorithm.</li>
4774:
4775: <li>Otherwise, if <var title="">last node</var> is the <var title="">furthest block</var>, then move the aforementioned
4776: bookmark to be immediately after the <var title="">node</var> in the <a href="#list-of-active-formatting-elements">list of active formatting
4777: elements</a>.</li>
4778:
4779: <li><a href="#create-an-element-for-the-token">Create an element for the token</a> for which the
4780: element <var title="">node</var> was created, replace the entry
4781: for <var title="">node</var> in the <a href="#list-of-active-formatting-elements">list of active
4782: formatting elements</a> with an entry for the new element,
4783: replace the entry for <var title="">node</var> in the
4784: <a href="#stack-of-open-elements">stack of open elements</a> with an entry for the new
4785: element, and let <var title="">node</var> be the new
4786: element.</li>
4787:
4788: <li>Insert <var title="">last node</var> into <var title="">node</var>, first removing it from its previous
4789: parent node if any.</li>
4790:
4791: <li>Let <var title="">last node</var> be <var title="">node</var>.</li>
4792:
4793: <li>Return to step 1 of this inner set of steps.</li>
4794:
4795: </ol></li>
4796:
4797: <li>
4798:
4799: <p>If the <var title="">common ancestor</var> node is a
4800: <code><a href="tabular-data.html#the-table-element">table</a></code>, <code><a href="tabular-data.html#the-tbody-element">tbody</a></code>, <code><a href="tabular-data.html#the-tfoot-element">tfoot</a></code>,
4801: <code><a href="tabular-data.html#the-thead-element">thead</a></code>, or <code><a href="tabular-data.html#the-tr-element">tr</a></code> element, then,
4802: <a href="#foster-parent">foster parent</a> whatever <var title="">last
4803: node</var> ended up being in the previous step, first removing
4804: it from its previous parent node if any.</p>
4805:
4806: <p>Otherwise, append whatever <var title="">last node</var>
4807: ended up being in the previous step to the <var title="">common
4808: ancestor</var> node, first removing it from its previous parent
4809: node if any.</p>
4810:
4811: </li>
4812:
4813: <li><p><a href="#create-an-element-for-the-token">Create an element for the token</a> for which the
4814: <var title="">formatting element</var> was created.</p></li>
4815:
4816: <li><p>Take all of the child nodes of the <var title="">furthest
4817: block</var> and append them to the element created in the last
4818: step.</p></li>
4819:
4820: <li><p>Append that new element to the <var title="">furthest
4821: block</var>.</p></li>
4822:
4823: <li><p>Remove the <var title="">formatting element</var> from the
4824: <a href="#list-of-active-formatting-elements">list of active formatting elements</a>, and insert the
4825: new element into the <a href="#list-of-active-formatting-elements">list of active formatting
4826: elements</a> at the position of the aforementioned
4827: bookmark.</p></li>
4828:
4829: <li><p>Remove the <var title="">formatting element</var> from the
4830: <a href="#stack-of-open-elements">stack of open elements</a>, and insert the new element
4831: into the <a href="#stack-of-open-elements">stack of open elements</a> immediately below
4832: the position of the <var title="">furthest block</var> in that
4833: stack.</p></li>
4834:
4835: <li><p>Jump back to step 1 in this series of steps.</p></li>
4836:
4837: </ol><!--XXX
4838: <div class="example">
4839: <p class="XXX">Need an example.</p>
4840: </div>
4841: --><p class="note">Because of the way this algorithm causes elements to
4842: change parents, it has been dubbed the "adoption agency algorithm"
4843: (in contrast with other possibly algorithms for dealing with
4844: misnested content, which included the "incest algorithm", the
4845: "secret affair algorithm", and the "Heisenberg algorithm").</p>
4846:
4847: </dd>
4848:
4849: <dt>A start tag whose tag name is "button"</dt>
4850: <dd>
4851:
4852: <p>If the <a href="#stack-of-open-elements">stack of open elements</a> <a href="#has-an-element-in-scope" title="has
4853: an element in scope">has a <code>button</code> element in
4854: scope</a>, then this is a <a href="#parse-error">parse error</a>;
4855: act as if an end tag with the tag name "button" had been seen,
4856: then reprocess the token.</p>
4857:
4858: <p>Otherwise:</p>
4859:
4860: <p><a href="#reconstruct-the-active-formatting-elements">Reconstruct the active formatting elements</a>, if
4861: any.</p>
4862:
4863: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token.</p>
4864:
4865: <p>Insert a marker at the end of the <a href="#list-of-active-formatting-elements">list of active
4866: formatting elements</a>.</p>
4867:
4868: <p>Set the <a href="#frameset-ok-flag">frameset-ok flag</a> to "not ok".</p>
4869:
4870: </dd>
4871:
4872: <dt>A start tag token whose tag name is one of: "applet",
4873: "marquee", "object"</dt>
4874: <dd>
4875:
4876: <p><a href="#reconstruct-the-active-formatting-elements">Reconstruct the active formatting elements</a>, if
4877: any.</p>
4878:
4879: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token.</p>
4880:
4881: <p>Insert a marker at the end of the <a href="#list-of-active-formatting-elements">list of active
4882: formatting elements</a>.</p>
4883:
4884: <p>Set the <a href="#frameset-ok-flag">frameset-ok flag</a> to "not ok".</p>
4885:
4886: </dd>
4887:
4888: <dt>An end tag token whose tag name is one of: "applet", "button",
4889: "marquee", "object"</dt>
4890: <dd>
4891:
4892: <p>If the <a href="#stack-of-open-elements">stack of open elements</a> does not <a href="#has-an-element-in-scope" title="has an element in scope">have an element in scope</a>
4893: with the same tag name as that of the token, then this is a
4894: <a href="#parse-error">parse error</a>; ignore the token.</p>
4895:
4896: <p>Otherwise, run these steps:</p>
4897:
4898: <ol><li><p><a href="#generate-implied-end-tags">Generate implied end tags</a>.</p></li>
4899:
4900: <li><p>If the <a href="#current-node">current node</a> is not an element with
4901: the same tag name as that of the token, then this is a
4902: <a href="#parse-error">parse error</a>.</p></li>
4903:
4904: <li><p>Pop elements from the <a href="#stack-of-open-elements">stack of open elements</a>
4905: until an element with the same tag name as the token has been
4906: popped from the stack.</p></li>
4907:
4908: <li><a href="#clear-the-list-of-active-formatting-elements-up-to-the-last-marker">Clear the list of active formatting elements up to the
4909: last marker</a>.</li>
4910:
4911: </ol></dd>
4912:
4913: <dt>A start tag whose tag name is "table"</dt>
4914: <dd>
4915:
4916: <p>If the <code>Document</code> is <em>not</em> set to
4917: <a href="dom.html#quirks-mode">quirks mode</a>, and the <a href="#stack-of-open-elements">stack of open
4918: elements</a> <a href="#has-an-element-in-scope" title="has an element in scope">has a
4919: <code>p</code> element in scope</a>, then act as if an end tag
4920: with the tag name "p" had been seen.</p> <!-- i hate myself (this
4921: quirk was basically caused by acid2; if i'd realised we could
4922: change the specs when i wrote acid2, we could have avoided having
4923: any parsing-mode quirks) -Hixie -->
4924:
4925: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token.</p>
4926:
4927: <p>Set the <a href="#frameset-ok-flag">frameset-ok flag</a> to "not ok".</p>
4928:
4929: <p>Switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-intable" title="insertion mode: in table">in table</a>".</p>
4930:
4931: </dd>
4932:
4933: <dt>A start tag whose tag name is one of: "area", "basefont",
4934: "bgsound", "br", "embed", "img", "input", "keygen", "spacer",
4935: "wbr"</dt>
4936: <dd>
4937:
4938: <p><a href="#reconstruct-the-active-formatting-elements">Reconstruct the active formatting elements</a>, if
4939: any.</p>
4940:
4941: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token. Immediately
4942: pop the <a href="#current-node">current node</a> off the <a href="#stack-of-open-elements">stack of open
4943: elements</a>.</p>
4944:
4945: <p><a href="#acknowledge-self-closing-flag" title="acknowledge self-closing flag">Acknowledge the
4946: token's <i>self-closing flag</i></a>, if it is set.</p>
4947:
4948: <p>Set the <a href="#frameset-ok-flag">frameset-ok flag</a> to "not ok".</p> <!--
4949: shouldn't really do it for <area>, <basefont>, <bgsound>, and
4950: <spacer> -->
4951:
4952: </dd>
4953:
4954: <dt>A start tag whose tag name is one of: "param", "source"</dt>
4955: <dd>
4956:
4957: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token. Immediately
4958: pop the <a href="#current-node">current node</a> off the <a href="#stack-of-open-elements">stack of open
4959: elements</a>.</p>
4960:
4961: <p><a href="#acknowledge-self-closing-flag" title="acknowledge self-closing flag">Acknowledge the
4962: token's <i>self-closing flag</i></a>, if it is set.</p>
4963:
4964: </dd>
4965:
4966: <dt>A start tag whose tag name is "hr"</dt>
4967: <dd>
4968:
4969: <p>If the <a href="#stack-of-open-elements">stack of open elements</a> <a href="#has-an-element-in-scope" title="has
4970: an element in scope">has a <code>p</code> element in
4971: scope</a>, then act as if an end tag with the tag name
4972: "p" had been seen.</p>
4973:
4974: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token. Immediately
4975: pop the <a href="#current-node">current node</a> off the <a href="#stack-of-open-elements">stack of open
4976: elements</a>.</p>
4977:
4978: <p><a href="#acknowledge-self-closing-flag" title="acknowledge self-closing flag">Acknowledge the
4979: token's <i>self-closing flag</i></a>, if it is set.</p>
4980:
4981: <p>Set the <a href="#frameset-ok-flag">frameset-ok flag</a> to "not ok".</p>
4982:
4983: </dd>
4984:
4985: <dt>A start tag whose tag name is "image"</dt>
4986: <dd>
4987: <p><a href="#parse-error">Parse error</a>. Change the token's tag name
4988: to "img" and reprocess it. (Don't ask.)</p> <!-- As of
4989: 2005-12, studies showed that around 0.2% of pages used the
4990: <image> element. -->
4991: </dd>
4992:
4993: <dt id="isindex">A start tag whose tag name is "isindex"</dt>
4994: <dd>
4995:
4996: <p><a href="#parse-error">Parse error</a>.</p>
4997:
4998: <p>If the <a href="#form-element-pointer"><code title="">form</code> element
4999: pointer</a> is not null, then ignore the token.</p>
5000:
5001: <p>Otherwise:</p>
5002:
5003: <p><a href="#acknowledge-self-closing-flag" title="acknowledge self-closing flag">Acknowledge the
5004: token's <i>self-closing flag</i></a>, if it is set.</p> <!--
5005: purely to reduce the number of errors (we don't care if they
5006: included the /, they're not supposed to be including the tag at
5007: all! -->
5008:
5009: <p>Act as if a start tag token with the tag name "form" had been seen.</p>
5010:
5011: <p>If the token has an attribute called "action", set the
5012: <code title="attr-form-action">action</code> attribute on the
5013: resulting <code><a href="forms.html#the-form-element">form</a></code> element to the value of the
5014: "action" attribute of the token.</p>
5015:
5016: <p>Act as if a start tag token with the tag name "hr" had been
5017: seen.</p>
5018:
5019: <p>Act as if a start tag token with the tag name "label" had been
5020: seen.</p>
5021:
5022: <p>Act as if a stream of character tokens had been seen (see below
5023: for what they should say).</p>
5024:
5025: <p>Act as if a start tag token with the tag name "input" had been
5026: seen, with all the attributes from the "isindex" token except
5027: "name", "action", and "prompt". Set the <code title="attr-fe-name"><a href="forms.html#attr-fe-name">name</a></code> attribute of the resulting
5028: <code><a href="forms.html#the-input-element">input</a></code> element to the value "<code title="">isindex</code>".</p>
5029:
5030: <p>Act as if a stream of character tokens had been seen (see
5031: below for what they should say).</p>
5032:
5033: <p>Act as if an end tag token with the tag name "label" had been
5034: seen.</p>
5035:
5036: <p>Act as if a start tag token with the tag name "hr" had been
5037: seen.</p>
5038:
5039: <p>Act as if an end tag token with the tag name "form" had been
5040: seen.</p>
5041:
5042: <p>If the token has an attribute with the name "prompt", then the
5043: first stream of characters must be the same string as given in
5044: that attribute, and the second stream of characters must be
5045: empty. Otherwise, the two streams of character tokens together
5046: should, together with the <code><a href="forms.html#the-input-element">input</a></code> element, express the
5047: equivalent of "This is a searchable index. Insert your search
5048: keywords here: (input field)" in the user's preferred
5049: language.</p>
5050:
5051: </dd>
5052:
5053: <dt>A start tag whose tag name is "textarea"</dt>
5054: <dd>
5055:
5056: <ol><li><p><a href="#insert-an-html-element">Insert an HTML element</a> for the
5057: token.</p></li>
5058:
5059: <li><p>If the next token is a U+000A LINE FEED (LF) character
5060: token, then ignore that token and move on to the next
5061: one. (Newlines at the start of <code><a href="forms.html#the-textarea-element">textarea</a></code> elements are
5062: ignored as an authoring convenience.)</p></li>
5063:
5064: <li><p>Switch the tokenizer's <a href="#content-model-flag">content model flag</a> to
5065: the RCDATA state.</p></li>
5066:
5067: <li><p>Let the <a href="#original-insertion-mode">original insertion mode</a> be the
5068: current <a href="#insertion-mode">insertion mode</a>.</p>
5069:
5070: </li><li><p>Set the <a href="#frameset-ok-flag">frameset-ok flag</a> to "not
5071: ok".</p></li>
5072:
5073: <li><p>Switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-incdata" title="insertion mode: in CDATA/RCDATA">in
5074: CDATA/RCDATA</a>".</p></li>
5075:
5076: </ol></dd>
5077:
5078: <dt>A start tag whose tag name is "xmp"</dt>
5079: <dd>
5080:
5081: <p><a href="#reconstruct-the-active-formatting-elements">Reconstruct the active formatting elements</a>, if
5082: any.</p>
5083:
5084: <p>Set the <a href="#frameset-ok-flag">frameset-ok flag</a> to "not ok".</p>
5085:
5086: <p>Follow the <a href="#generic-cdata-element-parsing-algorithm">generic CDATA element parsing algorithm</a>.</p>
5087:
5088: </dd>
5089:
5090: <dt>A start tag whose tag name is "iframe"</dt>
5091: <dd>
5092:
5093: <p>Set the <a href="#frameset-ok-flag">frameset-ok flag</a> to "not ok".</p>
5094:
5095: <p>Follow the <a href="#generic-cdata-element-parsing-algorithm">generic CDATA element parsing algorithm</a>.</p>
5096:
5097: </dd>
5098:
5099: <dt>A start tag whose tag name is "noembed"</dt>
5100: <dt>A start tag whose tag name is "noscript", if the <a href="#scripting-flag">scripting flag</a> is enabled</dt>
5101: <dd>
5102:
5103: <p>Follow the <a href="#generic-cdata-element-parsing-algorithm">generic CDATA element parsing algorithm</a>.</p>
5104:
5105: </dd>
5106:
5107: <dt>A start tag whose tag name is "select"</dt>
5108: <dd>
5109:
5110: <p><a href="#reconstruct-the-active-formatting-elements">Reconstruct the active formatting elements</a>, if
5111: any.</p>
5112:
5113: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token.</p>
5114:
5115: <p>Set the <a href="#frameset-ok-flag">frameset-ok flag</a> to "not ok".</p>
5116:
5117: <p>If the <a href="#insertion-mode">insertion mode</a> is one of <a href="#parsing-main-intable" title="insertion mode: in table">in table</a>", "<a href="#parsing-main-incaption" title="insertion mode: in caption">in caption</a>", "<a href="#parsing-main-incolgroup" title="insertion mode: in column group">in column group</a>",
5118: "<a href="#parsing-main-intbody" title="insertion mode: in table body">in table
5119: body</a>", "<a href="#parsing-main-intr" title="insertion mode: in row">in
5120: row</a>", or "<a href="#parsing-main-intd" title="insertion mode: in cell">in
5121: cell</a>", then switch the <a href="#insertion-mode">insertion mode</a> to
5122: "<a href="#parsing-main-inselectintable" title="insertion mode: in select in table">in select in
5123: table</a>". Otherwise, switch the <a href="#insertion-mode">insertion mode</a>
5124: to "<a href="#parsing-main-inselect" title="insertion mode: in select">in select</a>".</p>
5125:
5126: </dd>
5127:
5128: <dt>A start tag whose tag name is one of: "optgroup", "option"</dt>
5129: <dd>
5130:
5131: <p>If the <a href="#stack-of-open-elements">stack of open elements</a> <a href="#has-an-element-in-scope" title="has an
5132: element in scope">has an <code>option</code> element in
5133: scope</a>, then act as if an end tag with the tag name "option"
5134: had been seen.</p>
5135:
5136: <p><a href="#reconstruct-the-active-formatting-elements">Reconstruct the active formatting elements</a>, if
5137: any.</p>
5138:
5139: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token.</p>
5140:
5141: </dd>
5142:
5143: <dt>A start tag whose tag name is one of: "rp", "rt"</dt>
5144: <dd>
5145:
5146: <!-- the parsing rules for ruby really don't match IE much at all,
5147: but in practice the markup used is very simple and so strict
5148: compatibility with IE isn't required. For example, as defined
5149: here we get very, very different behaviour than IE for
5150: pathological cases like:
5151:
5152: <ruby><ol><li><p>a<rt>b
5153: <ruby>a<rt>b<p>c
5154:
5155: But in practice most ruby markup falls into these cases:
5156:
5157: <ruby>a<rt>b</ruby>
5158: <ruby>a<rp>b<rt>c<rp>d</ruby>
5159: <ruby>a<rt>b</rt></ruby>
5160: <ruby>a<rp>b</rp><rt>c</rt><rp>d</rp></ruby>
5161:
5162: -->
5163:
5164: <p>If the <a href="#stack-of-open-elements">stack of open elements</a> <a href="#has-an-element-in-scope" title="has an
5165: element in scope">has a <code>ruby</code> element in scope</a>,
5166: then <a href="#generate-implied-end-tags">generate implied end tags</a>. If the <a href="#current-node">current
5167: node</a> is not then a <code><a href="text-level-semantics.html#the-ruby-element">ruby</a></code> element, this is a
5168: <a href="#parse-error">parse error</a>; pop all the nodes from the <a href="#current-node">current
5169: node</a> up to the node immediately before the bottommost
5170: <code><a href="text-level-semantics.html#the-ruby-element">ruby</a></code> element on the <a href="#stack-of-open-elements">stack of open
5171: elements</a>.</p>
5172:
5173: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token.</p>
5174:
5175: </dd>
5176:
5177: <dt>An end tag whose tag name is "br"</dt>
5178: <dd>
5179: <p><a href="#parse-error">Parse error</a>. Act as if a start tag token with
5180: the tag name "br" had been seen. Ignore the end tag token.</p>
5181: </dd>
5182:
5183: <dt>A start tag whose tag name is "math"</dt>
5184: <dd>
5185:
5186: <p><a href="#reconstruct-the-active-formatting-elements">Reconstruct the active formatting elements</a>, if
5187: any.</p>
5188:
5189: <p><a href="#adjust-mathml-attributes">Adjust MathML attributes</a> for the token. (This
5190: fixes the case of MathML attributes that are not all
5191: lowercase.)</p>
5192:
5193: <p><a href="#adjust-foreign-attributes">Adjust foreign attributes</a> for the token. (This
5194: fixes the use of namespaced attributes, in particular XLink.)</p>
5195:
5196: <p><a href="#insert-a-foreign-element">Insert a foreign element</a> for the token, in the
5197: <a href="#mathml-namespace">MathML namespace</a>.</p>
5198:
5199: <!-- If we ever change the frameset-ok flag to an insertion mode,
5200: the following change would be implied, except we'd have to do it
5201: even in the face of a self-closed tag:
5202: <p>Set the <span>frameset-ok flag</span> to "not ok".</p>
5203: -->
5204:
5205: <p>If the token has its <i>self-closing flag</i> set, pop the
5206: <a href="#current-node">current node</a> off the <a href="#stack-of-open-elements">stack of open
5207: elements</a> and <a href="#acknowledge-self-closing-flag" title="acknowledge self-closing
5208: flag">acknowledge the token's <i>self-closing flag</i></a>.</p>
5209:
5210: <p>Otherwise, if the <a href="#insertion-mode">insertion mode</a> is not already
5211: "<a href="#parsing-main-inforeign" title="insertion mode: in foreign content">in foreign
5212: content</a>", let the <a href="#secondary-insertion-mode">secondary insertion mode</a> be
5213: the current <a href="#insertion-mode">insertion mode</a>, and then switch the
5214: <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-inforeign" title="insertion mode: in
5215: foreign content">in foreign content</a>".</p>
5216:
5217: </dd>
5218:
5219: <dt>A start tag whose tag name is "svg"</dt>
5220: <dd>
5221:
5222: <p><a href="#reconstruct-the-active-formatting-elements">Reconstruct the active formatting elements</a>, if
5223: any.</p>
5224:
5225: <p><a href="#adjust-svg-attributes">Adjust SVG attributes</a> for the token. (This fixes
5226: the case of SVG attributes that are not all lowercase.)</p>
5227:
5228: <p><a href="#adjust-foreign-attributes">Adjust foreign attributes</a> for the token. (This
5229: fixes the use of namespaced attributes, in particular XLink in
5230: SVG.)</p>
5231:
5232: <p><a href="#insert-a-foreign-element">Insert a foreign element</a> for the token, in the
5233: <a href="#svg-namespace">SVG namespace</a>.</p>
5234:
5235: <!-- If we ever change the frameset-ok flag to an insertion mode,
5236: the following change would be implied, except we'd have to do it
5237: even in the face of a self-closed tag:
5238: <p>Set the <span>frameset-ok flag</span> to "not ok".</p>
5239: -->
5240:
5241: <p>If the token has its <i>self-closing flag</i> set, pop the
5242: <a href="#current-node">current node</a> off the <a href="#stack-of-open-elements">stack of open
5243: elements</a> and <a href="#acknowledge-self-closing-flag" title="acknowledge self-closing
5244: flag">acknowledge the token's <i>self-closing flag</i></a>.</p>
5245:
5246: <p>Otherwise, if the <a href="#insertion-mode">insertion mode</a> is not already
5247: "<a href="#parsing-main-inforeign" title="insertion mode: in foreign content">in foreign
5248: content</a>", let the <a href="#secondary-insertion-mode">secondary insertion mode</a> be
5249: the current <a href="#insertion-mode">insertion mode</a>, and then switch the
5250: <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-inforeign" title="insertion mode: in
5251: foreign content">in foreign content</a>".</p>
5252:
5253: </dd>
5254:
5255: <dt>A start <!--or end--> tag whose tag name is one of: "caption",
5256: "col", "colgroup", "frame", "head", "tbody", "td", "tfoot", "th",
5257: "thead", "tr"</dt>
5258: <!--<dt>An end tag whose tag name is one of: "area", "base",
5259: "basefont", "bgsound", "command", "embed", "hr", "iframe", "image",
5260: "img", "input", "isindex", "keygen", "link", "meta", "noembed",
5261: "noframes", "param", "script", "select", "source", "spacer",
5262: "style", "table", "textarea", "title", "wbr"</dt>-->
5263: <!--<dt>An end tag whose tag name is "noscript", if the
5264: <span>scripting flag</span> is enabled</dt>-->
5265: <dd>
5266: <p><a href="#parse-error">Parse error</a>. Ignore the token.</p>
5267: <!-- end tags are commented out because since they can never end
5268: up on the stack anyway, the default end tag clause will
5269: automatically handle them. we don't want to have text in the spec
5270: that is just an optimisation, as that detracts from the spec
5271: itself -->
5272: </dd>
5273:
5274: <dt>Any other start tag</dt>
5275: <dd>
5276:
5277: <p><a href="#reconstruct-the-active-formatting-elements">Reconstruct the active formatting elements</a>, if
5278: any.</p>
5279:
5280: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token.</p>
5281:
5282: <p class="note">This element will be a <a href="#phrasing">phrasing</a>
5283: element.</p>
5284:
5285: </dd>
5286:
5287: <dt>Any other end tag</dt>
5288: <dd>
5289:
5290: <p>Run the following steps:</p>
5291:
5292: <ol><li><p>Initialize <var title="">node</var> to be the <a href="#current-node">current
5293: node</a> (the bottommost node of the stack).</p></li>
5294:
5295: <li><p>If <var title="">node</var> has the same tag name as
5296: the end tag token, then:</p>
5297:
5298: <ol><li><p><a href="#generate-implied-end-tags">Generate implied end tags</a>.</p></li>
5299:
5300: <li><p>If the tag name of the end tag token does not match
5301: the tag name of the <a href="#current-node">current node</a>, this is a
5302: <a href="#parse-error">parse error</a>.</p></li>
5303:
5304: <li><p>Pop all the nodes from the <a href="#current-node">current node</a> up
5305: to <var title="">node</var>, including <var title="">node</var>, then stop these steps.</p></li>
5306:
5307: </ol></li>
5308:
5309: <li><p>Otherwise, if <var title="">node</var> is in neither the
5310: <a href="#formatting">formatting</a> category nor the <a href="#phrasing">phrasing</a>
5311: category, then this is a <a href="#parse-error">parse error</a>; ignore the
5312: token, and abort these steps.</p></li>
5313:
5314: <li><p>Set <var title="">node</var> to the previous entry in the
5315: <a href="#stack-of-open-elements">stack of open elements</a>.</p></li>
5316:
5317: <li><p>Return to step 2.</p></li>
5318:
5319: </ol></dd>
5320:
5321: </dl><h5 id="parsing-main-incdata"><span class="secno">9.2.5.11 </span>The "<dfn title="insertion mode: in CDATA/RCDATA">in CDATA/RCDATA</dfn>" insertion mode</h5>
5322:
5323: <p>When the <a href="#insertion-mode">insertion mode</a> is "<a href="#parsing-main-incdata" title="insertion
5324: mode: in CDATA/RCDATA">in CDATA/RCDATA</a>", tokens must be
5325: handled as follows:</p>
5326:
5327: <dl class="switch"><dt>A character token</dt>
5328: <dd>
5329:
5330: <p><a href="#insert-a-character" title="insert a character">Insert the token's
5331: character</a> into the <a href="#current-node">current node</a>.</p>
5332:
5333: </dd>
5334:
5335: <dt>An end-of-file token</dt>
5336: <dd>
5337:
5338: <!-- can't be the fragment case -->
5339: <p><a href="#parse-error">Parse error</a>.</p>
5340:
5341: <p>If the <a href="#current-node">current node</a> is a <code><a href="semantics.html#script">script</a></code>
5342: element, mark the <code><a href="semantics.html#script">script</a></code> element as <a href="semantics.html#already-executed">"already
5343: executed"</a>.</p>
5344:
5345: <p>Pop the <a href="#current-node">current node</a> off the <a href="#stack-of-open-elements">stack of open
5346: elements</a>.</p>
5347:
5348: <p>Switch the <a href="#insertion-mode">insertion mode</a> to the <a href="#original-insertion-mode">original
5349: insertion mode</a> and reprocess the current token.</p>
5350:
5351: </dd>
5352:
5353: <dt>An end tag whose tag name is "script"</dt>
5354: <dd>
5355:
5356: <p>Let <var title="">script</var> be the <a href="#current-node">current node</a>
5357: (which will be a <code><a href="semantics.html#script">script</a></code> element).</p>
5358:
5359: <p>Pop the <a href="#current-node">current node</a> off the <a href="#stack-of-open-elements">stack of open
5360: elements</a>.</p>
5361:
5362: <p>Switch the <a href="#insertion-mode">insertion mode</a> to the <a href="#original-insertion-mode">original
5363: insertion mode</a>.</p>
5364:
5365: <p>Let the <var title="">old insertion point</var> have the
5366: same value as the current <a href="#insertion-point">insertion point</a>. Let
5367: the <a href="#insertion-point">insertion point</a> be just before the <a href="#next-input-character">next
5368: input character</a>.</p>
5369:
5370: <p>Increment the parser's <a href="#script-nesting-level">script nesting level</a> by
5371: one.</p>
5372:
5373: <p><a href="semantics.html#running-a-script" title="running a script">Run</a> the <var title="">script</var>. This might cause some script to execute,
5374: which might cause <a href="dom.html#dom-document-write" title="dom-document-write">new characters
5375: to be inserted into the tokenizer</a>, and might cause the
5376: tokenizer to output more tokens, resulting in a <a href="#nestedParsing">reentrant invocation of the parser</a>.</p>
5377:
5378: <p>Decrement the parser's <a href="#script-nesting-level">script nesting level</a> by
5379: one. If the parser's <a href="#script-nesting-level">script nesting level</a> is zero,
5380: then set the <a href="#parser-pause-flag">parser pause flag</a> to false.</p>
5381:
5382: <p>Let the <a href="#insertion-point">insertion point</a> have the value of the <var title="">old insertion point</var>. (In other words, restore the
5383: <a href="#insertion-point">insertion point</a> to its previous value. This value
5384: might be the "undefined" value.)</p>
5385:
5386: <p id="scriptTagParserResumes">At this stage, if there is a
5387: <a href="semantics.html#pending-external-script">pending external script</a>, then:</p>
5388:
5389: <dl class="switch"><dt>If the <a href="#script-nesting-level">script nesting level</a> is not zero:</dt>
5390:
5391: <dd>
5392:
5393: <p>Set the <a href="#parser-pause-flag">parser pause flag</a> to true, and abort the
5394: processing of any nested invocations of the tokenizer, yielding
5395: control back to the caller. (Tokenization will resume when the
5396: caller returns to the "outer" tree construction stage.)</p>
5397:
5398: <p class="note">The tree construction stage of this particular
5399: parser is <a href="#nestedParsing">being called reentrantly</a>,
5400: say from a call to <code title="dom-document-write"><a href="dom.html#dom-document-write">document.write()</a></code>.</p>
5401:
5402: </dd>
5403:
5404:
5405: <dt>Otherwise:</dt>
5406:
5407: <dd>
5408:
5409: <p>Follow these steps:</p>
5410:
5411: <ol><li><p>Let <var title="">the script</var> be the <a href="semantics.html#pending-external-script">pending
5412: external script</a>. There is no longer a <a href="semantics.html#pending-external-script">pending
5413: external script</a>.</p></li>
5414:
5415: <li><p><a href="browsers.html#pause">Pause</a> until the script has <a href="semantics.html#completed-loading">completed
5416: loading</a>.</p></li>
5417:
5418: <li><p>Let the <a href="#insertion-point">insertion point</a> be just before the
5419: <a href="#next-input-character">next input character</a>.</p></li>
5420:
5421: <li><p>Increment the parser's <a href="#script-nesting-level">script nesting level</a>
5422: by one (it should be zero before this step, so this sets it to
5423: one).</p></li>
5424:
5425: <li><p><a href="semantics.html#executing-a-script-block" title="executing a script block">Execute the
5426: script</a>.</p></li>
5427:
5428: <li><p>Decrement the parser's <a href="#script-nesting-level">script nesting level</a>
5429: by one. If the parser's <a href="#script-nesting-level">script nesting level</a> is
5430: zero (which it always should be at this point), then set the
5431: <a href="#parser-pause-flag">parser pause flag</a> to false.</p>
5432:
5433: </li><li><p>Let the <a href="#insertion-point">insertion point</a> be undefined
5434: again.</p></li>
5435:
5436: <li><p>If there is once again a <a href="semantics.html#pending-external-script">pending external
5437: script</a>, then repeat these steps from step 1.</p></li>
5438:
5439: </ol></dd>
5440:
5441: </dl></dd>
5442:
5443: <dt>Any other end tag</dt>
5444: <dd>
5445:
5446: <p>Pop the <a href="#current-node">current node</a> off the <a href="#stack-of-open-elements">stack of open
5447: elements</a>.</p>
5448:
5449: <p>Switch the <a href="#insertion-mode">insertion mode</a> to the <a href="#original-insertion-mode">original
5450: insertion mode</a>.</p>
5451:
5452: </dd>
5453:
5454: </dl><h5 id="parsing-main-intable"><span class="secno">9.2.5.12 </span>The "<dfn title="insertion mode: in table">in table</dfn>" insertion mode</h5>
5455:
5456: <p>When the <a href="#insertion-mode">insertion mode</a> is "<a href="#parsing-main-intable" title="insertion
5457: mode: in table">in table</a>", tokens must be handled as follows:</p>
5458:
5459: <dl class="switch"><dt>A character token</dt>
5460: <dd>
5461:
5462: <p>Let the <dfn id="pending-table-character-tokens"><var>pending table character tokens</var></dfn>
5463: be an empty list of tokens.</p>
5464:
5465: <p>Let the <a href="#original-insertion-mode">original insertion mode</a> be the current
5466: <a href="#insertion-mode">insertion mode</a>.</p>
5467:
5468: <p>Switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-intabletext" title="insertion mode: in table text">in table text</a>" and
5469: reprocess the token.</p>
5470:
5471: </dd>
5472:
5473: <dt>A comment token</dt>
5474: <dd>
5475: <p>Append a <code>Comment</code> node to the <a href="#current-node">current
5476: node</a> with the <code title="">data</code> attribute set to
5477: the data given in the comment token.</p>
5478: </dd>
5479:
5480: <dt>A DOCTYPE token</dt>
5481: <dd>
5482: <p><a href="#parse-error">Parse error</a>. Ignore the token.</p>
5483: </dd>
5484:
5485: <dt>A start tag whose tag name is "caption"</dt>
5486: <dd>
5487:
5488: <p><a href="#clear-the-stack-back-to-a-table-context">Clear the stack back to a table context</a>. (See
5489: below.)</p>
5490:
5491: <p>Insert a marker at the end of the <a href="#list-of-active-formatting-elements">list of active
5492: formatting elements</a>.</p>
5493:
5494: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token, then
5495: switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-incaption" title="insertion mode: in caption">in caption</a>".</p>
5496:
5497: </dd>
5498:
5499: <dt>A start tag whose tag name is "colgroup"</dt>
5500: <dd>
5501:
5502: <p><a href="#clear-the-stack-back-to-a-table-context">Clear the stack back to a table context</a>. (See
5503: below.)</p>
5504:
5505: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token, then
5506: switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-incolgroup" title="insertion mode: in column group">in column
5507: group</a>".</p>
5508:
5509: </dd>
5510:
5511: <dt>A start tag whose tag name is "col"</dt>
5512: <dd>
5513: <p>Act as if a start tag token with the tag name "colgroup"
5514: had been seen, then reprocess the current token.</p>
5515: </dd>
5516:
5517: <dt>A start tag whose tag name is one of: "tbody", "tfoot", "thead"</dt>
5518: <dd>
5519:
5520: <p><a href="#clear-the-stack-back-to-a-table-context">Clear the stack back to a table context</a>. (See
5521: below.)</p>
5522:
5523: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token, then
5524: switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-intbody" title="insertion mode: in table body">in table
5525: body</a>".</p>
5526:
5527: </dd>
5528:
5529: <dt>A start tag whose tag name is one of: "td", "th", "tr"</dt>
5530: <dd>
5531: <p>Act as if a start tag token with the tag name "tbody" had
5532: been seen, then reprocess the current token.</p>
5533: </dd>
5534:
5535: <dt>A start tag whose tag name is "table"</dt>
5536: <dd>
5537:
5538: <p><a href="#parse-error">Parse error</a>. Act as if an end tag token with
5539: the tag name "table" had been seen, then, if that token wasn't
5540: ignored, reprocess the current token.</p>
5541:
5542: <p class="note">The fake end tag token here can only be
5543: ignored in the <a href="#fragment-case">fragment case</a>.</p>
5544:
5545: </dd>
5546:
5547: <dt>An end tag whose tag name is "table"</dt>
5548: <dd>
5549:
5550: <p>If the <a href="#stack-of-open-elements">stack of open elements</a> does not <a href="#has-an-element-in-table-scope" title="has an element in table scope">have an element in table
5551: scope</a> with the same tag name as the token, this is a
5552: <a href="#parse-error">parse error</a>. Ignore the token. (<a href="#fragment-case">fragment
5553: case</a>)</p>
5554:
5555: <p>Otherwise:</p>
5556:
5557: <p>Pop elements from this stack until a <code><a href="tabular-data.html#the-table-element">table</a></code>
5558: element has been popped from the stack.</p>
5559:
5560: <p><a href="#reset-the-insertion-mode-appropriately">Reset the insertion mode appropriately</a>.</p>
5561:
5562: </dd>
5563:
5564: <dt>An end tag whose tag name is one of: "body", "caption",
5565: "col", "colgroup", "html", "tbody", "td", "tfoot", "th",
5566: "thead", "tr"</dt>
5567: <dd>
5568: <p><a href="#parse-error">Parse error</a>. Ignore the token.</p>
5569: </dd>
5570:
5571: <dt>A start tag whose tag name is one of: "style", "script"</dt>
5572: <dd>
5573:
5574: <p>Process the token <a href="#using-the-rules-for">using the rules for</a> the "<a href="#parsing-main-inhead" title="insertion mode: in head">in head</a>" <a href="#insertion-mode">insertion
5575: mode</a>.</p>
5576:
5577: </dd>
5578:
5579: <dt>A start tag whose tag name is "input"</dt>
5580: <dd>
5581:
5582: <p>If the token does not have an attribute with the name "type",
5583: or if it does, but that attribute's value is not an <a href="infrastructure.html#ascii-case-insensitive">ASCII
5584: case-insensitive</a> match for the string "<code title="">hidden</code>", then: act as described in the "anything
5585: else" entry below.</p>
5586:
5587: <p>Otherwise:</p>
5588:
5589: <p><a href="#parse-error">Parse error</a>.</p>
5590:
5591: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token.</p>
5592:
5593: <p>Pop that <code><a href="forms.html#the-input-element">input</a></code> element off the <a href="#stack-of-open-elements">stack of
5594: open elements</a>.</p>
5595:
5596: </dd>
5597:
5598: <dt>An end-of-file token</dt>
5599: <dd>
5600:
5601: <p>If the <a href="#current-node">current node</a> is not the root
5602: <code><a href="semantics.html#the-html-element">html</a></code> element, then this is a <a href="#parse-error">parse
5603: error</a>.</p>
5604:
5605: <p class="note">It can only be the <a href="#current-node">current node</a> in
5606: the <a href="#fragment-case">fragment case</a>.</p>
5607:
5608: <p><a href="#stop-parsing">Stop parsing</a>.</p>
5609:
5610: </dd>
5611:
5612: <dt>Anything else</dt>
5613: <dd>
5614:
5615: <p><a href="#parse-error">Parse error</a>. Process the token <a href="#using-the-rules-for">using the
5616: rules for</a> the "<a href="#parsing-main-inbody" title="insertion mode: in body">in
5617: body</a>" <a href="#insertion-mode">insertion mode</a>, except that if the
5618: <a href="#current-node">current node</a> is a <code><a href="tabular-data.html#the-table-element">table</a></code>,
5619: <code><a href="tabular-data.html#the-tbody-element">tbody</a></code>, <code><a href="tabular-data.html#the-tfoot-element">tfoot</a></code>, <code><a href="tabular-data.html#the-thead-element">thead</a></code>, or
5620: <code><a href="tabular-data.html#the-tr-element">tr</a></code> element, then, whenever a node would be inserted
5621: into the <a href="#current-node">current node</a>, it must instead be <a href="#foster-parent" title="foster parent">foster parented</a>.</p>
5622:
5623: </dd>
5624:
5625: </dl><p>When the steps above require the UA to <dfn id="clear-the-stack-back-to-a-table-context">clear the stack
5626: back to a table context</dfn>, it means that the UA must, while
5627: the <a href="#current-node">current node</a> is not a <code><a href="tabular-data.html#the-table-element">table</a></code>
5628: element or an <code><a href="semantics.html#the-html-element">html</a></code> element, pop elements from the
5629: <a href="#stack-of-open-elements">stack of open elements</a>.</p>
5630:
5631: <p class="note">The <a href="#current-node">current node</a> being an
5632: <code><a href="semantics.html#the-html-element">html</a></code> element after this process is a <a href="#fragment-case">fragment
5633: case</a>.</p>
5634:
5635:
5636:
5637: <h5 id="parsing-main-intabletext"><span class="secno">9.2.5.13 </span>The "<dfn title="insertion mode: in table text">in table text</dfn>" insertion mode</h5>
5638:
5639: <p>When the <a href="#insertion-mode">insertion mode</a> is "<a href="#parsing-main-intabletext" title="insertion
5640: mode: in table text">in table text</a>", tokens must be handled
5641: as follows:</p>
5642:
5643: <dl class="switch"><dt>A character token</dt>
5644: <dd>
5645:
5646: <p>Append the character token to the <var><a href="#pending-table-character-tokens">pending table character
5647: tokens</a></var> list.</p>
5648:
5649: </dd>
5650:
5651:
5652: <dt>Anything else</dt>
5653: <dd>
5654:
5655: <p>If any of the tokens in the <var><a href="#pending-table-character-tokens">pending table character
5656: tokens</a></var> list are character tokens that are not one of U+0009
5657: CHARACTER TABULATION, U+000A LINE FEED (LF), U+000C FORM FEED
5658: (FF), <!--U+000D CARRIAGE RETURN (CR),--> or U+0020 SPACE, then
5659: reprocess those character tokens using the rules given in the
5660: "anything else" entry in the <a href="#parsing-main-intable" title="insertion mode: in
5661: table">in table</a>" insertion mode.</p>
5662:
5663: <p>Otherwise, <a href="#insert-a-character" title="insert a character">insert the
5664: characters</a> given by the <var><a href="#pending-table-character-tokens">pending table character
5665: tokens</a></var> list into the <a href="#current-node">current node</a>.</p>
5666:
5667: <p>Switch the <a href="#insertion-mode">insertion mode</a> to the <a href="#original-insertion-mode">original
5668: insertion mode</a> and reprocess the token.</p>
5669:
5670: </dd>
5671:
5672: </dl><h5 id="parsing-main-incaption"><span class="secno">9.2.5.14 </span>The "<dfn title="insertion mode: in caption">in caption</dfn>" insertion mode</h5>
5673:
5674: <p>When the <a href="#insertion-mode">insertion mode</a> is "<a href="#parsing-main-incaption" title="insertion
5675: mode: in caption">in caption</a>", tokens must be handled as follows:</p>
5676:
5677: <dl class="switch"><dt>An end tag whose tag name is "caption"</dt>
5678: <dd>
5679:
5680: <p>If the <a href="#stack-of-open-elements">stack of open elements</a> does not <a href="#has-an-element-in-table-scope" title="has an element in table scope">have an element in table
5681: scope</a> with the same tag name as the token, this is a
5682: <a href="#parse-error">parse error</a>. Ignore the token. (<a href="#fragment-case">fragment
5683: case</a>)</p>
5684:
5685: <p>Otherwise:</p>
5686:
5687: <p><a href="#generate-implied-end-tags">Generate implied end tags</a>.</p>
5688:
5689: <p>Now, if the <a href="#current-node">current node</a> is not a
5690: <code><a href="tabular-data.html#the-caption-element">caption</a></code> element, then this is a <a href="#parse-error">parse
5691: error</a>.</p>
5692:
5693: <p>Pop elements from this stack until a <code><a href="tabular-data.html#the-caption-element">caption</a></code>
5694: element has been popped from the stack.</p>
5695:
5696: <p><a href="#clear-the-list-of-active-formatting-elements-up-to-the-last-marker">Clear the list of active formatting elements up to
5697: the last marker</a>.</p>
5698:
5699: <p>Switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-intable" title="insertion mode: in table">in table</a>".</p>
5700:
5701: </dd>
5702:
5703: <dt>A start tag whose tag name is one of: "caption", "col",
5704: "colgroup", "tbody", "td", "tfoot", "th", "thead", "tr"</dt>
5705: <dt>An end tag whose tag name is "table"</dt>
5706: <dd>
5707:
5708: <p><a href="#parse-error">Parse error</a>. Act as if an end tag with the tag
5709: name "caption" had been seen, then, if that token wasn't
5710: ignored, reprocess the current token.</p>
5711:
5712: <p class="note">The fake end tag token here can only be
5713: ignored in the <a href="#fragment-case">fragment case</a>.</p>
5714:
5715: </dd>
5716:
5717: <dt>An end tag whose tag name is one of: "body", "col",
5718: "colgroup", "html", "tbody", "td", "tfoot", "th", "thead",
5719: "tr"</dt>
5720: <dd>
5721: <p><a href="#parse-error">Parse error</a>. Ignore the token.</p>
5722: </dd>
5723:
5724: <dt>Anything else</dt>
5725: <dd>
5726: <p>Process the token <a href="#using-the-rules-for">using the rules for</a> the "<a href="#parsing-main-inbody" title="insertion mode: in body">in body</a>" <a href="#insertion-mode">insertion
5727: mode</a>.</p>
5728: </dd>
5729:
5730: </dl><h5 id="parsing-main-incolgroup"><span class="secno">9.2.5.15 </span>The "<dfn title="insertion mode: in column group">in column group</dfn>" insertion mode</h5>
5731:
5732: <p>When the <a href="#insertion-mode">insertion mode</a> is "<a href="#parsing-main-incolgroup" title="insertion
5733: mode: in column group">in column group</a>", tokens must be handled as follows:</p>
5734:
5735: <dl class="switch"><dt>A character token that is one of U+0009 CHARACTER
5736: TABULATION, U+000A LINE FEED (LF), U+000C FORM FEED (FF),
5737: <!--U+000D CARRIAGE RETURN (CR),--> or U+0020 SPACE</dt>
5738: <dd>
5739: <p><a href="#insert-a-character" title="insert a character">Insert the character</a> into
5740: the <a href="#current-node">current node</a>.</p>
5741: </dd>
5742:
5743: <dt>A comment token</dt>
5744: <dd>
5745: <p>Append a <code>Comment</code> node to the <a href="#current-node">current
5746: node</a> with the <code title="">data</code> attribute set to
5747: the data given in the comment token.</p>
5748: </dd>
5749:
5750: <dt>A DOCTYPE token</dt>
5751: <dd>
5752: <p><a href="#parse-error">Parse error</a>. Ignore the token.</p>
5753: </dd>
5754:
5755: <dt>A start tag whose tag name is "html"</dt>
5756: <dd>
5757: <p>Process the token <a href="#using-the-rules-for">using the rules for</a> the "<a href="#parsing-main-inbody" title="insertion mode: in body">in body</a>" <a href="#insertion-mode">insertion
5758: mode</a>.</p>
5759: </dd>
5760:
5761: <dt>A start tag whose tag name is "col"</dt>
5762: <dd>
5763:
5764: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token. Immediately
5765: pop the <a href="#current-node">current node</a> off the <a href="#stack-of-open-elements">stack of open
5766: elements</a>.</p>
5767:
5768: <p><a href="#acknowledge-self-closing-flag" title="acknowledge self-closing flag">Acknowledge the
5769: token's <i>self-closing flag</i></a>, if it is set.</p>
5770:
5771: </dd>
5772:
5773: <dt>An end tag whose tag name is "colgroup"</dt>
5774: <dd>
5775:
5776: <p>If the <a href="#current-node">current node</a> is the root
5777: <code><a href="semantics.html#the-html-element">html</a></code> element, then this is a <a href="#parse-error">parse
5778: error</a>; ignore the token. (<a href="#fragment-case">fragment
5779: case</a>)</p>
5780:
5781: <p>Otherwise, pop the <a href="#current-node">current node</a> (which will be
5782: a <code><a href="tabular-data.html#the-colgroup-element">colgroup</a></code> element) from the <a href="#stack-of-open-elements">stack of open
5783: elements</a>. Switch the <a href="#insertion-mode">insertion mode</a> to
5784: "<a href="#parsing-main-intable" title="insertion mode: in table">in table</a>".</p>
5785:
5786: </dd>
5787:
5788: <dt>An end tag whose tag name is "col"</dt>
5789: <dd>
5790: <p><a href="#parse-error">Parse error</a>. Ignore the token.</p>
5791: </dd>
5792:
5793: <dt>An end-of-file token</dt>
5794: <dd>
5795:
5796: <p>If the <a href="#current-node">current node</a> is the root <code><a href="semantics.html#the-html-element">html</a></code>
5797: element, then <a href="#stop-parsing">stop parsing</a>. (<a href="#fragment-case">fragment
5798: case</a>)</p>
5799:
5800: <p>Otherwise, act as described in the "anything else" entry
5801: below.</p>
5802:
5803: </dd>
5804:
5805: <dt>Anything else</dt>
5806: <dd>
5807:
5808: <p>Act as if an end tag with the tag name "colgroup" had been
5809: seen, and then, if that token wasn't ignored, reprocess the
5810: current token.</p>
5811:
5812: <p class="note">The fake end tag token here can only be
5813: ignored in the <a href="#fragment-case">fragment case</a>.</p>
5814:
5815: </dd>
5816:
5817: </dl><h5 id="parsing-main-intbody"><span class="secno">9.2.5.16 </span>The "<dfn title="insertion mode: in table body">in table body</dfn>" insertion mode</h5>
5818:
5819: <p>When the <a href="#insertion-mode">insertion mode</a> is "<a href="#parsing-main-intbody" title="insertion
5820: mode: in table body">in table body</a>", tokens must be handled as follows:</p>
5821:
5822: <dl class="switch"><dt>A start tag whose tag name is "tr"</dt>
5823: <dd>
5824:
5825: <p><a href="#clear-the-stack-back-to-a-table-body-context">Clear the stack back to a table body
5826: context</a>. (See below.)</p>
5827:
5828: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token, then switch
5829: the <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-intr" title="insertion mode:
5830: in row">in row</a>".</p>
5831:
5832: </dd>
5833:
5834: <dt>A start tag whose tag name is one of: "th", "td"</dt>
5835: <dd>
5836: <p><a href="#parse-error">Parse error</a>. Act as if a start tag with
5837: the tag name "tr" had been seen, then reprocess the current
5838: token.</p>
5839: </dd>
5840:
5841: <dt>An end tag whose tag name is one of: "tbody", "tfoot",
5842: "thead"</dt>
5843: <dd>
5844:
5845: <p>If the <a href="#stack-of-open-elements">stack of open elements</a> does not <a href="#has-an-element-in-table-scope" title="has an element in table scope">have an element in table
5846: scope</a> with the same tag name as the token, this is a
5847: <a href="#parse-error">parse error</a>. Ignore the token.</p>
5848:
5849: <p>Otherwise:</p>
5850:
5851: <p><a href="#clear-the-stack-back-to-a-table-body-context">Clear the stack back to a table body
5852: context</a>. (See below.)</p>
5853:
5854: <p>Pop the <a href="#current-node">current node</a> from the <a href="#stack-of-open-elements">stack of
5855: open elements</a>. Switch the <a href="#insertion-mode">insertion mode</a>
5856: to "<a href="#parsing-main-intable" title="insertion mode: in table">in table</a>".</p>
5857:
5858: </dd>
5859:
5860: <dt>A start tag whose tag name is one of: "caption", "col",
5861: "colgroup", "tbody", "tfoot", "thead"</dt>
5862: <dt>An end tag whose tag name is "table"</dt>
5863: <dd>
5864:
5865: <p>If the <a href="#stack-of-open-elements">stack of open elements</a> does not <a href="#has-an-element-in-table-scope" title="has an element in table scope">have a
5866: <code>tbody</code>, <code>thead</code>, or <code>tfoot</code>
5867: element in table scope</a>, this is a <a href="#parse-error">parse
5868: error</a>. Ignore the token. (<a href="#fragment-case">fragment
5869: case</a>)</p>
5870:
5871: <p>Otherwise:</p>
5872:
5873: <p><a href="#clear-the-stack-back-to-a-table-body-context">Clear the stack back to a table body
5874: context</a>. (See below.)</p>
5875:
5876: <p>Act as if an end tag with the same tag name as the
5877: <a href="#current-node">current node</a> ("tbody", "tfoot", or "thead") had
5878: been seen, then reprocess the current token.</p>
5879:
5880: </dd>
5881:
5882: <dt>An end tag whose tag name is one of: "body", "caption",
5883: "col", "colgroup", "html", "td", "th", "tr"</dt>
5884: <dd>
5885: <p><a href="#parse-error">Parse error</a>. Ignore the token.</p>
5886: </dd>
5887:
5888: <dt>Anything else</dt>
5889: <dd>
5890: <p>Process the token <a href="#using-the-rules-for">using the rules for</a> the "<a href="#parsing-main-intable" title="insertion mode: in table">in table</a>" <a href="#insertion-mode">insertion
5891: mode</a>.</p>
5892: </dd>
5893:
5894: </dl><p>When the steps above require the UA to <dfn id="clear-the-stack-back-to-a-table-body-context">clear the stack
5895: back to a table body context</dfn>, it means that the UA must,
5896: while the <a href="#current-node">current node</a> is not a <code><a href="tabular-data.html#the-tbody-element">tbody</a></code>,
5897: <code><a href="tabular-data.html#the-tfoot-element">tfoot</a></code>, <code><a href="tabular-data.html#the-thead-element">thead</a></code>, or <code><a href="semantics.html#the-html-element">html</a></code>
5898: element, pop elements from the <a href="#stack-of-open-elements">stack of open
5899: elements</a>.</p>
5900:
5901: <p class="note">The <a href="#current-node">current node</a> being an
5902: <code><a href="semantics.html#the-html-element">html</a></code> element after this process is a <a href="#fragment-case">fragment
5903: case</a>.</p>
5904:
5905:
5906: <h5 id="parsing-main-intr"><span class="secno">9.2.5.17 </span>The "<dfn title="insertion mode: in row">in row</dfn>" insertion mode</h5>
5907:
5908: <p>When the <a href="#insertion-mode">insertion mode</a> is "<a href="#parsing-main-intr" title="insertion
5909: mode: in row">in row</a>", tokens must be handled as follows:</p>
5910:
5911: <dl class="switch"><dt>A start tag whose tag name is one of: "th", "td"</dt>
5912: <dd>
5913:
5914: <p><a href="#clear-the-stack-back-to-a-table-row-context">Clear the stack back to a table row
5915: context</a>. (See below.)</p>
5916:
5917: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token, then switch
5918: the <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-intd" title="insertion mode:
5919: in cell">in cell</a>".</p>
5920:
5921: <p>Insert a marker at the end of the <a href="#list-of-active-formatting-elements">list of active
5922: formatting elements</a>.</p>
5923:
5924: </dd>
5925:
5926: <dt>An end tag whose tag name is "tr"</dt>
5927: <dd>
5928:
5929: <p>If the <a href="#stack-of-open-elements">stack of open elements</a> does not <a href="#has-an-element-in-table-scope" title="has an element in table scope">have an element in table
5930: scope</a> with the same tag name as the token, this is a
5931: <a href="#parse-error">parse error</a>. Ignore the token. (<a href="#fragment-case">fragment
5932: case</a>)</p>
5933:
5934: <p>Otherwise:</p>
5935:
5936: <p><a href="#clear-the-stack-back-to-a-table-row-context">Clear the stack back to a table row
5937: context</a>. (See below.)</p>
5938:
5939: <p>Pop the <a href="#current-node">current node</a> (which will be a
5940: <code><a href="tabular-data.html#the-tr-element">tr</a></code> element) from the <a href="#stack-of-open-elements">stack of open
5941: elements</a>. Switch the <a href="#insertion-mode">insertion mode</a> to
5942: "<a href="#parsing-main-intbody" title="insertion mode: in table body">in table
5943: body</a>".</p>
5944:
5945: </dd>
5946:
5947: <dt>A start tag whose tag name is one of: "caption", "col",
5948: "colgroup", "tbody", "tfoot", "thead", "tr"</dt>
5949: <dt>An end tag whose tag name is "table"</dt>
5950: <dd>
5951:
5952: <p>Act as if an end tag with the tag name "tr" had been seen,
5953: then, if that token wasn't ignored, reprocess the current
5954: token.</p>
5955:
5956: <p class="note">The fake end tag token here can only be
5957: ignored in the <a href="#fragment-case">fragment case</a>.</p>
5958:
5959: </dd>
5960:
5961: <dt>An end tag whose tag name is one of: "tbody", "tfoot",
5962: "thead"</dt>
5963: <dd>
5964:
5965: <p>If the <a href="#stack-of-open-elements">stack of open elements</a> does not <a href="#has-an-element-in-table-scope" title="has an element in table scope">have an element in table
5966: scope</a> with the same tag name as the token, this is a
5967: <a href="#parse-error">parse error</a>. Ignore the token.</p>
5968:
5969: <p>Otherwise, act as if an end tag with the tag name "tr" had
5970: been seen, then reprocess the current token.</p>
5971:
5972: </dd>
5973:
5974: <dt>An end tag whose tag name is one of: "body", "caption",
5975: "col", "colgroup", "html", "td", "th"</dt>
5976: <dd>
5977: <p><a href="#parse-error">Parse error</a>. Ignore the token.</p>
5978: </dd>
5979:
5980: <dt>Anything else</dt>
5981: <dd>
5982: <p>Process the token <a href="#using-the-rules-for">using the rules for</a> the "<a href="#parsing-main-intable" title="insertion mode: in table">in table</a>" <a href="#insertion-mode">insertion
5983: mode</a>.</p>
5984: </dd>
5985:
5986: </dl><p>When the steps above require the UA to <dfn id="clear-the-stack-back-to-a-table-row-context">clear the stack
5987: back to a table row context</dfn>, it means that the UA must,
5988: while the <a href="#current-node">current node</a> is not a <code><a href="tabular-data.html#the-tr-element">tr</a></code>
5989: element or an <code><a href="semantics.html#the-html-element">html</a></code> element, pop elements from the
5990: <a href="#stack-of-open-elements">stack of open elements</a>.</p>
5991:
5992: <p class="note">The <a href="#current-node">current node</a> being an
5993: <code><a href="semantics.html#the-html-element">html</a></code> element after this process is a <a href="#fragment-case">fragment
5994: case</a>.</p>
5995:
5996:
5997: <h5 id="parsing-main-intd"><span class="secno">9.2.5.18 </span>The "<dfn title="insertion mode: in cell">in cell</dfn>" insertion mode</h5>
5998:
5999: <p>When the <a href="#insertion-mode">insertion mode</a> is "<a href="#parsing-main-intd" title="insertion
6000: mode: in cell">in cell</a>", tokens must be handled as follows:</p>
6001:
6002: <dl class="switch"><dt>An end tag whose tag name is one of: "td", "th"</dt>
6003: <dd>
6004:
6005: <p>If the <a href="#stack-of-open-elements">stack of open elements</a> does not <a href="#has-an-element-in-table-scope" title="has an element in table scope">have an element in table
6006: scope</a> with the same tag name as that of the token, then
6007: this is a <a href="#parse-error">parse error</a> and the token must be
6008: ignored.</p>
6009:
6010: <p>Otherwise:</p>
6011:
6012: <p><a href="#generate-implied-end-tags">Generate implied end tags</a>.</p>
6013:
6014: <p>Now, if the <a href="#current-node">current node</a> is not an element
6015: with the same tag name as the token, then this is a
6016: <a href="#parse-error">parse error</a>.</p>
6017:
6018: <p>Pop elements from this stack until an element with the same
6019: tag name as the token has been popped from the stack.</p>
6020:
6021: <p><a href="#clear-the-list-of-active-formatting-elements-up-to-the-last-marker">Clear the list of active formatting elements up to
6022: the last marker</a>.</p>
6023:
6024: <p>Switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-intr" title="insertion mode: in row">in row</a>". (The
6025: <a href="#current-node">current node</a> will be a <code><a href="tabular-data.html#the-tr-element">tr</a></code> element at
6026: this point.)</p>
6027:
6028: </dd>
6029:
6030: <dt>A start tag whose tag name is one of: "caption", "col",
6031: "colgroup", "tbody", "td", "tfoot", "th", "thead", "tr"</dt>
6032: <dd>
6033:
6034: <p>If the <a href="#stack-of-open-elements">stack of open elements</a> does
6035: <em>not</em> <a href="#has-an-element-in-table-scope" title="has an element in table scope">have
6036: a <code>td</code> or <code>th</code> element in table
6037: scope</a>, then this is a <a href="#parse-error">parse error</a>; ignore
6038: the token. (<a href="#fragment-case">fragment case</a>)</p>
6039:
6040: <p>Otherwise, <a href="#close-the-cell">close the cell</a> (see below) and
6041: reprocess the current token.</p>
6042:
6043: </dd>
6044:
6045: <dt>An end tag whose tag name is one of: "body", "caption",
6046: "col", "colgroup", "html"</dt>
6047: <dd>
6048: <p><a href="#parse-error">Parse error</a>. Ignore the token.</p>
6049: </dd>
6050:
6051: <dt>An end tag whose tag name is one of: "table", "tbody",
6052: "tfoot", "thead", "tr"</dt>
6053: <dd>
6054:
6055: <p>If the <a href="#stack-of-open-elements">stack of open elements</a> does not <a href="#has-an-element-in-table-scope" title="has an element in table scope">have an element in table
6056: scope</a> with the same tag name as that of the token
6057: (which can only happen for "tbody", "tfoot" and "thead", or,
6058: in the <a href="#fragment-case">fragment case</a>), then this is a <a href="#parse-error">parse
6059: error</a> and the token must be ignored.</p>
6060:
6061: <p>Otherwise, <a href="#close-the-cell">close the cell</a> (see below) and
6062: reprocess the current token.</p>
6063:
6064: </dd>
6065:
6066: <dt>Anything else</dt>
6067: <dd>
6068: <p>Process the token <a href="#using-the-rules-for">using the rules for</a> the "<a href="#parsing-main-inbody" title="insertion mode: in body">in body</a>" <a href="#insertion-mode">insertion
6069: mode</a>.</p>
6070: </dd>
6071:
6072: </dl><p>Where the steps above say to <dfn id="close-the-cell">close the cell</dfn>, they
6073: mean to run the following algorithm:</p>
6074:
6075: <ol><li><p>If the <a href="#stack-of-open-elements">stack of open elements</a> <a href="#has-an-element-in-table-scope" title="has an element in table scope">has a <code>td</code>
6076: element in table scope</a>, then act as if an end tag token
6077: with the tag name "td" had been seen.</p></li>
6078:
6079: <li><p>Otherwise, the <a href="#stack-of-open-elements">stack of open elements</a> will
6080: <a href="#has-an-element-in-table-scope" title="has an element in table scope">have a
6081: <code>th</code> element in table scope</a>; act as if an end
6082: tag token with the tag name "th" had been seen.</p></li>
6083:
6084: </ol><p class="note">The <a href="#stack-of-open-elements">stack of open elements</a> cannot
6085: have both a <code><a href="tabular-data.html#the-td-element">td</a></code> and a <code><a href="tabular-data.html#the-th-element">th</a></code> element <a href="#has-an-element-in-table-scope" title="has an element in table scope">in table scope</a> at
6086: the same time, nor can it have neither when the <a href="#insertion-mode">insertion
6087: mode</a> is "<a href="#parsing-main-intd" title="insertion mode: in cell">in
6088: cell</a>".</p>
6089:
6090:
6091: <h5 id="parsing-main-inselect"><span class="secno">9.2.5.19 </span>The "<dfn title="insertion mode: in select">in select</dfn>" insertion mode</h5>
6092:
6093: <p>When the <a href="#insertion-mode">insertion mode</a> is "<a href="#parsing-main-inselect" title="insertion
6094: mode: in select">in select</a>", tokens must be handled as follows:</p>
6095:
6096: <dl class="switch"><dt>A character token</dt>
6097: <dd>
6098: <p><a href="#insert-a-character" title="insert a character">Insert the token's
6099: character</a> into the <a href="#current-node">current node</a>.</p>
6100: </dd>
6101:
6102: <dt>A comment token</dt>
6103: <dd>
6104: <p>Append a <code>Comment</code> node to the <a href="#current-node">current
6105: node</a> with the <code title="">data</code> attribute set to
6106: the data given in the comment token.</p>
6107: </dd>
6108:
6109: <dt>A DOCTYPE token</dt>
6110: <dd>
6111: <p><a href="#parse-error">Parse error</a>. Ignore the token.</p>
6112: </dd>
6113:
6114: <dt>A start tag whose tag name is "html"</dt>
6115: <dd>
6116: <p>Process the token <a href="#using-the-rules-for">using the rules for</a> the "<a href="#parsing-main-inbody" title="insertion mode: in body">in body</a>" <a href="#insertion-mode">insertion
6117: mode</a>.</p>
6118: </dd>
6119:
6120: <dt>A start tag whose tag name is "option"</dt>
6121: <dd>
6122:
6123: <p>If the <a href="#current-node">current node</a> is an <code><a href="forms.html#the-option-element">option</a></code>
6124: element, act as if an end tag with the tag name "option" had
6125: been seen.</p>
6126:
6127: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token.</p>
6128:
6129: </dd>
6130:
6131: <dt>A start tag whose tag name is "optgroup"</dt>
6132: <dd>
6133:
6134: <p>If the <a href="#current-node">current node</a> is an <code><a href="forms.html#the-option-element">option</a></code>
6135: element, act as if an end tag with the tag name "option" had
6136: been seen.</p>
6137:
6138: <p>If the <a href="#current-node">current node</a> is an
6139: <code><a href="forms.html#the-optgroup-element">optgroup</a></code> element, act as if an end tag with the
6140: tag name "optgroup" had been seen.</p>
6141:
6142: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token.</p>
6143:
6144: </dd>
6145:
6146: <dt>An end tag whose tag name is "optgroup"</dt>
6147: <dd>
6148:
6149: <p>First, if the <a href="#current-node">current node</a> is an
6150: <code><a href="forms.html#the-option-element">option</a></code> element, and the node immediately before
6151: it in the <a href="#stack-of-open-elements">stack of open elements</a> is an
6152: <code><a href="forms.html#the-optgroup-element">optgroup</a></code> element, then act as if an end tag with
6153: the tag name "option" had been seen.</p>
6154:
6155: <p>If the <a href="#current-node">current node</a> is an
6156: <code><a href="forms.html#the-optgroup-element">optgroup</a></code> element, then pop that node from the
6157: <a href="#stack-of-open-elements">stack of open elements</a>. Otherwise, this is a
6158: <a href="#parse-error">parse error</a>; ignore the token.</p>
6159:
6160: </dd>
6161:
6162: <dt>An end tag whose tag name is "option"</dt>
6163: <dd>
6164:
6165: <p>If the <a href="#current-node">current node</a> is an <code><a href="forms.html#the-option-element">option</a></code>
6166: element, then pop that node from the <a href="#stack-of-open-elements">stack of open
6167: elements</a>. Otherwise, this is a <a href="#parse-error">parse
6168: error</a>; ignore the token.</p>
6169:
6170: </dd>
6171:
6172: <dt>An end tag whose tag name is "select"</dt>
6173: <dd>
6174:
6175: <p>If the <a href="#stack-of-open-elements">stack of open elements</a> does not <a href="#has-an-element-in-table-scope" title="has an element in table scope">have an element in table
6176: scope</a> with the same tag name as the token, this is a
6177: <a href="#parse-error">parse error</a>. Ignore the token. (<a href="#fragment-case">fragment
6178: case</a>)</p>
6179:
6180: <p>Otherwise:</p>
6181:
6182: <p>Pop elements from the <a href="#stack-of-open-elements">stack of open elements</a>
6183: until a <code><a href="forms.html#the-select-element">select</a></code> element has been popped from the
6184: stack.</p>
6185:
6186: <p><a href="#reset-the-insertion-mode-appropriately">Reset the insertion mode appropriately</a>.</p>
6187:
6188: </dd>
6189:
6190: <dt>A start tag whose tag name is "select"</dt>
6191: <dd>
6192:
6193: <p><a href="#parse-error">Parse error</a>. Act as if the token had been
6194: an end tag with the tag name "select" instead.</p>
6195:
6196: </dd>
6197:
6198: <dt>A start tag whose tag name is one of: "input", "keygen", "textarea"</dt>
6199: <dd>
6200: <p><a href="#parse-error">Parse error</a>. Act as if an end tag with the tag
6201: name "select" had been seen, and reprocess the token.</p>
6202: </dd>
6203:
6204: <dt>A start tag token whose tag name is "script"</dt>
6205: <dd>
6206: <p>Process the token <a href="#using-the-rules-for">using the rules for</a> the "<a href="#parsing-main-inhead" title="insertion mode: in head">in head</a>" <a href="#insertion-mode">insertion
6207: mode</a>.</p>
6208: </dd>
6209:
6210: <dt>An end-of-file token</dt>
6211: <dd>
6212:
6213: <p>If the <a href="#current-node">current node</a> is not the root
6214: <code><a href="semantics.html#the-html-element">html</a></code> element, then this is a <a href="#parse-error">parse
6215: error</a>.</p>
6216:
6217: <p class="note">It can only be the <a href="#current-node">current node</a> in
6218: the <a href="#fragment-case">fragment case</a>.</p>
6219:
6220: <p><a href="#stop-parsing">Stop parsing</a>.</p>
6221:
6222: </dd>
6223:
6224: <dt>Anything else</dt>
6225: <dd>
6226: <p><a href="#parse-error">Parse error</a>. Ignore the token.</p>
6227: </dd>
6228:
6229: </dl><h5 id="parsing-main-inselectintable"><span class="secno">9.2.5.20 </span>The "<dfn title="insertion mode: in select in table">in select in table</dfn>" insertion mode</h5>
6230:
6231: <p>When the <a href="#insertion-mode">insertion mode</a> is "<a href="#parsing-main-inselectintable" title="insertion
6232: mode: in select in table">in select in table</a>", tokens must be handled as follows:</p>
6233:
6234: <dl class="switch"><dt>A start tag whose tag name is one of: "caption", "table",
6235: "tbody", "tfoot", "thead", "tr", "td", "th"</dt>
6236: <dd>
6237: <p><a href="#parse-error">Parse error</a>. Act as if an end tag with the tag
6238: name "select" had been seen, and reprocess the token.</p>
6239: </dd>
6240:
6241: <dt>An end tag whose tag name is one of: "caption", "table",
6242: "tbody", "tfoot", "thead", "tr", "td", "th"</dt>
6243: <dd>
6244:
6245: <p><a href="#parse-error">Parse error</a>.</p>
6246:
6247: <p>If the <a href="#stack-of-open-elements">stack of open elements</a> <a href="#has-an-element-in-table-scope">has an
6248: element in table scope</a> with the same tag name as that
6249: of the token, then act as if an end tag with the tag name
6250: "select" had been seen, and reprocess the token. Otherwise,
6251: ignore the token.</p>
6252:
6253: </dd>
6254:
6255: <dt>Anything else</dt>
6256: <dd>
6257: <p>Process the token <a href="#using-the-rules-for">using the rules for</a> the "<a href="#parsing-main-inselect" title="insertion mode: in select">in select</a>" <a href="#insertion-mode">insertion
6258: mode</a>.</p>
6259: </dd>
6260:
6261: </dl><h5 id="parsing-main-inforeign"><span class="secno">9.2.5.21 </span>The "<dfn title="insertion mode: in foreign content">in foreign content</dfn>" insertion mode</h5>
6262:
6263: <p>When the <a href="#insertion-mode">insertion mode</a> is "<a href="#parsing-main-inforeign" title="insertion
6264: mode: in foreign content">in foreign content</a>", tokens must be
6265: handled as follows:</p>
6266:
6267: <dl class="switch"><dt>A character token</dt>
6268: <dd>
6269:
6270: <p><a href="#insert-a-character" title="insert a character">Insert the token's
6271: character</a> into the <a href="#current-node">current node</a>.</p>
6272:
6273: <p>If the token is not one of U+0009 CHARACTER TABULATION, U+000A
6274: LINE FEED (LF), U+000C FORM FEED (FF), <!--U+000D CARRIAGE RETURN
6275: (CR),--> or U+0020 SPACE, then set the <a href="#frameset-ok-flag">frameset-ok
6276: flag</a> to "not ok".</p>
6277:
6278: </dd>
6279:
6280: <dt>A comment token</dt>
6281: <dd>
6282: <p>Append a <code>Comment</code> node to the <a href="#current-node">current
6283: node</a> with the <code title="">data</code> attribute set to
6284: the data given in the comment token.</p>
6285: </dd>
6286:
6287: <dt>A DOCTYPE token</dt>
6288: <dd>
6289: <p><a href="#parse-error">Parse error</a>. Ignore the token.</p>
6290: </dd>
6291:
6292: <dt>An end tag whose tag name is "script", if the <a href="#current-node">current node</a> is a <code title="">script</code> element in the <a href="#svg-namespace">SVG namespace</a>.</dt>
6293: <dd>
6294:
6295: <p>Pop the <a href="#current-node">current node</a> off the <a href="#stack-of-open-elements">stack of open
6296: elements</a>.</p>
6297:
6298: <p>Let the <var title="">old insertion point</var> have the
6299: same value as the current <a href="#insertion-point">insertion point</a>. Let
6300: the <a href="#insertion-point">insertion point</a> be just before the <a href="#next-input-character">next
6301: input character</a>.</p>
6302:
6303: <p>Increment the parser's <a href="#script-nesting-level">script nesting level</a> by
6304: one. Set the <a href="#parser-pause-flag">parser pause flag</a> to true.</p>
6305:
6306: <p><a href="http://www.w3.org/TR/SVGMobile12/script.html#ScriptContentProcessing">Process
6307: the <code title="">script</code> element</a> according to the SVG
6308: rules. <a href="references.html#references">[SVG]</a></p>
6309:
6310: <p class="note">Even if this causes <a href="dom.html#dom-document-write" title="dom-document-write">new characters to be inserted into the
6311: tokenizer</a>, the parser will not be executed reentrantly,
6312: since the <a href="#parser-pause-flag">parser pause flag</a> is true.</p>
6313:
6314: <p>Decrement the parser's <a href="#script-nesting-level">script nesting level</a> by
6315: one. If the parser's <a href="#script-nesting-level">script nesting level</a> is zero,
6316: then set the <a href="#parser-pause-flag">parser pause flag</a> to false.</p>
6317:
6318: <p>Let the <a href="#insertion-point">insertion point</a> have the value of the <var title="">old insertion point</var>. (In other words, restore the
6319: <a href="#insertion-point">insertion point</a> to its previous value. This value
6320: might be the "undefined" value.)</p>
6321:
6322: </dd>
6323:
6324: <dt>A start tag whose tag name is neither "mglyph" nor "malignmark", if the <a href="#current-node">current node</a> is an <code title="">mi</code> element in the <a href="#mathml-namespace">MathML namespace</a>.</dt>
6325: <dt>A start tag whose tag name is neither "mglyph" nor "malignmark", if the <a href="#current-node">current node</a> is an <code title="">mo</code> element in the <a href="#mathml-namespace">MathML namespace</a>.</dt>
6326: <dt>A start tag whose tag name is neither "mglyph" nor "malignmark", if the <a href="#current-node">current node</a> is an <code title="">mn</code> element in the <a href="#mathml-namespace">MathML namespace</a>.</dt>
6327: <dt>A start tag whose tag name is neither "mglyph" nor "malignmark", if the <a href="#current-node">current node</a> is an <code title="">ms</code> element in the <a href="#mathml-namespace">MathML namespace</a>.</dt>
6328: <dt>A start tag whose tag name is neither "mglyph" nor "malignmark", if the <a href="#current-node">current node</a> is an <code title="">mtext</code> element in the <a href="#mathml-namespace">MathML namespace</a>.</dt>
6329: <dt>A start tag whose tag name is "svg", if the <a href="#current-node">current node</a> is an <code title="">annotation-xml</code> element in the <a href="#mathml-namespace">MathML namespace</a>.</dt>
6330: <dt>A start tag, if the <a href="#current-node">current node</a> is a <code title="">foreignObject</code> element in the <a href="#svg-namespace">SVG namespace</a>.</dt>
6331: <dt>A start tag, if the <a href="#current-node">current node</a> is a <code title="">desc</code> element in the <a href="#svg-namespace">SVG namespace</a>.</dt>
6332: <dt>A start tag, if the <a href="#current-node">current node</a> is a <code title="">title</code> element in the <a href="#svg-namespace">SVG namespace</a>.</dt>
6333: <dt>A start tag, if the <a href="#current-node">current node</a> is an element in the <a href="#html-namespace-0">HTML namespace</a>.</dt>
6334: <dt>An end tag</dt>
6335: <dd>
6336:
6337: <p>Process the token <a href="#using-the-rules-for">using the rules for</a> the
6338: <a href="#secondary-insertion-mode">secondary insertion mode</a>.</p>
6339:
6340: <p>If, after doing so, the <a href="#insertion-mode">insertion mode</a> is still
6341: "<a href="#parsing-main-inforeign" title="insertion mode: in foreign content">in foreign
6342: content</a>", but there is no element in scope that has a
6343: namespace other than the <a href="#html-namespace-0">HTML namespace</a><!-- XXX this
6344: isn't well-defined; it means check to see if the bottom-most HTML
6345: element on the stack is in scope -->, switch the <a href="#insertion-mode">insertion
6346: mode</a> to the <a href="#secondary-insertion-mode">secondary insertion mode</a>.</p>
6347:
6348: </dd>
6349:
6350: <dt>A start tag whose tag name is one of: <!--"a",--> "b", "big",
6351: "blockquote", "body"<!--by inspection-->, "br", "center", "code",
6352: "dd", "div", "dl", "dt"<!-- so that dd and dt can be handled
6353: uniformly throughout the parser -->, "em", "embed", "h1", "h2",
6354: "h3", "h4"<!--for completeness-->, "h5", "h6"<!--for
6355: completeness-->, "head"<!--by inspection-->, "hr", "i", "img",
6356: "li", "listing"<!-- so that pre and listing can be handled
6357: uniformly throughout the parser -->, "menu", "meta", "nobr",
6358: "ol"<!-- so that dl, ul, and ol can be handled uniformly throughout
6359: the parser -->, "p", "pre", "ruby", "s", <!--"script",--> "small",
6360: "span", "strong", "strike"<!-- so that s and strike can be handled
6361: uniformly throughout the parser -->, <!--"style",--> "sub", "sup",
6362: "table"<!--by inspection-->, "tt", "u", "ul", "var"</dt>
6363: <!-- this list was determined empirically by studying over
6364: 6,000,000,000 pages that were specifically not XML pages -->
6365: <dt>A start tag whose tag name is "font", if the token has
6366: any attributes named "color", "face", or "size"</dt>
6367: <!-- the attributes here are required so that SVG <font> will go
6368: through as SVG but legacy <font>s won't -->
6369: <dt>An end-of-file token</dt>
6370: <dd>
6371:
6372: <p><a href="#parse-error">Parse error</a>.</p>
6373:
6374: <p>Pop elements from the <a href="#stack-of-open-elements">stack of open elements</a> until
6375: the <a href="#current-node">current node</a> is in the <a href="#html-namespace-0">HTML
6376: namespace</a>.</p>
6377:
6378: <p>Switch the <a href="#insertion-mode">insertion mode</a> to the <a href="#secondary-insertion-mode">secondary
6379: insertion mode</a>, and reprocess the token.</p>
6380:
6381: </dd>
6382:
6383: <dt>Any other start tag</dt>
6384: <dd>
6385:
6386: <p>If the <a href="#current-node">current node</a> is an element in the
6387: <a href="#mathml-namespace">MathML namespace</a>, <a href="#adjust-mathml-attributes">adjust MathML
6388: attributes</a> for the token. (This fixes the case of MathML
6389: attributes that are not all lowercase.)</p>
6390:
6391: <p>If the <a href="#current-node">current node</a> is an element in the <a href="#svg-namespace">SVG
6392: namespace</a>, and the token's tag name is one of the ones in
6393: the first column of the following table, change the tag name to
6394: the name given in the corresponding cell in the second
6395: column. (This fixes the case of SVG elements that are not all
6396: lowercase.)</p>
6397:
6398: <table><thead><tr><th> Tag name </th><th> Element name
6399: </th></tr></thead><tbody><tr><td> <code title="">altglyph</code> </td><td> <code title="">altGlyph</code>
6400: </td></tr><tr><td> <code title="">altglyphdef</code> </td><td> <code title="">altGlyphDef</code>
6401: </td></tr><tr><td> <code title="">altglyphitem</code> </td><td> <code title="">altGlyphItem</code>
6402: </td></tr><tr><td> <code title="">animatecolor</code> </td><td> <code title="">animateColor</code>
6403: </td></tr><tr><td> <code title="">animatemotion</code> </td><td> <code title="">animateMotion</code>
6404: </td></tr><tr><td> <code title="">animatetransform</code> </td><td> <code title="">animateTransform</code>
6405: </td></tr><tr><td> <code title="">clippath</code> </td><td> <code title="">clipPath</code>
6406: </td></tr><tr><td> <code title="">feblend</code> </td><td> <code title="">feBlend</code>
6407: </td></tr><tr><td> <code title="">fecolormatrix</code> </td><td> <code title="">feColorMatrix</code>
6408: </td></tr><tr><td> <code title="">fecomponenttransfer</code> </td><td> <code title="">feComponentTransfer</code>
6409: </td></tr><tr><td> <code title="">fecomposite</code> </td><td> <code title="">feComposite</code>
6410: </td></tr><tr><td> <code title="">feconvolvematrix</code> </td><td> <code title="">feConvolveMatrix</code>
6411: </td></tr><tr><td> <code title="">fediffuselighting</code> </td><td> <code title="">feDiffuseLighting</code>
6412: </td></tr><tr><td> <code title="">fedisplacementmap</code> </td><td> <code title="">feDisplacementMap</code>
6413: </td></tr><tr><td> <code title="">fedistantlight</code> </td><td> <code title="">feDistantLight</code>
6414: </td></tr><tr><td> <code title="">feflood</code> </td><td> <code title="">feFlood</code>
6415: </td></tr><tr><td> <code title="">fefunca</code> </td><td> <code title="">feFuncA</code>
6416: </td></tr><tr><td> <code title="">fefuncb</code> </td><td> <code title="">feFuncB</code>
6417: </td></tr><tr><td> <code title="">fefuncg</code> </td><td> <code title="">feFuncG</code>
6418: </td></tr><tr><td> <code title="">fefuncr</code> </td><td> <code title="">feFuncR</code>
6419: </td></tr><tr><td> <code title="">fegaussianblur</code> </td><td> <code title="">feGaussianBlur</code>
6420: </td></tr><tr><td> <code title="">feimage</code> </td><td> <code title="">feImage</code>
6421: </td></tr><tr><td> <code title="">femerge</code> </td><td> <code title="">feMerge</code>
6422: </td></tr><tr><td> <code title="">femergenode</code> </td><td> <code title="">feMergeNode</code>
6423: </td></tr><tr><td> <code title="">femorphology</code> </td><td> <code title="">feMorphology</code>
6424: </td></tr><tr><td> <code title="">feoffset</code> </td><td> <code title="">feOffset</code>
6425: </td></tr><tr><td> <code title="">fepointlight</code> </td><td> <code title="">fePointLight</code>
6426: </td></tr><tr><td> <code title="">fespecularlighting</code> </td><td> <code title="">feSpecularLighting</code>
6427: </td></tr><tr><td> <code title="">fespotlight</code> </td><td> <code title="">feSpotLight</code>
6428: </td></tr><tr><td> <code title="">fetile</code> </td><td> <code title="">feTile</code>
6429: </td></tr><tr><td> <code title="">feturbulence</code> </td><td> <code title="">feTurbulence</code>
6430: </td></tr><tr><td> <code title="">foreignobject</code> </td><td> <code title="">foreignObject</code>
6431: </td></tr><tr><td> <code title="">glyphref</code> </td><td> <code title="">glyphRef</code>
6432: </td></tr><tr><td> <code title="">lineargradient</code> </td><td> <code title="">linearGradient</code>
6433: </td></tr><tr><td> <code title="">radialgradient</code> </td><td> <code title="">radialGradient</code>
6434: <!--<tr> <td> <code title="">solidcolor</code> <td> <code title="">solidColor</code> (SVG 1.2)-->
6435: </td></tr><tr><td> <code title="">textpath</code> </td><td> <code title="">textPath</code>
6436: </td></tr></tbody></table><p>If the <a href="#current-node">current node</a> is an element in the <a href="#svg-namespace">SVG
6437: namespace</a>, <a href="#adjust-svg-attributes">adjust SVG attributes</a> for the
6438: token. (This fixes the case of SVG attributes that are not all
6439: lowercase.)</p>
6440:
6441: <p><a href="#adjust-foreign-attributes">Adjust foreign attributes</a> for the token. (This
6442: fixes the use of namespaced attributes, in particular XLink in
6443: SVG.)</p>
6444:
6445: <p><a href="#insert-a-foreign-element">Insert a foreign element</a> for the token, in the
6446: same namespace as the <a href="#current-node">current node</a>.</p>
6447:
6448: <p>If the token has its <i>self-closing flag</i> set, pop the
6449: <a href="#current-node">current node</a> off the <a href="#stack-of-open-elements">stack of open
6450: elements</a> and <a href="#acknowledge-self-closing-flag" title="acknowledge self-closing
6451: flag">acknowledge the token's <i>self-closing flag</i></a>.</p>
6452:
6453: </dd>
6454:
6455: </dl><h5 id="parsing-main-afterbody"><span class="secno">9.2.5.22 </span>The "<dfn title="insertion mode: after body">after body</dfn>" insertion mode</h5>
6456:
6457: <p>When the <a href="#insertion-mode">insertion mode</a> is "<a href="#parsing-main-afterbody" title="insertion
6458: mode: after body">after body</a>", tokens must be handled as follows:</p>
6459:
6460: <dl class="switch"><dt>A character token that is one of U+0009 CHARACTER
6461: TABULATION, U+000A LINE FEED (LF), U+000C FORM FEED (FF),
6462: <!--U+000D CARRIAGE RETURN (CR),--> or U+0020 SPACE</dt>
6463: <dd>
6464: <p>Process the token <a href="#using-the-rules-for">using the rules for</a> the "<a href="#parsing-main-inbody" title="insertion mode: in body">in body</a>" <a href="#insertion-mode">insertion
6465: mode</a>.</p>
6466: </dd>
6467:
6468: <dt>A comment token</dt>
6469: <dd>
6470: <p>Append a <code>Comment</code> node to the first element in
6471: the <a href="#stack-of-open-elements">stack of open elements</a> (the <code><a href="semantics.html#the-html-element">html</a></code>
6472: element), with the <code title="">data</code> attribute set to
6473: the data given in the comment token.</p>
6474: </dd>
6475:
6476: <dt>A DOCTYPE token</dt>
6477: <dd>
6478: <p><a href="#parse-error">Parse error</a>. Ignore the token.</p>
6479: </dd>
6480:
6481: <dt>A start tag whose tag name is "html"</dt>
6482: <dd>
6483: <p>Process the token <a href="#using-the-rules-for">using the rules for</a> the "<a href="#parsing-main-inbody" title="insertion mode: in body">in body</a>" <a href="#insertion-mode">insertion
6484: mode</a>.</p>
6485: </dd>
6486:
6487: <dt>An end tag whose tag name is "html"</dt>
6488: <dd>
6489:
6490: <p>If the parser was originally created as part of the <a href="#html-fragment-parsing-algorithm">HTML
6491: fragment parsing algorithm</a>, this is a <a href="#parse-error">parse
6492: error</a>; ignore the token. (<a href="#fragment-case">fragment case</a>)</p>
6493:
6494: <p>Otherwise, switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#the-after-after-body-insertion-mode" title="insertion mode: after after body">after after
6495: body</a>".</p>
6496:
6497: </dd>
6498:
6499: <dt>An end-of-file token</dt>
6500: <dd>
6501: <p><a href="#stop-parsing">Stop parsing</a>.</p>
6502: </dd>
6503:
6504: <dt>Anything else</dt>
6505: <dd>
6506:
6507: <p><a href="#parse-error">Parse error</a>. Switch the <a href="#insertion-mode">insertion
6508: mode</a> to "<a href="#parsing-main-inbody" title="insertion mode: in body">in
6509: body</a>" and reprocess the token.</p>
6510:
6511: </dd>
6512:
6513: </dl><h5 id="parsing-main-inframeset"><span class="secno">9.2.5.23 </span>The "<dfn title="insertion mode: in frameset">in frameset</dfn>" insertion mode</h5>
6514:
6515: <p>When the <a href="#insertion-mode">insertion mode</a> is "<a href="#parsing-main-inframeset" title="insertion
6516: mode: in frameset">in frameset</a>", tokens must be handled as follows:</p>
6517:
6518: <dl class="switch"><dt>A character token that is one of U+0009 CHARACTER
6519: TABULATION, U+000A LINE FEED (LF), U+000C FORM FEED (FF),
6520: <!--U+000D CARRIAGE RETURN (CR),--> or U+0020 SPACE</dt>
6521: <dd>
6522: <p><a href="#insert-a-character" title="insert a character">Insert the character</a> into
6523: the <a href="#current-node">current node</a>.</p>
6524: </dd>
6525:
6526: <dt>A comment token</dt>
6527: <dd>
6528: <p>Append a <code>Comment</code> node to the <a href="#current-node">current
6529: node</a> with the <code title="">data</code> attribute set to
6530: the data given in the comment token.</p>
6531: </dd>
6532:
6533: <dt>A DOCTYPE token</dt>
6534: <dd>
6535: <p><a href="#parse-error">Parse error</a>. Ignore the token.</p>
6536: </dd>
6537:
6538: <dt>A start tag whose tag name is "html"</dt>
6539: <dd>
6540: <p>Process the token <a href="#using-the-rules-for">using the rules for</a> the "<a href="#parsing-main-inbody" title="insertion mode: in body">in body</a>" <a href="#insertion-mode">insertion
6541: mode</a>.</p>
6542: </dd>
6543:
6544: <dt>A start tag whose tag name is "frameset"</dt>
6545: <dd>
6546: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token.</p>
6547: </dd>
6548:
6549: <dt>An end tag whose tag name is "frameset"</dt>
6550: <dd>
6551:
6552: <p>If the <a href="#current-node">current node</a> is the root
6553: <code><a href="semantics.html#the-html-element">html</a></code> element, then this is a <a href="#parse-error">parse
6554: error</a>; ignore the token. (<a href="#fragment-case">fragment
6555: case</a>)</p>
6556:
6557: <p>Otherwise, pop the <a href="#current-node">current node</a> from the
6558: <a href="#stack-of-open-elements">stack of open elements</a>.</p>
6559:
6560: <p>If the parser was <em>not</em> originally created as part
6561: of the <a href="#html-fragment-parsing-algorithm">HTML fragment parsing algorithm</a>
6562: (<a href="#fragment-case">fragment case</a>), and the <a href="#current-node">current
1.5 mike 6563: node</a> is no longer a <code><a href="obsolete.html#frameset">frameset</a></code> element, then
1.1 mike 6564: switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#parsing-main-afterframeset" title="insertion mode: after frameset">after
6565: frameset</a>".</p>
6566:
6567: </dd>
6568:
6569: <dt>A start tag whose tag name is "frame"</dt>
6570: <dd>
6571:
6572: <p><a href="#insert-an-html-element">Insert an HTML element</a> for the token.
6573: Immediately pop the <a href="#current-node">current node</a> off the
6574: <a href="#stack-of-open-elements">stack of open elements</a>.</p>
6575:
6576: <p><a href="#acknowledge-self-closing-flag" title="acknowledge self-closing flag">Acknowledge the
6577: token's <i>self-closing flag</i></a>, if it is set.</p>
6578:
6579: </dd>
6580:
6581: <dt>A start tag whose tag name is "noframes"</dt>
6582: <dd>
6583: <p>Process the token <a href="#using-the-rules-for">using the rules for</a> the "<a href="#parsing-main-inhead" title="insertion mode: in head">in head</a>" <a href="#insertion-mode">insertion
6584: mode</a>.</p>
6585: </dd>
6586:
6587: <dt>An end-of-file token</dt>
6588: <dd>
6589:
6590: <p>If the <a href="#current-node">current node</a> is not the root
6591: <code><a href="semantics.html#the-html-element">html</a></code> element, then this is a <a href="#parse-error">parse
6592: error</a>.</p>
6593:
6594: <p class="note">It can only be the <a href="#current-node">current node</a> in
6595: the <a href="#fragment-case">fragment case</a>.</p>
6596:
6597: <p><a href="#stop-parsing">Stop parsing</a>.</p>
6598:
6599: </dd>
6600:
6601: <dt>Anything else</dt>
6602: <dd>
6603: <p><a href="#parse-error">Parse error</a>. Ignore the token.</p>
6604: </dd>
6605:
6606: </dl><h5 id="parsing-main-afterframeset"><span class="secno">9.2.5.24 </span>The "<dfn title="insertion mode: after frameset">after frameset</dfn>" insertion mode</h5>
6607:
6608: <p>When the <a href="#insertion-mode">insertion mode</a> is "<a href="#parsing-main-afterframeset" title="insertion
6609: mode: after frameset">after frameset</a>", tokens must be handled as follows:</p>
6610:
6611: <!-- due to rules in the "in frameset" mode, this can't be entered in the fragment case -->
6612: <dl class="switch"><dt>A character token that is one of U+0009 CHARACTER
6613: TABULATION, U+000A LINE FEED (LF), U+000C FORM FEED (FF),
6614: <!--U+000D CARRIAGE RETURN (CR),--> or U+0020 SPACE</dt>
6615: <dd>
6616: <p><a href="#insert-a-character" title="insert a character">Insert the character</a> into
6617: the <a href="#current-node">current node</a>.</p>
6618: </dd>
6619:
6620: <dt>A comment token</dt>
6621: <dd>
6622: <p>Append a <code>Comment</code> node to the <a href="#current-node">current
6623: node</a> with the <code title="">data</code> attribute set to
6624: the data given in the comment token.</p>
6625: </dd>
6626:
6627: <dt>A DOCTYPE token</dt>
6628: <dd>
6629: <p><a href="#parse-error">Parse error</a>. Ignore the token.</p>
6630: </dd>
6631:
6632: <dt>A start tag whose tag name is "html"</dt>
6633: <dd>
6634: <p>Process the token <a href="#using-the-rules-for">using the rules for</a> the "<a href="#parsing-main-inbody" title="insertion mode: in body">in body</a>" <a href="#insertion-mode">insertion
6635: mode</a>.</p>
6636: </dd>
6637:
6638: <dt>An end tag whose tag name is "html"</dt>
6639: <dd>
6640: <p>Switch the <a href="#insertion-mode">insertion mode</a> to "<a href="#the-after-after-frameset-insertion-mode" title="insertion mode: after after frameset">after after
6641: frameset</a>".</p>
6642: </dd>
6643:
6644: <dt>A start tag whose tag name is "noframes"</dt>
6645: <dd>
6646: <p>Process the token <a href="#using-the-rules-for">using the rules for</a> the "<a href="#parsing-main-inhead" title="insertion mode: in head">in head</a>" <a href="#insertion-mode">insertion
6647: mode</a>.</p>
6648: </dd>
6649:
6650: <dt>An end-of-file token</dt>
6651: <dd>
6652: <p><a href="#stop-parsing">Stop parsing</a>.</p>
6653: </dd>
6654:
6655: <dt>Anything else</dt>
6656: <dd>
6657: <p><a href="#parse-error">Parse error</a>. Ignore the token.</p>
6658: </dd>
6659:
6660: </dl><p class="XXX">This doesn't handle UAs that don't support
6661: frames, or that do support frames but want to show the NOFRAMES
6662: content. Supporting the former is easy; supporting the latter is
6663: harder.</p>
6664:
6665:
6666: <h5 id="the-after-after-body-insertion-mode"><span class="secno">9.2.5.25 </span>The "<dfn title="insertion mode: after after body">after after body</dfn>" insertion mode</h5>
6667:
6668: <p>When the <a href="#insertion-mode">insertion mode</a> is "<a href="#the-after-after-body-insertion-mode" title="insertion
6669: mode: after after body">after after body</a>", tokens must be handled as follows:</p>
6670:
6671: <dl class="switch"><dt>A comment token</dt>
6672: <dd>
6673: <p>Append a <code>Comment</code> node to the <code>Document</code>
6674: object with the <code title="">data</code> attribute set to the
6675: data given in the comment token.</p>
6676: </dd>
6677:
6678: <dt>A DOCTYPE token</dt>
6679: <dt>A character token that is one of U+0009 CHARACTER
6680: TABULATION, U+000A LINE FEED (LF), U+000C FORM FEED (FF),
6681: <!--U+000D CARRIAGE RETURN (CR),--> or U+0020 SPACE</dt>
6682: <dt>A start tag whose tag name is "html"</dt>
6683: <dd>
6684: <p>Process the token <a href="#using-the-rules-for">using the rules for</a> the "<a href="#parsing-main-inbody" title="insertion mode: in body">in body</a>" <a href="#insertion-mode">insertion
6685: mode</a>.</p>
6686: </dd>
6687:
6688: <dt>An end-of-file token</dt>
6689: <dd>
6690: <p><a href="#stop-parsing">Stop parsing</a>.</p>
6691: </dd>
6692:
6693: <dt>Anything else</dt>
6694: <dd>
6695: <p><a href="#parse-error">Parse error</a>. Switch the <a href="#insertion-mode">insertion mode</a>
6696: to "<a href="#parsing-main-inbody" title="insertion mode: in body">in body</a>" and
6697: reprocess the token.</p>
6698: </dd>
6699:
6700: </dl><h5 id="the-after-after-frameset-insertion-mode"><span class="secno">9.2.5.26 </span>The "<dfn title="insertion mode: after after frameset">after after frameset</dfn>" insertion mode</h5>
6701:
6702: <p>When the <a href="#insertion-mode">insertion mode</a> is "<a href="#the-after-after-frameset-insertion-mode" title="insertion
6703: mode: after after frameset">after after frameset</a>", tokens must be handled as follows:</p>
6704:
6705: <dl class="switch"><dt>A comment token</dt>
6706: <dd>
6707: <p>Append a <code>Comment</code> node to the <code>Document</code>
6708: object with the <code title="">data</code> attribute set to the
6709: data given in the comment token.</p>
6710: </dd>
6711:
6712: <dt>A DOCTYPE token</dt>
6713: <dt>A character token that is one of U+0009 CHARACTER
6714: TABULATION, U+000A LINE FEED (LF), U+000C FORM FEED (FF),
6715: <!--U+000D CARRIAGE RETURN (CR),--> or U+0020 SPACE</dt>
6716: <dt>A start tag whose tag name is "html"</dt>
6717: <dd>
6718: <p>Process the token <a href="#using-the-rules-for">using the rules for</a> the "<a href="#parsing-main-inbody" title="insertion mode: in body">in body</a>" <a href="#insertion-mode">insertion
6719: mode</a>.</p>
6720: </dd>
6721:
6722: <dt>An end-of-file token</dt>
6723: <dd>
6724: <p><a href="#stop-parsing">Stop parsing</a>.</p>
6725: </dd>
6726:
6727: <dt>A start tag whose tag name is "noframes"</dt>
6728: <dd>
6729: <p>Process the token <a href="#using-the-rules-for">using the rules for</a> the "<a href="#parsing-main-inhead" title="insertion mode: in head">in head</a>" <a href="#insertion-mode">insertion
6730: mode</a>.</p>
6731: </dd>
6732:
6733: <dt>Anything else</dt>
6734: <dd>
6735: <p><a href="#parse-error">Parse error</a>. Ignore the token.</p>
6736: </dd>
6737:
6738: </dl><h4 id="the-end"><span class="secno">9.2.6 </span>The end</h4>
6739:
6740: <p>Once the user agent <dfn id="stop-parsing" title="stop parsing">stops parsing</dfn>
6741: the document, the user agent must follow the steps in this
6742: section.</p>
6743:
6744: <p>First, the <a href="dom.html#current-document-readiness">current document readiness</a> must be set to
6745: "interactive".</p>
6746:
6747: <p>Then, the rules for <a href="semantics.html#when-a-script-completes-loading">when a script completes loading</a>
6748: start applying (script execution is no longer managed by the
6749: parser).</p>
6750:
6751: <p>If any of the scripts in the <a href="semantics.html#list-of-scripts-that-will-execute-as-soon-as-possible">list of scripts that will
6752: execute as soon as possible</a> have <a href="semantics.html#completed-loading">completed
6753: loading</a>, or if the <a href="semantics.html#list-of-scripts-that-will-execute-asynchronously">list of scripts that will execute
6754: asynchronously</a> is not empty and the first script in that list
6755: has <a href="semantics.html#completed-loading">completed loading</a>, then the user agent must act as
6756: if those scripts just completed loading, following the rules given
6757: for that in the <code><a href="semantics.html#script">script</a></code> element definition.</p>
6758:
6759: <p>Then, if the <a href="semantics.html#list-of-scripts-that-will-execute-when-the-document-has-finished-parsing">list of scripts that will execute when the
6760: document has finished parsing</a> is not empty, and the first
6761: item in this list has already <a href="semantics.html#completed-loading">completed loading</a>, then
6762: the user agent must act as if that script just finished loading.</p>
6763:
6764: <p>By this point, there will be no scripts that have loaded but have
6765: not yet been executed.</p>
6766:
6767: <p>The user agent must then <a href="browsers.html#fire-a-simple-event">fire a simple event</a> called
6768: <code title="event-DOMContentLoaded">DOMContentLoaded</code> at the
6769: <code>Document</code>.</p>
6770:
6771: <p>Once everything that <dfn id="delay-the-load-event" title="delay the load event">delays the
6772: load event</dfn> of the document has completed, the user agent must
6773: run the following steps:</p>
6774:
6775: <ol><li><a href="browsers.html#queue-a-task">Queue a task</a> to set the <a href="dom.html#current-document-readiness">current document
6776: readiness</a> to "complete".</li>
6777:
6778: <li>If the <code>Document</code> is in a <a href="browsers.html#browsing-context">browsing
6779: context</a>, then <a href="browsers.html#queue-a-task">queue a task</a> to <a href="browsers.html#fire-a-simple-event">fire a
6780: simple event</a> called <code title="event-load"><a href="video.html#event-load">load</a></code> at
6781: the <code>Document</code>'s <code><a href="browsers.html#window">Window</a></code> object, but with
6782: its <code title="dom-event-target">target</code> set to the
6783: <code>Document</code> object (and the <code title="dom-event-currentTarget">currentTarget</code> set to the
6784: <code><a href="browsers.html#window">Window</a></code> object).</li>
6785:
6786: <li>If the <code>Document</code> has a <a href="history.html#pending-state-object">pending state
6787: object</a>, then <a href="browsers.html#queue-a-task">queue a task</a> to fire a <code title="event-popstate"><a href="history.html#event-popstate">popstate</a></code> event in no namespace on the
6788: <code>Document</code>'s <code><a href="browsers.html#window">Window</a></code> object using the
6789: <code><a href="history.html#popstateevent">PopStateEvent</a></code> interface, with the <code title="dom-PopStateEvent-state"><a href="history.html#dom-popstateevent-state">state</a></code> attribute set to the
6790: current value of the <a href="history.html#pending-state-object">pending state object</a>. This event
6791: must bubble but not be cancelable and has no default action.</li>
6792:
6793: </ol><p>The <a href="browsers.html#task-source">task source</a> for these tasks is the <a href="browsers.html#dom-manipulation-task-source">DOM
6794: manipulation task source</a>.</p>
6795:
6796: <!-- XXX make sure things "delay the load event", e.g. applet and
6797: object element's frame contents -->
6798:
6799: <p class="XXX">delaying the load event for things like image
6800: loads allows for intranet port scans (even without
6801: javascript!). Should we really encode that into the spec?</p>
6802:
6803:
6804: <!--XXX need to handle
6805: http://lxr.mozilla.org/mozilla/source/parser/htmlparser/src/CNavDTD.cpp#2354
6806: 2354 // Don't open transient styles if it makes the stack deep, bug 58917.
6807: -->
6808:
6809: <!--XXX
6810: http://lxr.mozilla.org/mozilla/source/parser/htmlparser/src/nsHTMLTokenizer.cpp#749
6811: -->
6812:
6813: <!--
6814: see also CTextToken::ConsumeCharacterData() for CDATA parsing?
6815:
6816: 1212 1 Here's a tricky case from bug 22596: <h5><li><h5>
6817: 1213 How do we know that the 2nd <h5> should close the <LI> rather than nest inside the <LI>?
6818: 1214 (Afterall, the <h5> is a legal child of the <LI>).
6819: 1215
6820: 1216 The way you know is that there is no root between the two, so the <h5> binds more
6821: 1217 tightly to the 1st <h5> than to the <LI>.
6822: 1218 2. Also, bug 6148 shows this case: <SPAN><DIV><SPAN>
6823: 1219 From this case we learned not to execute this logic if the parent is a block.
6824: 1220
6825: 1221 3. Fix for 26583
6826: 1222 Ex. <A href=foo.html><B>foo<A href-bar.html>bar</A></B></A> <- A legal HTML
6827: 1223 In the above example clicking on "foo" or "bar" should link to
6828: 1224 foo.html or bar.html respectively. That is, the inner <A> should be informed
6829: 1225 about the presence of an open <A> above <B>..so that the inner <A> can close out
6830: 1226 the outer <A>. The following code does it for us.
6831: 1227
6832: 1228 4. Fix for 27865 [ similer to 22596 ]. Ex: <DL><DD><LI>one<DD><LI>two
6833: - http://lxr.mozilla.org/mozilla/source/parser/htmlparser/src/CNavDTD.cpp#1211
6834:
6835: 815 // Here's a problem. If theTag is legal in here, we don't move it
6836: 816 // out. So if we're moving stuff out of here, the parent of theTag
6837: 817 // gets closed at this point. But some things are legal
6838: 818 // _everywhere_ and hence would effectively close out misplaced
6839: 819 // content in tables. This is undesirable, so treat them as
6840: 820 // illegal here so they'll be shipped out with their parents and
6841: 821 // siblings. See bug 40855 for an explanation (that bug was for
6842: 822 // comments, but the same issues arise with whitespace, newlines,
6843: 823 // noscript, etc). Script is special, though. Shipping it out
6844: 824 // breaks document.write stuff. See bug 243064.
6845: - http://lxr.mozilla.org/mozilla/source/parser/htmlparser/src/CNavDTD.cpp#825
6846:
6847:
6848: 1326 /**************************************************************************************
6849: 1327 *
6850: 1328 * Now a little code to deal with bug #49687 (crash when layout stack gets too deep)
6851: 1329 * I've also opened this up to any container (not just inlines): re bug 55095
6852: 1330 * Improved to handle bug 55980 (infinite loop caused when DEPTH is exceeded and
6853: 1331 * </P> is encountered by itself (<P>) is continuously produced.
6854: 1332 *
6855: 1333 **************************************************************************************/
6856:
6857: 1912 // Oh boy!! we found a "stray" tag. Nav4.x and IE introduce line break in
6858: 1913 // such cases. So, let's simulate that effect for compatibility.
6859: 1914 // Ex. <html><body>Hello</P>There</body></html>
6860: http://lxr.mozilla.org/mozilla/source/parser/htmlparser/src/CNavDTD.cpp#1912
6861:
6862: http://lxr.mozilla.org/seamonkey/search?string=nested
6863: /parser/htmlparser/src/CNavDTD.cpp, line 791 - * 2. <CENTER><DL><DT><A><CENTER> allow nested <CENTER>
6864: /parser/htmlparser/src/CNavDTD.cpp, line 792 - * 3. <TABLE><TR><TD><TABLE>... allow nested <TABLE>
6865: /parser/htmlparser/src/CNavDTD.cpp, line 2562 - // Discard nested forms - bug 72639
6866: /parser/htmlparser/src/nsElementTable.cpp, line 1453 - * 2. <CENTER><DL><DT><A><CENTER> allow nested <CENTER>
6867: /parser/htmlparser/src/nsElementTable.cpp, line 1454 - * 3. <TABLE><TR><TD><TABLE>... allow nested <TABLE>
6868: /parser/htmlparser/src/nsElementTable.cpp, line 1901 - // Ex: <H1><LI><H1><LI>. Inner LI has the potential of getting nested
6869: -->
6870:
6871:
6872: <h4 id="coercing-an-html-dom-into-an-infoset"><span class="secno">9.2.7 </span>Coercing an HTML DOM into an infoset</h4>
6873:
6874: <p>When an application uses an <a href="#html-parser">HTML parser</a> in
6875: conjunction with an XML pipeline, it is possible that the
6876: constructed DOM is not compatible with the XML tool chain in certain
6877: subtle ways. For example, an XML toolchain might not be able to
6878: represent attributes with the name <code title="">xmlns</code>,
6879: since they conflict with the Namespaces in XML syntax. There is also
6880: some data that the <a href="#html-parser">HTML parser</a> generates that isn't
6881: included in the DOM itself. This section specifies some rules for
6882: handling these issues.</p>
6883:
6884: <p>If the XML API being used doesn't support DOCTYPEs, the tool may
6885: drop DOCTYPEs altogether.</p>
6886:
6887: <p>If the XML API doesn't support attributes in no namespace that
6888: are named "<code title="">xmlns</code>", attributes whose names
6889: start with "<code title="">xmlns:</code>", or attributes in the
6890: <a href="#xmlns-namespace">XMLNS namespace</a>, then the tool may drop such
6891: attributes.</p>
6892:
6893: <p>The tool may annotate the output with any namespace declarations
6894: required for proper operation.</p>
6895:
6896: <p>If the XML API being used restricts the allowable characters in
6897: the local names of elements and attributes, then the tool may map
6898: all element and attribute local names that the API wouldn't support
6899: to a set of names that <em>are</em> allowed, by replacing any
6900: character that isn't supported with the uppercase letter U and the
6901: six digits of the character's Unicode code point when expressed in
6902: hexadecimal, using digits 0-9 and capital letters A-F as the
6903: symbols, in increasing numeric order.</p>
6904:
6905: <p class="example">For example, the element name <code title="">foo<bar</code>, which can be output by the <a href="#html-parser">HTML
6906: parser</a>, though it is neither a legal HTML element name nor a
6907: well-formed XML element name, would be converted into <code title="">fooU00003Cbar</code>, which <em>is</em> a well-formed XML
6908: element name (though it's still not legal in HTML by any means).</p>
6909:
6910: <p class="example">As another example, consider the attribute
6911: <code>xlink:href</code>. Used on a MathML element, it becomes, after
6912: being <a href="#adjust-foreign-attributes" title="adjust foreign attributes">adjusted</a>, an
6913: attribute with a prefix "<code title="">xlink</code>" and a local
6914: name "<code title="">href</code>". However, used on an HTML element,
6915: it becomes an attribute with no prefix and the local name "<code title="">xlink:href</code>", which is not a valid NCName, and thus
6916: might not be accepted by an XML API. It could thus get converted,
6917: becoming "<code title="">xlinkU00003Ahref</code>".</p>
6918:
6919: <p class="note">The resulting names from this conversion
6920: conveniently can't clash with any attribute generated by the
6921: <a href="#html-parser">HTML parser</a>, since those are all either lowercase or
6922: those listed in the <a href="#adjust-foreign-attributes">adjust foreign attributes</a>
6923: algorithm's table.</p>
6924:
6925: <p>If the XML API restricts comments from having two consecutive
6926: U+002D HYPHEN-MINUS characters (--), the tool may insert a single
6927: U+0020 SPACE character between any such offending characters.</p>
6928:
6929: <p>If the XML API restricts comments from ending in a
6930: U+002D HYPHEN-MINUS character (-), the tool may insert a single
6931: U+0020 SPACE character at the end of such comments.</p>
6932:
6933: <p>If the XML API restricts allowed characters in character data,
6934: the tool may replace any U+000C FORM FEED (FF) character with a
6935: U+0020 SPACE character, and any other literal non-XML character with
6936: a U+FFFD REPLACEMENT CHARACTER.</p>
6937:
6938: <p>If the tool has no way to convey out-of-band information, then
6939: the tool may drop the following information:</p>
6940:
6941: <ul><li>Whether the document is set to <i><a href="dom.html#no-quirks-mode">no quirks mode</a></i>,
6942: <i><a href="dom.html#limited-quirks-mode">limited quirks mode</a></i>, or <i><a href="dom.html#quirks-mode">quirks mode</a></i></li>
6943:
6944: <li>The association between form controls and forms that aren't
6945: their nearest <code><a href="forms.html#the-form-element">form</a></code> element ancestor (use of the
6946: <a href="#form-element-pointer"><code>form</code> element pointer</a> in the parser)</li>
6947:
6948: </ul><p class="note">The mutations allowed by this section apply
6949: <em>after</em> the <a href="#html-parser">HTML parser</a>'s rules have been
6950: applied. For example, a <code title=""><a::></code> start tag
6951: will be closed by a <code title=""></a::></code> end tag, and
6952: never by a <code title=""></aU00003AU00003A></code> end tag, even
6953: if the user agent is using the rules above to then generate an
6954: actual element in the DOM with the name <code title="">aU00003AU00003A</code> for that start tag.</p>
6955:
6956:
6957:
6958: <h4 id="an-introduction-to-error-handling-in-the-parser"><span class="secno">9.2.8 </span>An introduction to error handling in the parser</h4>
6959:
6960: <p><i>This section is non-normative.</i></p>
6961:
6962: <p>This section examines some erroneous markup and discusses how
6963: the <a href="#html-parser">HTML parser</a> handles these cases.</p>
6964:
6965:
6966: <h5 id="misnested-tags:-b-i-b-i"><span class="secno">9.2.8.1 </span>Misnested tags: <b><i></b></i></h5>
6967:
6968: <p><i>This section is non-normative.</i></p>
6969:
6970: <p>The most-often discussed example of erroneous markup is as
6971: follows:</p>
6972:
6973: <pre><p>1<b>2<i>3</b>4</i>5</p></pre>
6974:
6975: <p>The parsing of this markup is straightforward up to the "3". At
6976: this point, the DOM looks like this:</p>
6977:
6978: <ul class="domTree"><li class="t1"><code><a href="semantics.html#the-html-element">html</a></code><ul><li class="t1"><code><a href="semantics.html#the-head-element">head</a></code></li><li class="t1"><code><a href="semantics.html#the-body-element">body</a></code><ul><li class="t1"><code><a href="semantics.html#the-p-element">p</a></code><ul><li class="t3"><code>#text</code>: <span title="">1</span></li><li class="t1"><code><a href="text-level-semantics.html#the-b-element">b</a></code><ul><li class="t3"><code>#text</code>: <span title="">2</span></li><li class="t1"><code><a href="text-level-semantics.html#the-i-element">i</a></code><ul><li class="t3"><code>#text</code>: <span title="">3</span></li></ul></li></ul></li></ul></li></ul></li></ul></li></ul><p>Here, the <a href="#stack-of-open-elements">stack of open elements</a> has five elements
6979: on it: <code><a href="semantics.html#the-html-element">html</a></code>, <code><a href="semantics.html#the-body-element">body</a></code>, <code><a href="semantics.html#the-p-element">p</a></code>,
6980: <code><a href="text-level-semantics.html#the-b-element">b</a></code>, and <code><a href="text-level-semantics.html#the-i-element">i</a></code>. The <a href="#list-of-active-formatting-elements">list of active
6981: formatting elements</a> just has two: <code><a href="text-level-semantics.html#the-b-element">b</a></code> and
6982: <code><a href="text-level-semantics.html#the-i-element">i</a></code>. The <a href="#insertion-mode">insertion mode</a> is "<a href="#parsing-main-inbody" title="insertion mode: in body">in body</a>".</p>
6983:
6984: <p>Upon receiving the end tag token with the tag name "b", the "<a href="#adoptionAgency">adoption agency algorithm</a>" is
6985: invoked. This is a simple case, in that the <var title="">formatting
6986: element</var> is the <code><a href="text-level-semantics.html#the-b-element">b</a></code> element, and there is no
6987: <var title="">furthest block</var>. Thus, the <a href="#stack-of-open-elements">stack of open
6988: elements</a> ends up with just three elements: <code><a href="semantics.html#the-html-element">html</a></code>,
6989: <code><a href="semantics.html#the-body-element">body</a></code>, and <code><a href="semantics.html#the-p-element">p</a></code>, while the <a href="#list-of-active-formatting-elements">list of
6990: active formatting elements</a> has just one: <code><a href="text-level-semantics.html#the-i-element">i</a></code>. The
6991: DOM tree is unmodified at this point.</p>
6992:
6993: <p>The next token is a character ("4"), triggers the <a href="#reconstruct-the-active-formatting-elements" title="reconstruct the active formatting elements">reconstruction of
6994: the active formatting elements</a>, in this case just the
6995: <code><a href="text-level-semantics.html#the-i-element">i</a></code> element. A new <code><a href="text-level-semantics.html#the-i-element">i</a></code> element is thus created
6996: for the "4" text node. After the end tag token for the "i" is also
6997: received, and the "5" text node is inserted, the DOM looks as
6998: follows:</p>
6999:
7000: <ul class="domTree"><li class="t1"><code><a href="semantics.html#the-html-element">html</a></code><ul><li class="t1"><code><a href="semantics.html#the-head-element">head</a></code></li><li class="t1"><code><a href="semantics.html#the-body-element">body</a></code><ul><li class="t1"><code><a href="semantics.html#the-p-element">p</a></code><ul><li class="t3"><code>#text</code>: <span title="">1</span></li><li class="t1"><code><a href="text-level-semantics.html#the-b-element">b</a></code><ul><li class="t3"><code>#text</code>: <span title="">2</span></li><li class="t1"><code><a href="text-level-semantics.html#the-i-element">i</a></code><ul><li class="t3"><code>#text</code>: <span title="">3</span></li></ul></li></ul></li><li class="t1"><code><a href="text-level-semantics.html#the-i-element">i</a></code><ul><li class="t3"><code>#text</code>: <span title="">4</span></li></ul></li><li class="t3"><code>#text</code>: <span title="">5</span></li></ul></li></ul></li></ul></li></ul><h5 id="misnested-tags:-b-p-b-p"><span class="secno">9.2.8.2 </span>Misnested tags: <b><p></b></p></h5>
7001:
7002: <p><i>This section is non-normative.</i></p>
7003:
7004: <p>A case similar to the previous one is the following:</p>
7005:
7006: <pre><b>1<p>2</b>3</p></pre>
7007:
7008: <p>Up to the "2" the parsing here is straightforward:</p>
7009:
7010: <ul class="domTree"><li class="t1"><code><a href="semantics.html#the-html-element">html</a></code><ul><li class="t1"><code><a href="semantics.html#the-head-element">head</a></code></li><li class="t1"><code><a href="semantics.html#the-body-element">body</a></code><ul><li class="t1"><code><a href="text-level-semantics.html#the-b-element">b</a></code><ul><li class="t3"><code>#text</code>: <span title="">1</span></li><li class="t1"><code><a href="semantics.html#the-p-element">p</a></code><ul><li class="t3"><code>#text</code>: <span title="">2</span></li></ul></li></ul></li></ul></li></ul></li></ul><p>The interesting part is when the end tag token with the tag name
7011: "b" is parsed.</p>
7012:
7013: <p>Before that token is seen, the <a href="#stack-of-open-elements">stack of open
7014: elements</a> has four elements on it: <code><a href="semantics.html#the-html-element">html</a></code>,
7015: <code><a href="semantics.html#the-body-element">body</a></code>, <code><a href="text-level-semantics.html#the-b-element">b</a></code>, and <code><a href="semantics.html#the-p-element">p</a></code>. The
7016: <a href="#list-of-active-formatting-elements">list of active formatting elements</a> just has the one:
7017: <code><a href="text-level-semantics.html#the-b-element">b</a></code>. The <a href="#insertion-mode">insertion mode</a> is "<a href="#parsing-main-inbody" title="insertion mode: in body">in body</a>".</p>
7018:
7019: <p>Upon receiving the end tag token with the tag name "b", the "<a href="#adoptionAgency">adoption agency algorithm</a>" is invoked, as
7020: in the previous example. However, in this case, there <em>is</em> a
7021: <var title="">furthest block</var>, namely the <code><a href="semantics.html#the-p-element">p</a></code> element. Thus,
7022: this time the adoption agency algorithm isn't skipped over.</p>
7023:
7024: <p>The <var title="">common ancestor</var> is the <code><a href="semantics.html#the-body-element">body</a></code>
7025: element. A conceptual "bookmark" marks the position of the
7026: <code><a href="text-level-semantics.html#the-b-element">b</a></code> in the <a href="#list-of-active-formatting-elements">list of active formatting
7027: elements</a>, but since that list has only one element in it,
7028: it won't have much effect.</p>
7029:
7030: <p>As the algorithm progresses, <var title="">node</var> ends up set
7031: to the formatting element (<code><a href="text-level-semantics.html#the-b-element">b</a></code>), and <var title="">last
7032: node</var> ends up set to the <var title="">furthest block</var>
7033: (<code><a href="semantics.html#the-p-element">p</a></code>).</p>
7034:
7035: <p>The <var title="">last node</var> gets appended (moved) to the
7036: <var title="">common ancestor</var>, so that the DOM looks like:</p>
7037:
7038: <ul class="domTree"><li class="t1"><code><a href="semantics.html#the-html-element">html</a></code><ul><li class="t1"><code><a href="semantics.html#the-head-element">head</a></code></li><li class="t1"><code><a href="semantics.html#the-body-element">body</a></code><ul><li class="t1"><code><a href="text-level-semantics.html#the-b-element">b</a></code><ul><li class="t3"><code>#text</code>: <span title="">1</span></li></ul></li><li class="t1"><code><a href="semantics.html#the-p-element">p</a></code><ul><li class="t3"><code>#text</code>: <span title="">2</span></li></ul></li></ul></li></ul></li></ul><p>A new <code><a href="text-level-semantics.html#the-b-element">b</a></code> element is created, and the children of the
7039: <code><a href="semantics.html#the-p-element">p</a></code> element are moved to it:</p>
7040:
7041: <ul class="domTree"><li class="t1"><code><a href="semantics.html#the-html-element">html</a></code><ul><li class="t1"><code><a href="semantics.html#the-head-element">head</a></code></li><li class="t1"><code><a href="semantics.html#the-body-element">body</a></code><ul><li class="t1"><code><a href="text-level-semantics.html#the-b-element">b</a></code><ul><li class="t3"><code>#text</code>: <span title="">1</span></li></ul></li><li class="t1"><code><a href="semantics.html#the-p-element">p</a></code></li></ul></li></ul></li></ul><ul class="domTree"><li class="t1"><code><a href="text-level-semantics.html#the-b-element">b</a></code><ul><li class="t3"><code>#text</code>: <span title="">2</span></li></ul></li></ul><p>Finally, the new <code><a href="text-level-semantics.html#the-b-element">b</a></code> element is appended to the
7042: <code><a href="semantics.html#the-p-element">p</a></code> element, so that the DOM looks like:</p>
7043:
7044: <ul class="domTree"><li class="t1"><code><a href="semantics.html#the-html-element">html</a></code><ul><li class="t1"><code><a href="semantics.html#the-head-element">head</a></code></li><li class="t1"><code><a href="semantics.html#the-body-element">body</a></code><ul><li class="t1"><code><a href="text-level-semantics.html#the-b-element">b</a></code><ul><li class="t3"><code>#text</code>: <span title="">1</span></li></ul></li><li class="t1"><code><a href="semantics.html#the-p-element">p</a></code><ul><li class="t1"><code><a href="text-level-semantics.html#the-b-element">b</a></code><ul><li class="t3"><code>#text</code>: <span title="">2</span></li></ul></li></ul></li></ul></li></ul></li></ul><p>The <code><a href="text-level-semantics.html#the-b-element">b</a></code> element is removed from the <a href="#list-of-active-formatting-elements">list of
7045: active formatting elements</a> and the <a href="#stack-of-open-elements">stack of open
7046: elements</a>, so that when the "3" is parsed, it is appended to
7047: the <code><a href="semantics.html#the-p-element">p</a></code> element:</p>
7048:
7049: <ul class="domTree"><li class="t1"><code><a href="semantics.html#the-html-element">html</a></code><ul><li class="t1"><code><a href="semantics.html#the-head-element">head</a></code></li><li class="t1"><code><a href="semantics.html#the-body-element">body</a></code><ul><li class="t1"><code><a href="text-level-semantics.html#the-b-element">b</a></code><ul><li class="t3"><code>#text</code>: <span title="">1</span></li></ul></li><li class="t1"><code><a href="semantics.html#the-p-element">p</a></code><ul><li class="t1"><code><a href="text-level-semantics.html#the-b-element">b</a></code><ul><li class="t3"><code>#text</code>: <span title="">2</span></li></ul></li><li class="t3"><code>#text</code>: <span title="">3</span></li></ul></li></ul></li></ul></li></ul><h5 id="unexpected-markup-in-tables"><span class="secno">9.2.8.3 </span>Unexpected markup in tables</h5>
7050:
7051: <p><i>This section is non-normative.</i></p>
7052:
7053: <p>Error handling in tables is, for historical reasons, especially
7054: strange. For example, consider the following markup:</p>
7055:
7056: <pre><table><strong><b></strong><tr><td>aaa</td></tr><strong>bbb</strong></table>ccc</pre>
7057:
7058: <p>The highlighted <code><a href="text-level-semantics.html#the-b-element">b</a></code> element start tag is not allowed
7059: directly inside a table like that, and the parser handles this case
7060: by placing the element <em>before</em> the table. (This is called <i title="foster parent"><a href="#foster-parent">foster parenting</a></i>.) This can be seen by
7061: examining the DOM tree as it stands just after the
7062: <code><a href="tabular-data.html#the-table-element">table</a></code> element's start tag has been seen:</p>
7063:
7064: <ul class="domTree"><li class="t1"><code><a href="semantics.html#the-html-element">html</a></code><ul><li class="t1"><code><a href="semantics.html#the-head-element">head</a></code></li><li class="t1"><code><a href="semantics.html#the-body-element">body</a></code><ul><li class="t1"><code><a href="tabular-data.html#the-table-element">table</a></code></li></ul></li></ul></li></ul><p>...and then immediately after the <code><a href="text-level-semantics.html#the-b-element">b</a></code> element start
7065: tag has been seen:</p>
7066:
7067: <ul class="domTree"><li class="t1"><code><a href="semantics.html#the-html-element">html</a></code><ul><li class="t1"><code><a href="semantics.html#the-head-element">head</a></code></li><li class="t1"><code><a href="semantics.html#the-body-element">body</a></code><ul><li class="t1"><code><a href="text-level-semantics.html#the-b-element">b</a></code></li><li class="t1"><code><a href="tabular-data.html#the-table-element">table</a></code></li></ul></li></ul></li></ul><p>At this point, the <a href="#stack-of-open-elements">stack of open elements</a> has on it
7068: the elements <code><a href="semantics.html#the-html-element">html</a></code>, <code><a href="semantics.html#the-body-element">body</a></code>,
7069: <code><a href="tabular-data.html#the-table-element">table</a></code>, and <code><a href="text-level-semantics.html#the-b-element">b</a></code> (in that order, despite the
7070: resulting DOM tree); the <a href="#list-of-active-formatting-elements">list of active formatting
7071: elements</a> just has the <code><a href="text-level-semantics.html#the-b-element">b</a></code> element in it; and the
7072: <a href="#insertion-mode">insertion mode</a> is "<a href="#parsing-main-intable" title="insertion mode: in
7073: table">in table</a>".</p>
7074:
7075: <p>The <code><a href="tabular-data.html#the-tr-element">tr</a></code> start tag causes the <code><a href="text-level-semantics.html#the-b-element">b</a></code> element
7076: to be popped off the stack and a <code><a href="tabular-data.html#the-tbody-element">tbody</a></code> start tag to be
7077: implied; the <code><a href="tabular-data.html#the-tbody-element">tbody</a></code> and <code><a href="tabular-data.html#the-tr-element">tr</a></code> elements are
7078: then handled in a rather straight-forward manner, taking the parser
7079: through the "<a href="#parsing-main-intbody" title="insertion mode: in table body">in table
7080: body</a>" and "<a href="#parsing-main-intr" title="insertion mode: in row">in
7081: row</a>" insertion modes, after which the DOM looks as
7082: follows:</p>
7083:
7084: <ul class="domTree"><li class="t1"><code><a href="semantics.html#the-html-element">html</a></code><ul><li class="t1"><code><a href="semantics.html#the-head-element">head</a></code></li><li class="t1"><code><a href="semantics.html#the-body-element">body</a></code><ul><li class="t1"><code><a href="text-level-semantics.html#the-b-element">b</a></code></li><li class="t1"><code><a href="tabular-data.html#the-table-element">table</a></code><ul><li class="t1"><code><a href="tabular-data.html#the-tbody-element">tbody</a></code><ul><li class="t1"><code><a href="tabular-data.html#the-tr-element">tr</a></code></li></ul></li></ul></li></ul></li></ul></li></ul><p>Here, the <a href="#stack-of-open-elements">stack of open elements</a> has on it the
7085: elements <code><a href="semantics.html#the-html-element">html</a></code>, <code><a href="semantics.html#the-body-element">body</a></code>, <code><a href="tabular-data.html#the-table-element">table</a></code>,
7086: <code><a href="tabular-data.html#the-tbody-element">tbody</a></code>, and <code><a href="tabular-data.html#the-tr-element">tr</a></code>; the <a href="#list-of-active-formatting-elements">list of active
7087: formatting elements</a> still has the <code><a href="text-level-semantics.html#the-b-element">b</a></code> element in
7088: it; and the <a href="#insertion-mode">insertion mode</a> is "<a href="#parsing-main-intr" title="insertion
7089: mode: in row">in row</a>".</p>
7090:
7091: <p>The <code><a href="tabular-data.html#the-td-element">td</a></code> element start tag token, after putting a
7092: <code><a href="tabular-data.html#the-td-element">td</a></code> element on the tree, puts a marker on the <a href="#list-of-active-formatting-elements">list
7093: of active formatting elements</a> (it also switches to the "<a href="#parsing-main-intd" title="insertion mode: in cell">in cell</a>" <a href="#insertion-mode">insertion
7094: mode</a>).</p>
7095:
7096: <ul class="domTree"><li class="t1"><code><a href="semantics.html#the-html-element">html</a></code><ul><li class="t1"><code><a href="semantics.html#the-head-element">head</a></code></li><li class="t1"><code><a href="semantics.html#the-body-element">body</a></code><ul><li class="t1"><code><a href="text-level-semantics.html#the-b-element">b</a></code></li><li class="t1"><code><a href="tabular-data.html#the-table-element">table</a></code><ul><li class="t1"><code><a href="tabular-data.html#the-tbody-element">tbody</a></code><ul><li class="t1"><code><a href="tabular-data.html#the-tr-element">tr</a></code><ul><li class="t1"><code><a href="tabular-data.html#the-td-element">td</a></code></li></ul></li></ul></li></ul></li></ul></li></ul></li></ul><p>The marker means that when the "aaa" character tokens are seen,
7097: no <code><a href="text-level-semantics.html#the-b-element">b</a></code> element is created to hold the resulting text
7098: node:</p>
7099:
7100: <ul class="domTree"><li class="t1"><code><a href="semantics.html#the-html-element">html</a></code><ul><li class="t1"><code><a href="semantics.html#the-head-element">head</a></code></li><li class="t1"><code><a href="semantics.html#the-body-element">body</a></code><ul><li class="t1"><code><a href="text-level-semantics.html#the-b-element">b</a></code></li><li class="t1"><code><a href="tabular-data.html#the-table-element">table</a></code><ul><li class="t1"><code><a href="tabular-data.html#the-tbody-element">tbody</a></code><ul><li class="t1"><code><a href="tabular-data.html#the-tr-element">tr</a></code><ul><li class="t1"><code><a href="tabular-data.html#the-td-element">td</a></code><ul><li class="t3"><code>#text</code>: <span title="">aaa</span></li></ul></li></ul></li></ul></li></ul></li></ul></li></ul></li></ul><p>The end tags are handled in a straight-forward manner; after
7101: handling them, the <a href="#stack-of-open-elements">stack of open elements</a> has on it the
7102: elements <code><a href="semantics.html#the-html-element">html</a></code>, <code><a href="semantics.html#the-body-element">body</a></code>, <code><a href="tabular-data.html#the-table-element">table</a></code>,
7103: and <code><a href="tabular-data.html#the-tbody-element">tbody</a></code>; the <a href="#list-of-active-formatting-elements">list of active formatting
7104: elements</a> still has the <code><a href="text-level-semantics.html#the-b-element">b</a></code> element in it (the
7105: marker having been removed by the "td" end tag token); and the
7106: <a href="#insertion-mode">insertion mode</a> is "<a href="#parsing-main-intbody" title="insertion mode: in
7107: table body">in table body</a>".</p>
7108:
7109: <p>Thus it is that the "bbb" character tokens are found. These
7110: trigger the "<a href="#parsing-main-intabletext" title="insertion mode: in table text">in table
7111: text</a>" insertion mode to be used (with the <a href="#original-insertion-mode">original
7112: insertion mode</a> set to "<a href="#parsing-main-intbody" title="insertion mode: in table
7113: body">in table body</a>"). The character tokens are collected,
7114: and when the next token (the <code><a href="tabular-data.html#the-table-element">table</a></code> element end tag) is
7115: seen, they are processed as a group. Since they are not all spaces,
7116: they are handled as per the "anything else" rules in the "<a href="#parsing-main-intable" title="insertion mode: in table">in table</a>" insertion mode,
7117: which defer to the "<a href="#parsing-main-inbody" title="insertion mode: in body">in
7118: body</a>" insertion mode but with <a href="#foster-parent" title="foster
7119: parent">foster parenting</a>.</p>
7120:
7121: <p>When <a href="#reconstruct-the-active-formatting-elements" title="reconstruct the active formatting elements">the
7122: active formatting elements are reconstructed</a>, a
7123: <code><a href="text-level-semantics.html#the-b-element">b</a></code> element is created and <a href="#foster-parent" title="foster
7124: parent">foster parented</a>, and then the "bbb" text node is
7125: appended to it:</p>
7126:
7127: <ul class="domTree"><li class="t1"><code><a href="semantics.html#the-html-element">html</a></code><ul><li class="t1"><code><a href="semantics.html#the-head-element">head</a></code></li><li class="t1"><code><a href="semantics.html#the-body-element">body</a></code><ul><li class="t1"><code><a href="text-level-semantics.html#the-b-element">b</a></code></li><li class="t1"><code><a href="text-level-semantics.html#the-b-element">b</a></code><ul><li class="t3"><code>#text</code>: <span title="">bbb</span></li></ul></li><li class="t1"><code><a href="tabular-data.html#the-table-element">table</a></code><ul><li class="t1"><code><a href="tabular-data.html#the-tbody-element">tbody</a></code><ul><li class="t1"><code><a href="tabular-data.html#the-tr-element">tr</a></code><ul><li class="t1"><code><a href="tabular-data.html#the-td-element">td</a></code><ul><li class="t3"><code>#text</code>: <span title="">aaa</span></li></ul></li></ul></li></ul></li></ul></li></ul></li></ul></li></ul><p>The <a href="#stack-of-open-elements">stack of open elements</a> has on it the elements
7128: <code><a href="semantics.html#the-html-element">html</a></code>, <code><a href="semantics.html#the-body-element">body</a></code>, <code><a href="tabular-data.html#the-table-element">table</a></code>,
7129: <code><a href="tabular-data.html#the-tbody-element">tbody</a></code>, and the new <code><a href="text-level-semantics.html#the-b-element">b</a></code> (again, note that
7130: this doesn't match the resulting tree!); the <a href="#list-of-active-formatting-elements">list of active
7131: formatting elements</a> has the new <code><a href="text-level-semantics.html#the-b-element">b</a></code> element in it;
7132: and the <a href="#insertion-mode">insertion mode</a> is still "<a href="#parsing-main-intbody" title="insertion
7133: mode: in table body">in table body</a>".</p>
7134:
7135: <p>Had the character tokens been only <a href="infrastructure.html#space-character" title="space
7136: character">space characters</a> instead of "bbb", then those
7137: <a href="infrastructure.html#space-character" title="space character">space characters</a> would just be
7138: appended to the <code><a href="tabular-data.html#the-tbody-element">tbody</a></code> element.</p>
7139:
7140: <p>Finally, the <code><a href="tabular-data.html#the-table-element">table</a></code> is closed by a "table" end
7141: tag. This pops all the nodes from the <a href="#stack-of-open-elements">stack of open
7142: elements</a> up to and including the <code><a href="tabular-data.html#the-table-element">table</a></code> element,
7143: but it doesn't affect the <a href="#list-of-active-formatting-elements">list of active formatting
7144: elements</a>, so the "ccc" character tokens after the table
7145: result in yet another <code><a href="text-level-semantics.html#the-b-element">b</a></code> element being created, this
7146: time after the table:</p>
7147:
7148: <ul class="domTree"><li class="t1"><code><a href="semantics.html#the-html-element">html</a></code><ul><li class="t1"><code><a href="semantics.html#the-head-element">head</a></code></li><li class="t1"><code><a href="semantics.html#the-body-element">body</a></code><ul><li class="t1"><code><a href="text-level-semantics.html#the-b-element">b</a></code></li><li class="t1"><code><a href="text-level-semantics.html#the-b-element">b</a></code><ul><li class="t3"><code>#text</code>: <span title="">bbb</span></li></ul></li><li class="t1"><code><a href="tabular-data.html#the-table-element">table</a></code><ul><li class="t1"><code><a href="tabular-data.html#the-tbody-element">tbody</a></code><ul><li class="t1"><code><a href="tabular-data.html#the-tr-element">tr</a></code><ul><li class="t1"><code><a href="tabular-data.html#the-td-element">td</a></code><ul><li class="t3"><code>#text</code>: <span title="">aaa</span></li></ul></li></ul></li></ul></li></ul></li><li class="t1"><code><a href="text-level-semantics.html#the-b-element">b</a></code><ul><li class="t3"><code>#text</code>: <span title="">ccc</span></li></ul></li></ul></li></ul></li></ul><h5 id="scripts-that-modify-the-page-as-it-is-being-parsed"><span class="secno">9.2.8.4 </span>Scripts that modify the page as it is being parsed</h5>
7149:
7150: <p><i>This section is non-normative.</i></p>
7151:
7152: <p>Consider the following markup, which for this example we will
7153: assume is the document with <a href="infrastructure.html#url">URL</a> <code title="">http://example.com/inner</code>, being rendered as the
7154: content of an <code><a href="embedded-content-0.html#the-iframe-element">iframe</a></code> in another document with the
7155: <a href="infrastructure.html#url">URL</a> <code title="">http://example.com/outer</code>:</p>
7156:
7157: <pre><div id=a>
7158: <script>
7159: var div = document.getElementById('a');
7160: parent.document.body.appendChild(div);
7161: </script>
7162: <script>
7163: alert(document.URL);
7164: </script>
7165: </div>
7166: <script>
7167: alert(document.URL);
7168: </script></pre>
7169:
7170: <p>Up to the first "script" end tag, before the script is parsed,
7171: the result is relatively straightforward:</p>
7172:
7173: <ul class="domTree"><li class="t1"><code><a href="semantics.html#the-html-element">html</a></code><ul><li class="t1"><code><a href="semantics.html#the-head-element">head</a></code></li><li class="t1"><code><a href="semantics.html#the-body-element">body</a></code><ul><li class="t1"><code><a href="interactive-elements.html#the-div-element">div</a></code> <span class="t2" title=""><code class="attribute name">id</code>="<code class="attribute value"><a href="text-level-semantics.html#the-a-element">a</a></code>"</span><ul><li class="t3"><code>#text</code>: <span title="">
7174: </span></li><li class="t1"><code><a href="semantics.html#script">script</a></code><ul><li class="t3"><code>#text</code>: <span title="">var div = document.getElementById('a'); ⏎ parent.document.body.appendChild(div);</span></li></ul></li></ul></li></ul></li></ul></li></ul><p>After the script is parsed, though, the <code><a href="interactive-elements.html#the-div-element">div</a></code> element
7175: and its child <code><a href="semantics.html#script">script</a></code> element are gone:</p>
7176:
7177: <ul class="domTree"><li class="t1"><code><a href="semantics.html#the-html-element">html</a></code><ul><li class="t1"><code><a href="semantics.html#the-head-element">head</a></code></li><li class="t1"><code><a href="semantics.html#the-body-element">body</a></code></li></ul></li></ul><p>They are, at this point, in the <code>Document</code> of the
7178: aforementioned outer <a href="browsers.html#browsing-context">browsing context</a>. However, the
7179: <a href="#stack-of-open-elements">stack of open elements</a> <em>still contains the
7180: <code><a href="interactive-elements.html#the-div-element">div</a></code> element</em>.</p>
7181:
7182: <p>Thus, when the second <code><a href="semantics.html#script">script</a></code> element is parsed, it
7183: is inserted <em>into the outer <code>Document</code>
7184: object</em>.</p>
7185:
7186: <p>This also means that the <a href="browsers.html#script-s-global-object">script's global object</a> is
7187: the outer <a href="browsers.html#browsing-context">browsing context</a>'s <code><a href="browsers.html#window">Window</a></code>
7188: object, <em>not</em> the <code><a href="browsers.html#window">Window</a></code> object inside the
7189: <code><a href="embedded-content-0.html#the-iframe-element">iframe</a></code>.</p>
7190:
7191: <p class="note">This isn't a security problem since the script that
7192: moves the <code><a href="interactive-elements.html#the-div-element">div</a></code> into the outer <code>Document</code> can
7193: only do so because they have the two <code>Document</code> object
7194: have the same <a href="browsers.html#origin-0">origin</a>.</p>
7195:
7196: <p>Thus, the first alert says "http://example.com/outer".</p>
7197:
7198: <p>Once the <code><a href="interactive-elements.html#the-div-element">div</a></code> element's end tag is parsed, the
7199: <code><a href="interactive-elements.html#the-div-element">div</a></code> element is popped off the stack, and so the next
7200: <code><a href="semantics.html#script">script</a></code> element is in the inner <code>Document</code>:</p>
7201:
7202: <ul class="domTree"><li class="t1"><code><a href="semantics.html#the-html-element">html</a></code><ul><li class="t1"><code><a href="semantics.html#the-head-element">head</a></code></li><li class="t1"><code><a href="semantics.html#the-body-element">body</a></code><ul><li class="t1"><code><a href="semantics.html#script">script</a></code><ul><li class="t3"><code>#text</code>: <span title="">alert(document.URL);</span></li></ul></li></ul></li></ul></li></ul><p>This second alert will say "http://example.com/inner".</p>
7203:
7204:
7205:
7206: <h3 id="namespaces"><span class="secno">9.3 </span>Namespaces</h3>
7207:
7208: <p>The <dfn id="html-namespace-0">HTML namespace</dfn> is: <code>http://www.w3.org/1999/xhtml</code></p>
7209:
7210: <p>The <dfn id="mathml-namespace">MathML namespace</dfn> is: <code>http://www.w3.org/1998/Math/MathML</code></p>
7211:
7212: <p>The <dfn id="svg-namespace">SVG namespace</dfn> is: <code>http://www.w3.org/2000/svg</code></p>
7213:
7214: <p>The <dfn id="xlink-namespace">XLink namespace</dfn> is: <code>http://www.w3.org/1999/xlink</code></p>
7215:
7216: <p>The <dfn id="xml-namespace">XML namespace</dfn> is: <code>http://www.w3.org/XML/1998/namespace</code></p>
7217:
7218: <p>The <dfn id="xmlns-namespace">XMLNS namespace</dfn> is: <code>http://www.w3.org/2000/xmlns/</code></p>
7219:
7220: <hr><p>Data mining tools and other user agents that perform operations
7221: on <code title="">text/html</code> content without running scripts,
7222: evaluating CSS or XPath expressions, or otherwise exposing the
7223: resulting DOM to arbitrary content, may "support namespaces" by just
7224: asserting that their DOM node analogues are in certain namespaces,
7225: without actually exposing the above strings.</p>
7226:
7227:
7228:
7229:
7230: <h3 id="serializing-html-fragments"><span class="secno">9.4 </span>Serializing HTML fragments</h3>
7231:
7232: <p>The following steps form the <dfn id="html-fragment-serialization-algorithm">HTML fragment serialization
7233: algorithm</dfn>. The algorithm takes as input a DOM
7234: <code>Element</code> or <code>Document</code>, referred to as <var title="">the node</var>, and either returns a string or raises an
7235: exception.</p>
7236:
7237: <p class="note">This algorithm serializes the <em>children</em> of
7238: the node being serialized, not the node itself.</p>
7239:
7240: <ol><li><p>Let <var title="">s</var> be a string, and initialize it to
7241: the empty string.</p></li>
7242:
7243: <li>
7244:
7245: <p>For each child node of <var title="">the node</var>, in
7246: <a href="infrastructure.html#tree-order">tree order</a>, run the following steps:
7247:
7248: </p><ol><li><p>Let <var title="">current node</var> be the child node
7249: being processed.</p></li>
7250:
7251: <li>
7252:
7253: <p>Append the appropriate string from the following list to
7254: <var title="">s</var>:</p>
7255:
7256: <dl class="switch"><dt>If <var title="">current node</var> is an <code title="">Element</code></dt>
7257:
7258: <dd>
7259:
7260: <p>Append a U+003C LESS-THAN SIGN (<code title=""><</code>)
7261: character, followed by the element's tag name. (For nodes
7262: created by the <a href="#html-parser">HTML parser</a> or <code title="">Document.createElement()</code>, the tag name will be
7263: lowercase.)</p>
7264:
7265: <p>For each attribute that the element has, append a U+0020
7266: SPACE character, the attribute's name (which, for attributes
7267: set by the <a href="#html-parser">HTML parser</a> or by <code title="">Element.setAttributeNode()</code> or <code title="">Element.setAttribute()</code>, will be lowercase), a
7268: U+003D EQUALS SIGN (<code title="">=</code>) character, a
7269: U+0022 QUOTATION MARK (<code title="">"</code>)
7270: character, the attribute's value, <a href="#escapingString" title="escaping a
7271: string">escaped as described below</a> in <i>attribute
7272: mode</i>, and a second U+0022 QUOTATION MARK (<code title="">"</code>) character.</p>
7273:
7274: <p>While the exact order of attributes is UA-defined, and may
7275: depend on factors such as the order that the attributes were
7276: given in the original markup, the sort order must be stable,
7277: such that consecutive invocations of this algorithm serialize an
7278: element's attributes in the same order.</p>
7279:
7280: <p>Append a U+003E GREATER-THAN SIGN (<code title="">></code>)
7281: character.</p>
7282:
7283: <p>If <var title="">current node</var> is an
1.5 mike 7284: <code><a href="the-canvas-element.html#the-area-element">area</a></code>, <code><a href="semantics.html#the-base-element">base</a></code>, <code><a href="obsolete.html#basefont">basefont</a></code>,
1.1 mike 7285: <code>bgsound</code>, <code><a href="semantics.html#the-br-element">br</a></code>, <code><a href="tabular-data.html#the-col-element">col</a></code>,
1.5 mike 7286: <code><a href="embedded-content-0.html#the-embed-element">embed</a></code>, <code><a href="obsolete.html#frame">frame</a></code>, <code><a href="semantics.html#the-hr-element">hr</a></code>,
1.1 mike 7287: <code><a href="embedded-content-0.html#the-img-element">img</a></code>, <code><a href="forms.html#the-input-element">input</a></code>, <code><a href="forms.html#the-keygen-element">keygen</a></code>,
7288: <code><a href="semantics.html#the-link-element">link</a></code>, <code><a href="semantics.html#meta">meta</a></code>, <code><a href="embedded-content-0.html#the-param-element">param</a></code>,
1.5 mike 7289: <code><a href="obsolete.html#spacer">spacer</a></code>, or <code>wbr</code> element, then
1.1 mike 7290: continue on to the next child node at this point.</p> <!--
7291: also, i guess: image and isindex, but we don't list those
7292: because we don't consider those "elements", more "macros", and
7293: thus we should never serialize them -->
7294:
7295: <p>If <var title="">current node</var> is a <code><a href="semantics.html#the-pre-element">pre</a></code>,
7296: <code><a href="forms.html#the-textarea-element">textarea</a></code>, or <code>listing</code> element, append
7297: a U+000A LINE FEED (LF) character.</p>
7298:
7299: <p>Append the value of running the <a href="#html-fragment-serialization-algorithm">HTML fragment
7300: serialization algorithm</a> on the <var title="">current
7301: node</var> element (thus recursing into this algorithm for
7302: that element), followed by a U+003C LESS-THAN SIGN (<code title=""><</code>) character, a U+002F SOLIDUS (<code title="">/</code>) character, the element's tag name again,
7303: and finally a U+003E GREATER-THAN SIGN (<code title="">></code>) character.</p>
7304:
7305: </dd>
7306:
7307:
7308: <dt>If <var title="">current node</var> is a <code title="">Text</code> or <code title="">CDATASection</code>
7309: node</dt>
7310:
7311: <dd>
7312:
7313: <p>If one of the ancestors of <var title="">current node</var>
7314: is a <code><a href="semantics.html#the-style-element">style</a></code>, <code><a href="semantics.html#script">script</a></code>,
1.5 mike 7315: <code>xmp</code>, <code><a href="embedded-content-0.html#the-iframe-element">iframe</a></code>, <code><a href="obsolete.html#noembed">noembed</a></code>,
7316: <code><a href="obsolete.html#noframes">noframes</a></code>, <code><a href="semantics.html#the-noscript-element">noscript</a></code>, or
1.1 mike 7317: <code>plaintext</code> element, then append the value of <var title="">current node</var>'s <code title="">data</code> DOM
7318: attribute literally.</p> <!-- note about noscript: we're
7319: assuming here that scripting is enabled. If this algorithm is
7320: used with scripting disabled, this won't work right. XXX This
7321: might affect calling innerHTML on nodes in a document that is
7322: being designMode'd -->
7323:
7324: <p>Otherwise, append the value of <var title="">current
7325: node</var>'s <code title="">data</code> DOM attribute, <a href="#escapingString" title="escaping a string">escaped as described
7326: below</a>.</p>
7327:
7328: </dd>
7329:
7330:
7331: <dt>If <var title="">current node</var> is a <code title="">Comment</code></dt>
7332:
7333: <dd>
7334:
7335: <p>Append the literal string <code><!--</code> (U+003C
7336: LESS-THAN SIGN, U+0021 EXCLAMATION MARK, U+002D HYPHEN-MINUS,
7337: U+002D HYPHEN-MINUS), followed by the value of <var title="">current node</var>'s <code title="">data</code> DOM
7338: attribute, followed by the literal string <code>--></code>
7339: (U+002D HYPHEN-MINUS, U+002D HYPHEN-MINUS, U+003E GREATER-THAN
7340: SIGN).</p>
7341:
7342: </dd>
7343:
7344:
7345: <dt>If <var title="">current node</var> is a <code title="">ProcessingInstruction</code></dt>
7346:
7347: <dd>
7348:
7349: <p>Append the literal string <code><?</code> (U+003C
7350: LESS-THAN SIGN, U+003F QUESTION MARK), followed by the value
7351: of <var title="">current node</var>'s <code title="">target</code> DOM attribute, followed by a single
7352: U+0020 SPACE character, followed by the value of <var title="">current node</var>'s <code title="">data</code> DOM
7353: attribute, followed by a single U+003E GREATER-THAN SIGN
7354: character ('>').</p>
7355:
7356: </dd>
7357:
7358:
7359: <dt>If <var title="">current node</var> is a <code title="">DocumentType</code></dt>
7360:
7361: <dd>
7362:
7363: <p>Append the literal string <code><!DOCTYPE</code> (U+003C
7364: LESS-THAN SIGN, U+0021 EXCLAMATION MARK, U+0044 LATIN CAPITAL
7365: LETTER D, U+004F LATIN CAPITAL LETTER O, U+0043 LATIN CAPITAL
7366: LETTER C, U+0054 LATIN CAPITAL LETTER T, U+0059 LATIN CAPITAL
7367: LETTER Y, U+0050 LATIN CAPITAL LETTER P, U+0045 LATIN CAPITAL
7368: LETTER E), followed by a space (U+0020 SPACE), followed by the
7369: value of <var title="">current node</var>'s <code title="">name</code> DOM attribute, followed by the literal
7370: string <code>></code> (U+003E GREATER-THAN SIGN).</p>
7371:
7372: </dd>
7373:
7374:
7375: </dl><p>Other node types (e.g. <code title="">Attr</code>) cannot
7376: occur as children of elements. If, despite this, they somehow do
7377: occur, this algorithm must raise an
7378: <code><a href="infrastructure.html#invalid_state_err">INVALID_STATE_ERR</a></code> exception.</p>
7379:
7380: </li>
7381:
7382: </ol></li>
7383:
7384: <li><p>The result of the algorithm is the string <var title="">s</var>.</p></li>
7385:
7386: </ol><p><dfn id="escapingString">Escaping a string</dfn> (for the
7387: purposes of the algorithm above) consists of replacing any
7388: occurrences of the "<code title="">&</code>" character by the
7389: string "<code title="">&amp;</code>", any occurrences of the
7390: U+00A0 NO-BREAK SPACE character by the string "<code title="">&nbsp;</code>", and, if the algorithm was invoked in
7391: the <i>attribute mode</i>, any occurrences of the "<code title="">"</code>" character by the string "<code title="">&quot;</code>", or if it was not, any occurrences of
7392: the "<code title=""><</code>" character by the string "<code title="">&lt;</code>", any occurrences of the "<code title="">></code>" character by the string "<code title="">&gt;</code>".</p>
7393:
7394: <p class="note">Entity reference nodes are <a href="infrastructure.html#entity-references">assumed to be expanded</a> by the user
7395: agent, and are therefore not covered in the algorithm above.</p>
7396:
7397: <p class="note">It is possible that the output of this algorithm, if
7398: parsed with an <a href="#html-parser">HTML parser</a>, will not return the
7399: original tree structure. For instance, if a <code><a href="forms.html#the-textarea-element">textarea</a></code>
7400: element to which a <code title="">Comment</code> node has been
7401: appended is serialized and the output is then reparsed, the comment
7402: will end up being displayed in the text field. Similarly, if, as a
7403: result of DOM manipulation, an element contains a comment that
7404: contains the literal string "<code title="">--></code>", then
7405: when the result of serializing the element is parsed, the comment
7406: will be truncated at that point and the rest of the comment will be
7407: interpreted as markup. More examples would be making a
7408: <code><a href="semantics.html#script">script</a></code> element contain a text node with the text string
7409: "<code></script></code>", or having a <code><a href="semantics.html#the-p-element">p</a></code> element that
7410: contains a <code><a href="semantics.html#the-ul-element">ul</a></code> element (as the <code><a href="semantics.html#the-ul-element">ul</a></code> element's
7411: <a href="#syntax-start-tag" title="syntax-start-tag">start tag</a> would imply the end
7412: tag for the <code><a href="semantics.html#the-p-element">p</a></code>).</p>
7413:
7414:
7415: <h3 id="parsing-html-fragments"><span class="secno">9.5 </span>Parsing HTML fragments</h3>
7416:
7417: <p>The following steps form the <dfn id="html-fragment-parsing-algorithm">HTML fragment parsing
7418: algorithm</dfn>. The algorithm optionally takes as input an
7419: <code>Element</code> node, referred to as the <var title="">context</var> element, which gives the context for the
7420: parser, as well as <var title="">input</var>, a string to parse, and
7421: returns a list of zero or more nodes.</p>
7422:
7423: <p class="note">Parts marked <dfn id="fragment-case">fragment case</dfn> in algorithms
7424: in the parser section are parts that only occur if the parser was
7425: created for the purposes of this algorithm (and with a <var title="">context</var> element). The algorithms have been annotated
7426: with such markings for informational purposes only; such markings
7427: have no normative weight. If it is possible for a condition
7428: described as a <a href="#fragment-case">fragment case</a> to occur even when the
7429: parser wasn't created for the purposes of handling this algorithm,
7430: then that is an error in the specification.</p>
7431:
7432: <ol><li>
7433:
7434: <p>Create a new <code>Document</code> node, and mark it as being
7435: an <a href="dom.html#html-documents" title="HTML documents">HTML document</a>.</p>
7436:
7437: </li>
7438:
7439: <li>
7440:
7441: <p>If there is a <var title="">context</var> element, and the
7442: <code>Document</code> of the <var title="">context</var> element
7443: is in <a href="dom.html#quirks-mode">quirks mode</a>, then let the <code>Document</code>
7444: be in <a href="dom.html#quirks-mode">quirks mode</a>. Otherwise, if there is a <var title="">context</var> element, and the <code>Document</code> of
7445: the <var title="">context</var> element is in <a href="dom.html#limited-quirks-mode">limited quirks
7446: mode</a>, then let the <code>Document</code> be in
7447: <a href="dom.html#limited-quirks-mode">limited quirks mode</a>. Otherwise, leave the
7448: <code>Document</code> in <a href="dom.html#no-quirks-mode">no quirks mode</a>.</p>
7449:
7450: </li>
7451:
7452: <li>
7453:
7454: <p>Create a new <a href="#html-parser">HTML parser</a>, and associate it with
7455: the just created <code>Document</code> node.</p>
7456:
7457: </li>
7458:
7459: <li>
7460:
7461: <p>If there is a <var title="">context</var> element, run these
7462: substeps:</p>
7463:
7464: <ol><li>
7465:
7466: <p>Set the <a href="#html-parser">HTML parser</a>'s <a href="#tokenization">tokenization</a>
7467: stage's <a href="#content-model-flag">content model flag</a> according to the <var title="">context</var> element, as follows:</p>
7468:
7469: <dl class="switch"><dt>If it is a <code><a href="semantics.html#the-title-element">title</a></code> or <code><a href="forms.html#the-textarea-element">textarea</a></code>
7470: element</dt>
7471:
7472: <dd>Set the <a href="#content-model-flag">content model flag</a> to
7473: the RCDATA state.</dd>
7474:
7475:
7476: <dt>If it is a <code><a href="semantics.html#the-style-element">style</a></code>, <code><a href="semantics.html#script">script</a></code>,
1.5 mike 7477: <code>xmp</code>, <code><a href="embedded-content-0.html#the-iframe-element">iframe</a></code>, <code><a href="obsolete.html#noembed">noembed</a></code>, or
7478: <code><a href="obsolete.html#noframes">noframes</a></code> element</dt>
1.1 mike 7479:
7480: <dd>Set the <a href="#content-model-flag">content model flag</a> to
7481: the CDATA state.</dd>
7482:
7483:
7484: <dt>If it is a <code><a href="semantics.html#the-noscript-element">noscript</a></code> element</dt>
7485:
7486: <dd>If the <a href="#scripting-flag">scripting flag</a> is enabled, set the
7487: <a href="#content-model-flag">content model flag</a> to the CDATA
7488: state. Otherwise, set the <a href="#content-model-flag">content model flag</a> to the
7489: PCDATA state.</dd>
7490:
7491:
7492: <dt>If it is a <code>plaintext</code> element</dt>
7493:
7494: <dd>Set the <a href="#content-model-flag">content model flag</a> to
7495: PLAINTEXT.</dd>
7496:
7497:
7498: <dt>Otherwise</dt>
7499:
7500: <dd>Leave the <a href="#content-model-flag">content model flag</a> in the PCDATA
7501: state.</dd>
7502:
7503: </dl></li>
7504:
7505: <li>
7506:
7507: <p>Let <var title="">root</var> be a new <code><a href="semantics.html#the-html-element">html</a></code> element
7508: with no attributes.</p>
7509:
7510: </li>
7511:
7512: <li>
7513:
7514: <p>Append the element <var title="">root</var> to the
7515: <code>Document</code> node created above.</p>
7516:
7517: </li>
7518:
7519: <li>
7520:
7521: <p>Set up the parser's <a href="#stack-of-open-elements">stack of open elements</a> so that
7522: it contains just the single element <var title="">root</var>.</p>
7523:
7524: </li>
7525:
7526: <li>
7527:
7528: <p><a href="#reset-the-insertion-mode-appropriately" title="reset the insertion mode appropriately">Reset the
7529: parser's insertion mode appropriately</a>.</p>
7530:
7531: <p class="note">The parser will reference the <var title="">context</var> element as part of that algorithm.</p>
7532:
7533: </li>
7534:
7535: <li>
7536:
7537: <p>Set the parser's <a href="#form-element-pointer"><code>form</code> element pointer</a>
7538: to the nearest node to the <var title="">context</var> element
7539: that is a <code><a href="forms.html#the-form-element">form</a></code> element (going straight up the
7540: ancestor chain, and including the element itself, if it is a
7541: <code><a href="forms.html#the-form-element">form</a></code> element), or, if there is no such
7542: <code><a href="forms.html#the-form-element">form</a></code> element, to null.</p>
7543:
7544: </li>
7545:
7546: </ol></li>
7547:
7548: <li>
7549:
7550: <p>Place into the <a href="#the-input-stream">input stream</a> for the <a href="#html-parser">HTML
7551: parser</a> just created the <var title="">input</var>. The
7552: encoding <a href="#concept-encoding-confidence" title="concept-encoding-confidence">confidence</a> is
7553: <i>irrelevant</i>.</p>
7554:
7555: </li>
7556:
7557: <li>
7558:
7559: <p>Start the parser and let it run until it has consumed all the
7560: characters just inserted into the input stream.</p>
7561:
7562: </li>
7563:
7564: <li>
7565:
7566: <p>If there is a <var title="">context</var> element, return the
7567: child nodes of <var title="">root</var>, in <a href="infrastructure.html#tree-order">tree
7568: order</a>.</p>
7569:
7570: <p>Otherwise, return the children of the <code>Document</code>
7571: object, in <a href="infrastructure.html#tree-order">tree order</a>.</p>
7572:
7573: </li>
7574:
7575: </ol></div></body></html>
Webmaster
![[BACK]](/https/dev.w3.org/cvsweb/icons/back.gif){kind=icon}
Return to syntax.html CVS log ![[TXT]](/https/dev.w3.org/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/https/dev.w3.org/cvsweb/icons/dir.gif){kind=icon}
Up to [Public] / html5 / spec