MDN self-hosted library · e01.org

`<body>` HTML document body element

The <body> HTML element represents the content of an HTML document. There can be only one <body> element in a document.

The <body> HTML element represents the content of an HTML document. There can be only one <body> element in a document.

Attributes

This element includes the global attributes, event attributes, and deprecated attributes:

Event attributes

[!NOTE] Each of the below event attribute names is linked to its equivalent Window interface event. You can listen to these events using addEventListener() instead of adding the oneventname attribute to the <body> element.

  • onafterprint
  • : Function to call after the user has printed the document.
  • onbeforeprint
  • : Function to call when the user requests printing of the document.
  • onbeforeunload
  • : Function to call when the document is about to be unloaded.
  • onblur
  • : Function to call when the document loses focus.
  • onerror
  • : Function to call when the document fails to load properly.
  • onfocus
  • : Function to call when the document receives focus.
  • onhashchange
  • : Function to call when the fragment identifier part (starting with the hash ('#') character) of the document's current address has changed.
  • onlanguagechange
  • : Function to call when the preferred languages changed.
  • onload
  • : Function to call when the document has finished loading.
  • onmessage
  • : Function to call when the document has received a message.
  • onmessageerror
  • : Function to call when the document has received a message that cannot be deserialized.
  • onoffline
  • : Function to call when network communication has failed.
  • ononline
  • : Function to call when network communication has been restored.
  • onpageswap
  • : Function to call when you navigate across documents, when the previous document is about to unload.
  • onpagehide
  • : Function to call when the browser hides the current page in the process of presenting a different page from the session's history.
  • onpagereveal
  • : Function to call when a document is first rendered, either when loading a fresh document from the network or activating a document.
  • onpageshow
  • : Function to call when the browser displays the window's document due to navigation.
  • onpopstate
  • : Function to call when the user has navigated session history.
  • onresize
  • : Function to call when the document has been resized.
  • onrejectionhandled
  • : Function to call when a JavaScript Promise is handled late.
  • onstorage
  • : Function to call when the storage area has changed.
  • onunhandledrejection
  • : Function to call when a JavaScript Promise that has no rejection handler is rejected.
  • onunload
  • : Function to call when the document is going away.

Deprecated attributes

[!WARNING] Do not use these deprecated attributes; opt for the CSS alternatives listed with each deprecated attribute instead.

  • alink
  • : Color of text for hyperlinks when selected. Use the CSS color property in conjunction with the :active and :focus pseudo-classes instead.
  • background
  • : URI of an image to use as a background. Use the CSS background-image property instead.
  • bgcolor
  • : Background color for the document. Use the CSS background-color property instead.
  • bottommargin
  • : Ignored.
  • leftmargin
  • : The margin of the left and right of the body. Use the CSS margin-left and margin-right properties (or the logical margin-inline property) instead.
  • link
  • : Color of text for unvisited hypertext links. Use the CSS color property in conjunction with the :link pseudo-class instead.
  • rightmargin
  • : Ignored.
  • text
  • : Foreground color of text. Use the CSS color property instead.
  • topmargin
  • : The margin of the top and bottom of the body. Use the CSS margin-top and margin-bottom properties (or the logical margin-block property) instead.
  • vlink
  • : Color of text for visited hypertext links. Use the CSS color property in conjunction with the :visited pseudo-class instead.

Examples

<html lang="en">
  <head>
    <title>Document title</title>
  </head>
  <body>
    <p>
      The <code>&lt;body&gt;</code> HTML element represents the content of an
      HTML document. There can be only one <code>&lt;body&gt;</code> element in
      a document.
    </p>
  </body>
</html>

Result

examples

Technical summary

Content categories None.
Permitted content Flow content.
Tag omission The start tag may be omitted if the element is empty, or if the first thing inside it is not ASCII whitespace or a comment, except if the first thing inside it is a meta, noscript, link, script, style, or template element. The end tag may be omitted if the <body> element is not immediately followed by a comment.
Permitted parents It must be the second element of an html element.
Implicit ARIA role generic
Permitted ARIA roles No role permitted
DOM interface HTMLBodyElement
  • The <body> element exposes the HTMLBodyElement interface.
  • You can access the <body> element through the document.body property.

Specifications

Browser compatibility

See also