HTMLBodyElement - Web APIs

The HTMLBodyElement interface provides special properties (beyond those inherited from the regular HTMLElement interface) for manipulating <body> elements.

  <div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 20%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 120" preserveAspectRatio="xMinYMin meet"><a xlink:href="/docs/Web/API/EventTarget" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25  121,20  121,30  111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="/docs/Web/API/Node" target="_top"><rect x="151" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="188.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Node</text></a><polyline points="226,25  236,20  236,30  226,25" stroke="#D4DDE4" fill="none"/><line x1="236" y1="25" x2="266" y2="25" stroke="#D4DDE4"/><a xlink:href="/docs/Web/API/Element" target="_top"><rect x="266" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="303.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Element</text></a><polyline points="341,25  351,20  351,30  341,25" stroke="#D4DDE4" fill="none"/><line x1="351" y1="25" x2="381" y2="25" stroke="#D4DDE4"/><a xlink:href="/docs/Web/API/HTMLElement" target="_top"><rect x="381" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="436" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLElement</text></a><polyline points="491,25  501,20  501,30  491,25" stroke="#D4DDE4" fill="none"/><line x1="501" y1="25" x2="509" y2="25" stroke="#D4DDE4"/><line x1="509" y1="25" x2="509" y2="90" stroke="#D4DDE4"/><line x1="509" y1="90" x2="492" y2="90" stroke="#D4DDE4"/><a xlink:href="/docs/Web/API/HTMLBodyElement" target="_top"><rect x="341" y="65" width="150" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text  x="416" y="94" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLBodyElement</text></a></svg></div>

  a:hover text { fill: #0095DD; pointer-events: all;}

Properties

Inherits properties from its parent, HTMLElement and from WindowEventHandlers.

HTMLBodyElement.aLink: Is a DOMString that represents the color of active hyperlinks.
HTMLBodyElement.background: Is a DOMString 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: Is a DOMString that represents the background color for the document.
HTMLBodyElement.link: Is a DOMString that represents the color of unvisited links.
HTMLBodyElement.text: Is a DOMString that represents the foreground color of text.
HTMLBodyElement.vLink: Is a DOMString that represents the color of visited links.

Methods

No specific methods; inherits methods from its parent, HTMLElement, and from WindowEventHandlers.

Event handlers

No specific event handlers; inherits event handlers from its parent, HTMLElement and from WindowEventHandlers.

WindowEventHandlers.onafterprint: Is an EventHandler representing the code to be called when the afterprint event is raised.
WindowEventHandlers.onbeforeprint: Is an EventHandler representing the code to be called when the beforeprint event is raised.
WindowEventHandlers.onbeforeunload: Is an EventHandler representing the code to be called when the beforeunload event is raised.
WindowEventHandlers.onhashchange: Is an EventHandler representing the code to be called when the hashchange event is raised.
WindowEventHandlers.onlanguagechange: Is an EventHandler representing the code to be called when the languagechange event is raised.
WindowEventHandlers.onmessage: Is an EventHandler called whenever an object receives a message event.
WindowEventHandlers.onmessageerror: Is an eventHandler called whenever an object receives a messageerror event.
WindowEventHandlers.onoffline: Is an EventHandler representing the code to be called when the offline event is raised.
WindowEventHandlers.ononline: Is an EventHandler representing the code to be called when the online event is raised.
WindowEventHandlers.onpagehide: Is an EventHandler representing the code to be called when the pagehide event is raised.
WindowEventHandlers.onpageshow: Is an EventHandler representing the code to be called when the pageshow event is raised.
WindowEventHandlers.onpopstate: Is an EventHandler representing the code to be called when the popstate event is raised.
WindowEventHandlers.onrejectionhandled: An EventHandler representing the code executed when the rejectionhandled event is raised, indicating that a Promise was rejected and the rejection has been handled.
GlobalEventHandlers.onresize: Is an EventHandler representing the code to be called when the resize event is raised.
WindowEventHandlers.onstorage: Is an EventHandler representing the code to be called when the storage event is raised.
WindowEventHandlers.onunhandledrejection: An EventHandler representing the code executed when the unhandledrejection event is raised, indicating that a Promise was rejected but the rejection was not handled.
WindowEventHandlers.onunload: Is an EventHandler representing the code to be called when the unload event is raised.

Specifications

Specification	Status	Comment
HTML Living Standard The definition of 'HTMLBodyElement' in that specification.	Living Standard	Technically, the event-related properties `onafterprint`, `onbeforeprint`, `onbeforeunload`, `onblur`, `onerror`, `onfocus`, `onhashchange`, `onlanguagechange`, `onload`, `onmessage`, `onoffline`, `ononline`, `onpopstate`, `onresize`, `onstorage`, and `onunload`, have been moved to `WindowEventHandlers`. `HTMLBodyElement` implements this interface.
HTML 5.1 The definition of 'HTMLBodyElement' in that specification.	Recommendation
HTML5 The definition of 'HTMLBodyElement' in that specification.	Recommendation	The following properties are now obsolete: `aLink`, `bgColor`, `background`, `link`, `text`, and `vLink`. The following properties have been added: `onafterprint`, `onbeforeprint`, `onbeforeunload`, `onblur`, `onerror`, `onfocus`, `onhashchange`, `onload`, `onmessage`, `onoffline`, `ononline`, `onpopstate`, `onresize`, `onstorage`, and `onunload`.
Document Object Model (DOM) Level 2 HTML Specification The definition of 'HTMLBodyElement' in that specification.	Obsolete	No change from Document Object Model (DOM) Level 1 Specification.
Document Object Model (DOM) Level 1 Specification The definition of 'HTMLBodyElement' in that specification.	Obsolete	Initial definition.

Browser compatibility

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`HTMLBodyElement`	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support 4	Opera Full support Yes	Safari Full support Yes	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes
`aLink` Deprecated	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support 4	Opera Full support Yes	Safari Full support Yes	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes
`background` Deprecated	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support 4	Opera Full support Yes	Safari Full support Yes	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes
`bgColor` Deprecated	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support 4	Opera Full support Yes	Safari Full support Yes	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes
`link` Deprecated	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support 4	Opera Full support Yes	Safari Full support Yes	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes
`text` Deprecated	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support 4	Opera Full support Yes	Safari Full support Yes	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes
`vLink` Deprecated	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support 4	Opera Full support Yes	Safari Full support Yes	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes

Legend

Full support: Full support
Deprecated. Not for use in new websites.: Deprecated. Not for use in new websites.