{{APIRef("HTML DOM")}}
The HTMLBodyElement
interface provides special properties (beyond those of the regular {{ domxref("HTMLElement") }} interface they also inherit) for manipulating body elements.
Properties
Inherits properties from its parent, {{domxref("HTMLElement")}} and from {{domxref("WindowEventHandlers")}}.
- {{domxref("HTMLBodyElement.aLink")}} {{obsolete_inline}}
- Is a {{ domxref("DOMString") }} that represents the color of active hyperlinks.
- {{domxref("HTMLBodyElement.background")}} {{obsolete_inline}}
- Is a {{ domxref("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.
- {{domxref("HTMLBodyElement.bgColor")}} {{obsolete_inline}}
- Is a {{ domxref("DOMString") }} that represents the background color for the document.
- {{domxref("HTMLBodyElement.link")}} {{obsolete_inline}}
- Is a {{ domxref("DOMString") }} that represents the color of unvisited links.
- {{domxref("HTMLBodyElement.text")}} {{obsolete_inline}}
- Is a {{ domxref("DOMString") }} that represents the foreground color of text.
- {{domxref("HTMLBodyElement.vLink")}} {{obsolete_inline}}
- Is a {{ domxref("DOMString") }} that represents the color of visited links.
Methods
No specific method; inherits methods from its parent, {{domxref("HTMLElement")}} and from {{domxref("WindowEventHandlers")}}.
Event handlers
No specific event handler; inherits event handlers from its parent, {{domxref("HTMLElement")}} and from {{domxref("WindowEventHandlers")}}.
- {{domxref("WindowEventHandlers.onafterprint")}}
- Is an {{domxref("EventHandler")}} representing the code to be called when the {{event("afterprint")}} event is raised.
- {{domxref("WindowEventHandlers.onbeforeprint")}}
- Is an {{domxref("EventHandler")}} representing the code to be called when the {{event("beforeprint")}} event is raised.
- {{domxref("WindowEventHandlers.onbeforeunload")}}
- Is an {{domxref("EventHandler")}} representing the code to be called when the {{event("beforeunload")}} event is raised.
- {{domxref("WindowEventHandlers.onhashchange")}}
- Is an {{domxref("EventHandler")}} representing the code to be called when the {{event("hashchange")}} event is raised.
- {{domxref("WindowEventHandlers.onlanguagechange")}} {{experimental_inline}}
- Is an {{domxref("EventHandler")}} representing the code to be called when the {{event("languagechange")}} event is raised.
- {{domxref("WindowEventHandlers.onmessage")}}
- Is an {{domxref("EventHandler")}} representing the code to be called when the {{event("message")}} event is raised.
- {{domxref("WindowEventHandlers.onoffline")}}
- Is an {{domxref("EventHandler")}} representing the code to be called when the {{event("offline")}} event is raised.
- {{domxref("WindowEventHandlers.ononline")}}
- Is an {{domxref("EventHandler")}} representing the code to be called when the {{event("online")}} event is raised.
- {{domxref("WindowEventHandlers.onpagehide")}}
- Is an {{domxref("EventHandler")}} representing the code to be called when the {{event("pagehide")}} event is raised.
- {{domxref("WindowEventHandlers.onpageshow")}}
- Is an {{domxref("EventHandler")}} representing the code to be called when the {{event("pageshow")}} event is raised.
- {{domxref("WindowEventHandlers.onpopstate")}}
- Is an {{domxref("EventHandler")}} representing the code to be called when the {{event("popstate")}} event is raised.
- {{domxref("WindowEventHandlers.onrejectionhandled")}}
- An {{domxref("EventHandler")}} representing the code executed when the {{event("rejectionhandled")}} event is raised, indicating that a {{jsxref("Promise")}} was rejected and the rejection has been handled.
- {{domxref("WindowEventHandlers.onresize")}}
- Is an {{domxref("EventHandler")}} representing the code to be called when the {{event("resize")}} event is raised.
- {{domxref("WindowEventHandlers.onstorage")}}
- Is an {{domxref("EventHandler")}} representing the code to be called when the {{event("storage")}} event is raised.
- {{domxref("WindowEventHandlers.onunhandledrejection")}}
- An {{domxref("EventHandler")}} representing the code executed when the {{event("unhandledrejection")}} event is raised, indicating that a {{jsxref("Promise")}} was rejected but the rejection was not handled.
- {{domxref("WindowEventHandlers.onunload")}}
- Is an {{domxref("EventHandler")}} representing the code to be called when the {{event("unload")}} event is raised.
Specifications
Specification | Status | Comment |
---|---|---|
{{SpecName('HTML WHATWG', "sections.html#the-body-element", "HTMLBodyElement")}} | {{Spec2('HTML WHATWG')}} | Technically, the event-related properties,onafterprint , onbeforeprint , onbeforeunload , onblur , onerror , onfocus , onhashchange , onlanguagechange , onload , onmessage , onoffline , ononline , onpopstate , onresize , onstorage , and onunload , have been moving to {{domxref("WindowEventHandlers")}}, and HTMLBodyElement implements this interface. |
{{SpecName('HTML5.1', "sections.html#the-body-element", "HTMLBodyElement")}} | {{Spec2('HTML5.1')}} | |
{{SpecName('HTML5 W3C', "sections.html#the-body-element", "HTMLBodyElement")}} | {{Spec2('HTML5 W3C')}} | 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 . |
{{SpecName('DOM2 HTML', 'html.html#ID-62018039', 'HTMLBodyElement')}} | {{Spec2('DOM2 HTML')}} | No change from {{SpecName("DOM1")}}. |
{{SpecName('DOM1', 'level-one-html.html#ID-62018039', 'HTMLBodyElement')}} | {{Spec2('DOM1')}} | Initial definition. |
Browser compatibility
{{CompatibilityTable}}
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
Basic support | 1.0 | {{CompatGeckoDesktop(1.0)}} [1] | 4.0 | {{CompatVersionUnknown}} [1] | {{CompatVersionUnknown}} |
onXYZ event handlers |
{{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
onlanguage |
{{CompatUnknown}} | {{CompatGeckoDesktop(32)}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
onstorage |
{{CompatUnknown}} | {{CompatGeckoDesktop(45)}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
onrejectionhandled and onunhandledrejection |
49 | {{CompatNo}} | {{CompatNo}} | {{CompatNo}} | {{CompatNo}} |
Feature | Android | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
Basic support | {{CompatVersionUnknown}} | {{CompatGeckoMobile(1.0)}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} |
onXYZ event handlers |
{{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
onlangugage |
{{CompatUnknown}} | {{CompatGeckoMobile(32)}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
onstorage |
{{CompatUnknown}} | {{CompatGeckoMobile(45)}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
onrejectionhandled and onunhandledrejection |
{{CompatUnknown}} | {{CompatNo}} | {{CompatNo}} | {{CompatNo}} | {{CompatNo}} |
[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: {{ HTMLElement("body") }}
- {{domxref("WindowEventHandlers")}}