The HTMLBodyElement
interface provides special properties (beyond those of the regular HTMLElement
interface they also inherit) 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="https://developer.mozilla.org/en-US/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="https://developer.mozilla.org/en-US/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="https://developer.mozilla.org/en-US/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="https://developer.mozilla.org/en-US/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="https://developer.mozilla.org/en-US/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 theafterprint
event is raised. WindowEventHandlers.onbeforeprint
- Is an
EventHandler
representing the code to be called when thebeforeprint
event is raised. WindowEventHandlers.onbeforeunload
- Is an
EventHandler
representing the code to be called when thebeforeunload
event is raised. WindowEventHandlers.onhashchange
- Is an
EventHandler
representing the code to be called when thehashchange
event is raised. WindowEventHandlers.onlanguagechange
- Is an
EventHandler
representing the code to be called when thelanguagechange
event is raised. WindowEventHandlers.onmessage
- Is an
EventHandler
representing the code to be called when themessage
event is raised. WindowEventHandlers.onoffline
- Is an
EventHandler
representing the code to be called when theoffline
event is raised. WindowEventHandlers.ononline
- Is an
EventHandler
representing the code to be called when theonline
event is raised. WindowEventHandlers.onpagehide
- Is an
EventHandler
representing the code to be called when thepagehide
event is raised. WindowEventHandlers.onpageshow
- Is an
EventHandler
representing the code to be called when thepageshow
event is raised. WindowEventHandlers.onpopstate
- Is an
EventHandler
representing the code to be called when thepopstate
event is raised. WindowEventHandlers.onrejectionhandled
- An
EventHandler
representing the code executed when therejectionhandled
event is raised, indicating that aPromise
was rejected and the rejection has been handled. WindowEventHandlers.onresize
- Is an
EventHandler
representing the code to be called when theresize
event is raised. WindowEventHandlers.onstorage
- Is an
EventHandler
representing the code to be called when thestorage
event is raised. WindowEventHandlers.onunhandledrejection
- An
EventHandler
representing the code executed when theunhandledrejection
event is raised, indicating that aPromise
was rejected but the rejection was not handled. WindowEventHandlers.onunload
- Is an
EventHandler
representing the code to be called when theunload
event is raised.
Specifications
Specification | Status | Comment |
---|---|---|
WHATWG 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. |
Recommendation | No change from Document Object Model (DOM) Level 1 Specification. |
Document Object Model (DOM) Level 1 Specification The definition of 'HTMLBodyElement' in that specification. |
Recommendation | Initial definition. |
Browser compatibility
Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|---|
Basic support | 1.0 | (Yes) | 1.0 (1.7 or earlier) [1] | 4.0 | (Yes) [1] | (Yes) |
onXYZ event handlers |
(Yes) | ? | (Yes) | ? | ? | ? |
onlanguage |
? | ? | 32 (32) | ? | ? | ? |
onstorage |
? | ? | 45 (45) | ? | ? | ? |
onrejectionhandled and onunhandledrejection |
49 | ? | No support | No support | No support | No support |
Feature | Android | Edge | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | 1.0 (1.0) | (Yes) | (Yes) | (Yes) |
onXYZ event handlers |
(Yes) | ? | (Yes) | ? | ? | ? |
onlangugage |
? | ? | 32.0 (32) | ? | ? | ? |
onstorage |
? | ? | 45.0 (45) | ? | ? | ? |
onrejectionhandled and onunhandledrejection |
? | ? | No support | No support | No support | No support |
[1] Firefox prior to Firefox 7.0 (and some older versions of Opera) returned a URI for the HTMLBodyElement.background
attribute.
See also
- HTML element implementing this interface:
<body>
WindowEventHandlers
Document Tags and Contributors
Tags:
Contributors to this page:
Sebastianz,
erikadoyle,
Sheppy,
teoli,
fscholz,
Nexii,
Ehsan,
Rob W,
imsaikat,
kscarfone,
trevorh,
fkling42,
jswisher,
Ms2ger
Last updated by:
Sebastianz,