<body>: The Document Body element
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
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 theglobal attributes, event attributes, and deprecated attributes:
Event attributes
Note:Each of the below event attribute names is linked to its equivalentWindow interface event. You can listen to these events usingaddEventListener() instead of adding theoneventname attribute to the<body> element.
onafterprintFunction to call after the user has printed the document.
onbeforeprintFunction to call when the user requests printing of the document.
onbeforeunloadFunction to call when the document is about to be unloaded.
onblurFunction to call when the document loses focus.
onerrorFunction to call when the document fails to load properly.
onfocusFunction to call when the document receives focus.
onhashchangeFunction to call when the fragment identifier part (starting with the hash (
'#') character) of the document's current address has changed.onlanguagechangeFunction to call when the preferred languages changed.
onloadFunction to call when the document has finished loading.
onmessageFunction to call when the document has received a message.
onmessageerrorFunction to call when the document has received a message that cannot be deserialized.
onofflineFunction to call when network communication has failed.
ononlineFunction to call when network communication has been restored.
onpageswapFunction to call when you navigate across documents, when the previous document is about to unload.
onpagehideFunction to call when the browser hides the current page in the process of presenting a different page from the session's history.
onpagerevealFunction to call when a document is first rendered, either when loading a fresh document from the network or activating a document.
onpageshowFunction to call when the browser displays the window's document due to navigation.
onpopstateFunction to call when the user has navigated session history.
onresizeFunction to call when the document has been resized.
onrejectionhandledFunction to call when a JavaScript
Promiseis handled late.onstorageFunction to call when the storage area has changed.
onunhandledrejectionFunction to call when a JavaScript
Promisethat has no rejection handler is rejected.onunloadDeprecatedFunction 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.
alinkDeprecatedColor of text for hyperlinks when selected.Use the CSS
colorproperty in conjunction with the:activeand:focuspseudo-classes instead.backgroundDeprecatedURI of an image to use as a background.Use the CSS
background-imageproperty instead.bgcolorDeprecatedBackground color for the document.Use the CSS
background-colorproperty instead.bottommarginDeprecatedThe margin of the bottom of the body.Use the CSS
margin-bottomproperty (or the logicalmargin-block-endproperty) instead.leftmarginDeprecatedThe margin of the left of the body.Use the CSS
margin-leftproperty (or the logicalmargin-inline-startproperty) instead.linkDeprecatedColor of text for unvisited hypertext links.Use the CSS
colorproperty in conjunction with the:linkpseudo-class instead.rightmarginDeprecatedThe margin of the right of the body.Use the CSS
margin-rightproperty or the logicalmargin-inline-endproperty) instead.textDeprecatedForeground color of text.Use the CSS
colorproperty instead.topmarginDeprecatedThe margin of the top of the body.Use the CSS
margin-topproperty (or the logicalmargin-block-startproperty) instead.vlinkDeprecatedColor of text for visited hypertext links.Use the CSS
colorproperty in conjunction with the:visitedpseudo-class instead.
Examples
<html lang="en"> <head> <title>Document title</title> </head> <body> <p> The <code><body></code> HTML element represents the content of an HTML document. There can be only one <code><body></code> element in a document. </p> </body></html>Result
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,<script> element or<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<html> element. |
| Implicit ARIA role | generic |
| Permitted ARIA roles | Norole permitted |
| DOM interface | HTMLBodyElement
|
Specifications
| Specification |
|---|
| HTML # the-body-element |