mozilla

Revision 335439 of <html>

  • Revision slug: HTML/Element/html
  • Revision title: <html>
  • Revision id: 335439
  • Created:
  • Creator: teoli
  • Is current revision? No
  • Comment

Revision Content

Summary

The HTML <html> Element (or HTML root element) represents the root of an HTML or XHTML document. All other elements must be descendants of this element.

  • Content categories None.
  • Permitted content One {{HTMLElement("head")}} element, followed by one {{HTMLElement("body")}} element.
  • Tag omission The start tag may be omitted if the first thing inside the <html> element is not a comment.
    The end tag may be omitted if the <html> element is not immediately followed by a comment, and it contains a {{HTMLElement("body")}} element either that is not empty, or whose start tag is present.
  • Permitted parent elementsAs the root element of a document, or wherever a subdocument fragment is allowed in a compound document.
  • DOM interface {{domxref("HTMLhtmlElement")}}

Attributes

Like all HTML elements, this element supports the global attributes.

{{htmlattrdef("manifest")}} {{HTMLVersionInline(5)}} {{Gecko_minversion_inline(1.9)}}
Specifies the URI of a resource manifest indicating resources that should be cached locally. See Offline resources in Firefox for details.
{{htmlattrdef("version")}} {{deprecatedGeneric('inline','HTML4.01')}} {{obsoleteGeneric('inline','HTML5')}}
Specifies the version of the HTML Document Type Definition that governs the current document. This attribute is not needed, because it is redundant with the version information in the document type declaration.

Example

The DOCTYPE used in the following example indicates HTML5.

<!DOCTYPE html>
<html>
  <head>...</head>
  <body>...</body>
</html>

Notes

Since the <html> element is the first in a document other than comments, it is called the root element. Although this tag can be implied, or not required, with HTML, it is required to be opened and closed in XHTML.

Specifications

Specification Status Comment
{{SpecName('HTML WHATWG', 'semantics.html#the-html-element', '<html>')}} {{Spec2('HTML WHATWG')}}  
{{SpecName('HTML5 W3C', 'the-html-element.html#the-html-element', '<html>')}} {{Spec2('HTML5 W3C')}}  
{{SpecName('HTML4.01', 'global.html#h-7.3', '<html>')}} {{Spec2('HTML4.01')}}  

Browser compatibility

{{CompatibilityTable}}

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 1.0 {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}}
Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}}

See also

  • MathML top-level element: {{MathMLElement("math")}}
  • SVG top-level element: {{SVGElement("svg")}}
{{HTML:Element_Navigation}}

Revision Source

<h2 id="Summary">Summary</h2>
<p>The <strong>HTML <span style="font-family: Courier New;">&lt;html&gt;</span> Element</strong> (or <em>HTML root element</em>) represents the root of an HTML or XHTML document. All other elements must be descendants of this element.</p>
<ul class="htmlelt">
  <li><dfn><a href="/en-US/docs/HTML/Content_categories" title="HTML/Content_categories">Content categories</a></dfn> None.</li>
  <li><dfn>Permitted content</dfn> One {{HTMLElement("head")}} element, followed by one {{HTMLElement("body")}}&nbsp;element.</li>
  <li><dfn>Tag omission</dfn> The start tag may be omitted if the first thing inside the <code>&lt;html&gt;</code> element is not a comment.<br />
    The end tag may be omitted if the <code>&lt;html&gt;</code> element is not immediately followed by a comment, and it contains a {{HTMLElement("body")}}&nbsp;element either that is not empty, or whose start tag is present.</li>
  <li><dfn>Permitted parent elements</dfn>As the root element of a document, or wherever a subdocument fragment is allowed in a compound document.</li>
  <li><dfn>DOM interface</dfn> {{domxref("HTMLhtmlElement")}}</li>
</ul>
<h2 id="Attributes">Attributes</h2>
<p>Like all HTML&nbsp;elements, this element supports the <a href="/en-US/docs/HTML/Global_attributes" title="HTML/Global attributes">global attributes</a>.</p>
<dl>
  <dt>
    {{htmlattrdef("manifest")}} {{HTMLVersionInline(5)}} {{Gecko_minversion_inline(1.9)}}</dt>
  <dd>
    Specifies the URI of a resource manifest indicating resources that should be cached locally. See <a href="/en-US/docs/HTML/Using_the_application_cache" title="Offline_resources_in_Firefox">Offline resources in Firefox</a> for details.</dd>
  <dt>
    {{htmlattrdef("version")}} {{deprecatedGeneric('inline','HTML4.01')}} {{obsoleteGeneric('inline','HTML5')}}</dt>
  <dd>
    Specifies the version of the HTML&nbsp;Document Type Definition that governs the current document. This attribute is not needed, because it is redundant with the version information in the document type declaration.</dd>
</dl>
<h2 id="Example">Example</h2>
<p>The DOCTYPE used in the following example indicates HTML5.</p>
<pre class="brush: html">
&lt;!DOCTYPE html&gt;
&lt;html&gt;
  &lt;head&gt;...&lt;/head&gt;
  &lt;body&gt;...&lt;/body&gt;
&lt;/html&gt;
</pre>
<h2 id="Notes">Notes</h2>
<p>Since the <code>&lt;html&gt;</code> element is the first in a document other than comments, it is called the root element. Although this tag can be implied, or not required, with <a href="/en-US/docs/HTML" title="HTML">HTML</a>, it is required to be opened and closed in <a href="/en-US/docs/XHTML" title="XHTML">XHTML</a>.</p>
<h2 id="Specifications" name="Specifications">Specifications</h2>
<table class="standard-table">
  <thead>
    <tr>
      <th scope="col">Specification</th>
      <th scope="col">Status</th>
      <th scope="col">Comment</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>{{SpecName('HTML WHATWG', 'semantics.html#the-html-element', '&lt;html&gt;')}}</td>
      <td>{{Spec2('HTML WHATWG')}}</td>
      <td>&nbsp;</td>
    </tr>
    <tr>
      <td>{{SpecName('HTML5 W3C', 'the-html-element.html#the-html-element', '&lt;html&gt;')}}</td>
      <td>{{Spec2('HTML5 W3C')}}</td>
      <td>&nbsp;</td>
    </tr>
    <tr>
      <td>{{SpecName('HTML4.01', 'global.html#h-7.3', '&lt;html&gt;')}}</td>
      <td>{{Spec2('HTML4.01')}}</td>
      <td>&nbsp;</td>
    </tr>
  </tbody>
</table>
<h2 id="Browser_compatibility" name="Browser_compatibility">Browser compatibility</h2>
<p>{{CompatibilityTable}}</p>
<div id="compat-desktop">
  <table class="compat-table">
    <tbody>
      <tr>
        <th>Feature</th>
        <th>Chrome</th>
        <th>Firefox (Gecko)</th>
        <th>Internet Explorer</th>
        <th>Opera</th>
        <th>Safari (WebKit)</th>
      </tr>
      <tr>
        <td>Basic support</td>
        <td>1.0</td>
        <td>{{CompatVersionUnknown}}</td>
        <td>{{CompatVersionUnknown}}</td>
        <td>{{CompatVersionUnknown}}</td>
        <td>{{CompatVersionUnknown}}</td>
      </tr>
    </tbody>
  </table>
</div>
<div id="compat-mobile">
  <table class="compat-table">
    <tbody>
      <tr>
        <th>Feature</th>
        <th>Android</th>
        <th>Firefox Mobile (Gecko)</th>
        <th>IE&nbsp;Phone</th>
        <th>Opera Mobile</th>
        <th>Safari Mobile</th>
      </tr>
      <tr>
        <td>Basic support</td>
        <td>{{CompatVersionUnknown}}</td>
        <td>{{CompatVersionUnknown}}</td>
        <td>{{CompatVersionUnknown}}</td>
        <td>{{CompatVersionUnknown}}</td>
        <td>{{CompatVersionUnknown}}</td>
      </tr>
    </tbody>
  </table>
</div>
<h2 id="See_also">See also</h2>
<ul>
  <li>MathML top-level element: {{MathMLElement("math")}}</li>
  <li>SVG top-level element: {{SVGElement("svg")}}</li>
</ul>
<div>
  {{HTML:Element_Navigation}}</div>
Revert to this revision