`<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 theoneventnameattribute 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><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
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
|
Specifications
Browser compatibility
See also
- html
- head
- Event handling overview