HTMLBodyElement - Web API 接口参考 编辑

HTMLBodyElement 接口提供了特殊的属性（除了它们继承的常规的HTMLElement接口）以外，还可以处理 body 元素。  

  <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="/wiki/zh-CN/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="/wiki/zh-CN/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="/wiki/zh-CN/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/wiki/zh-CN/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="/wiki/zh-CN/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;}

属性

从其父项HTMLElement 和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.

方法

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

事件处理

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.

WindowEventHandlers.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.

规范

Specification	Status	Comment
HTML Living Standard HTMLBodyElement	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 HTMLBodyElement	Recommendation
HTML5 HTMLBodyElement	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 HTMLBodyElement	Obsolete	No change from Document Object Model (DOM) Level 1 Specification.
Document Object Model (DOM) Level 1 Specification HTMLBodyElement	Obsolete	Initial definition.

浏览器兼容性

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

• Desktop
• Mobile

Feature	Chrome	Edge	Firefox (Gecko)	Internet Explorer	Opera	Safari (WebKit)
Basic support	1	(Yes)	1.0 (1.7 or earlier) [1]	4.0	(Yes) [1]	(Yes)
onXYZ event handlers	(Yes)	?	(Yes)	?	(Yes)	?
onlanguage	未实现	?	32 (32)	?	未实现	?
onmessageerror	60	?	?	?	47	?
onstorage	(Yes)	?	45 (45)	?	(Yes)	?
onrejectionhandled and onunhandledrejection	49	?	未实现	未实现	36	未实现

Feature	Android Webview	Chrome for Android	Edge	Firefox Mobile (Gecko)	IE Phone	Opera Mobile	Safari Mobile
Basic support	(Yes)	(Yes)	(Yes)	1.0 (1.0)	(Yes)	(Yes)	(Yes)
onXYZ event handlers	(Yes)	(Yes)	?	(Yes)	?	(Yes)	?
onlangugage	未实现	未实现	?	32.0 (32)	?	未实现	?
onmessageerror	60	60	?	?	?	47	?
onstorage	(Yes)	(Yes)	?	45.0 (45)	?	(Yes)	?
onrejectionhandled and onunhandledrejection	49	49	?	未实现	未实现	36	未实现

[1] Firefox prior to Firefox 7.0 (and some older versions of Opera) returned a URI for the HTMLBodyElement.background attribute.

参考阅读

• HTML element implementing this interface: <body>
• WindowEventHandlers