HTMLBodyElement
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 HTMLBodyElement
interface provides special properties (beyond those inherited from the regular HTMLElement
interface) for manipulating <body>
elements.
Instance properties
Inherits properties from its parent, HTMLElement
.
HTMLBodyElement.aLink
DeprecatedA string that represents the color of active hyperlinks.
HTMLBodyElement.background
DeprecatedA string that represents the description of the location of the background image resource. Note that this is not an URI, though some older version of some browsers do expect it.
HTMLBodyElement.bgColor
DeprecatedA string that represents the background color for the document.
HTMLBodyElement.link
DeprecatedA string that represents the color of unvisited links.
HTMLBodyElement.text
DeprecatedA string that represents the foreground color of text.
HTMLBodyElement.vLink
DeprecatedA string that represents the color of visited links.
Instance methods
No specific methods; inherits methods from its parent, HTMLElement
.
Event handlers
The HTMLElement
events are inherited.
The following Window
onXYZ
event handler properties are also available as aliases targeting the window
object. However, it is advised to listen to them on the window
object directly rather than on HTMLBodyElement
.
Note: Using addEventListener()
on HTMLBodyElement
will not work for the onXYZ
event handlers listed below. Listen to the events on the window
object instead.
HTMLBodyElement.onafterprint
Fired after the associated document has started printing or the print preview has been closed.
HTMLBodyElement.onbeforeprint
Fired when the associated document is about to be printed or previewed for printing.
HTMLBodyElement.onbeforeunload
Fired when the window, the document and its resources are about to be unloaded.
HTMLBodyElement.onblur
Fired when the window loses focus.
HTMLBodyElement.onerror
Fired when an error occurs and bubbles up to the window.
HTMLBodyElement.onfocus
Fired when the window gains focus.
HTMLBodyElement.ongamepadconnected
Fired when the browser detects that a gamepad has been connected or the first time a button/axis of the gamepad is used.
HTMLBodyElement.ongamepaddisconnected
Fired when the browser detects that a gamepad has been disconnected.
HTMLBodyElement.onhashchange
Fired when the fragment identifier of the URL has changed (the part of the URL beginning with and following the
#
symbol).HTMLBodyElement.onlanguagechange
Fired when the user's preferred language changes.
HTMLBodyElement.onload
Fired when the document has finished loading.
HTMLBodyElement.onmessage
Fired when the window receives a message, for example from a call to
Window.postMessage()
from another browsing context.HTMLBodyElement.onmessageerror
Fired when the window receives a message that can't be deserialized.
HTMLBodyElement.onoffline
Fired when the browser has lost access to the network and the value of
Navigator.onLine
switches tofalse
.HTMLBodyElement.ononline
Fired when the browser has gained access to the network and the value of
Navigator.onLine
switches totrue
.HTMLBodyElement.onpagehide
Fired when the browser hides the current page in the process of presenting a different page from the session's history.
HTMLBodyElement.onpageshow
Fired when the browser displays the window's document due to navigation.
HTMLBodyElement.onpopstate
Fired when the active history entry changes while the user navigates the session history.
HTMLBodyElement.onrejectionhandled
Fired whenever a JavaScript
Promise
is rejected and the rejection has been handled.HTMLBodyElement.onresize
Fired when the document view has been resized.
HTMLBodyElement.onscroll
Fired when the document view or an element has been scrolled.
HTMLBodyElement.onstorage
Fired when a storage area (
localStorage
) has been modified in the context of another document.HTMLBodyElement.onunhandledrejection
Fired whenever a
Promise
is rejected but the rejection was not handled.HTMLBodyElement.onunload
Fired when the document is being unloaded.
Note that while onblur
, onerror
, onfocus
, onload
, onresize
, and onscroll
are available on any element, their meanings on the <body>
element are not the same as on other elements. They listen for events on the window
object instead.
Specifications
Specification |
---|
HTML # htmlbodyelement |
Browser compatibility
See also
- HTML element implementing this interface:
<body>