: The Document Body element

{{HTMLSidebar}}

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 {{domxref("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 {{jsxref("Promise")}} is handled late.
onstorage
- : Function to call when the storage area has changed.
onunhandledrejection
- : Function to call when a JavaScript {{jsxref("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 {{deprecated_inline}}
- : Color of text for hyperlinks when selected. Use the CSS {{cssxref("color")}} property in conjunction with the {{cssxref(":active")}} and {{cssxref(":focus")}} pseudo-classes instead.
background {{deprecated_inline}}
- : URI of an image to use as a background. Use the CSS {{cssxref("background-image")}} property instead.
bgcolor {{deprecated_inline}}
- : Background color for the document. Use the CSS {{cssxref("background-color")}} property instead.
bottommargin {{deprecated_inline}}
- : The margin of the bottom of the body. Use the CSS {{cssxref("margin-bottom")}} property (or the logical {{cssxref("margin-block-end")}} property) instead.
leftmargin {{deprecated_inline}}
- : The margin of the left of the body. Use the CSS {{cssxref("margin-left")}} property (or the logical {{cssxref("margin-inline-start")}} property) instead.
link {{deprecated_inline}}
- : Color of text for unvisited hypertext links. Use the CSS {{cssxref("color")}} property in conjunction with the {{cssxref(":link")}} pseudo-class instead.
rightmargin {{deprecated_inline}}
- : The margin of the right of the body. Use the CSS {{cssxref("margin-right")}} property or the logical {{cssxref("margin-inline-end")}} property) instead.
text {{deprecated_inline}}
- : Foreground color of text. Use the CSS {{cssxref("color")}} property instead.
topmargin {{deprecated_inline}}
- : The margin of the top of the body. Use the CSS {{cssxref("margin-top")}} property (or the logical {{cssxref("margin-block-start")}} property) instead.
vlink {{deprecated_inline}}
- : Color of text for visited hypertext links. Use the CSS {{cssxref("color")}} property in conjunction with the {{cssxref(":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

{{EmbedLiveSample('Example')}}

Technical summary

Content categories	None.
Permitted content	Flow content.
Tag omission	The start tag may be omitted if the first thing inside it is not a space character, comment, `{{HTMLElement("script")}}` element or `{{HTMLElement("style")}}` element. The end tag may be omitted if the `<body>` element has contents or has a start tag, and is not immediately followed by a comment.
Permitted parents	It must be the second element of an `{{HTMLElement("html")}}` element.
Implicit ARIA role	`generic`
Permitted ARIA roles	No `role` permitted
DOM interface	`{{domxref("HTMLBodyElement")}}` The `<body>` element exposes the `{{domxref("HTMLBodyElement")}}` interface. You can access the `<body>` element through the `{{domxref("document.body")}}` property.

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

docs.rodeo

MDN Web Docs mirror