web api interface
HTMLBodyElement
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.
aLinkDeprecated- : A string that represents the color of active hyperlinks.
backgroundDeprecated- : A string that represents the description of the location of the background image resource. Note that this is not a URI, though some older version of some browsers do expect it.
bgColorDeprecated- : A string that represents the background color for the document.
linkDeprecated- : A string that represents the color of unvisited links.
textDeprecated- : A string that represents the foreground color of text.
vLinkDeprecated- : A 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()onHTMLBodyElementwill not work for theonXYZevent handlers listed below. Listen to the events on thewindowobject 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).
- : Fired when the fragment identifier of the URL has changed (the part of the URL beginning with and following the
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.
- : Fired when the window receives a message, for example from a call to
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
onLineswitches tofalse.
- : Fired when the browser has lost access to the network and the value of
HTMLBodyElement.ononline- : Fired when the browser has gained access to the network and the value of
onLineswitches totrue.
- : Fired when the browser has gained access to the network and the value of
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
Promiseis rejected and the rejection has been handled.
- : Fired whenever a JavaScript
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.
- : Fired when a storage area (
HTMLBodyElement.onunhandledrejection- : Fired whenever a
Promiseis rejected but the rejection was not handled.
- : Fired whenever a
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
Browser compatibility
See also
- HTML element implementing this interface:
<body>