我们的志愿者还没有将这篇文章翻译为 中文 (简体)。加入我们帮助完成翻译!
您也可以阅读此文章的English (US)版。
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
DOMStringthat represents the color of active hyperlinks. HTMLBodyElement.background- Is a
DOMStringthat 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
DOMStringthat represents the background color for the document. HTMLBodyElement.link- Is a
DOMStringthat represents the color of unvisited links. HTMLBodyElement.text- Is a
DOMStringthat represents the foreground color of text. HTMLBodyElement.vLink- Is a
DOMStringthat 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
EventHandlerrepresenting the code to be called when theafterprintevent is raised. WindowEventHandlers.onbeforeprint- Is an
EventHandlerrepresenting the code to be called when thebeforeprintevent is raised. WindowEventHandlers.onbeforeunload- Is an
EventHandlerrepresenting the code to be called when thebeforeunloadevent is raised. WindowEventHandlers.onhashchange- Is an
EventHandlerrepresenting the code to be called when thehashchangeevent is raised. WindowEventHandlers.onlanguagechange- Is an
EventHandlerrepresenting the code to be called when thelanguagechangeevent is raised. WindowEventHandlers.onmessage- Is an
EventHandlerrepresenting the code to be called when themessageevent is raised. WindowEventHandlers.onoffline- Is an
EventHandlerrepresenting the code to be called when theofflineevent is raised. WindowEventHandlers.ononline- Is an
EventHandlerrepresenting the code to be called when theonlineevent is raised. WindowEventHandlers.onpagehide- Is an
EventHandlerrepresenting the code to be called when thepagehideevent is raised. WindowEventHandlers.onpageshow- Is an
EventHandlerrepresenting the code to be called when thepageshowevent is raised. WindowEventHandlers.onpopstate- Is an
EventHandlerrepresenting the code to be called when thepopstateevent is raised. WindowEventHandlers.onrejectionhandled- An
EventHandlerrepresenting the code executed when therejectionhandledevent is raised, indicating that aPromisewas rejected and the rejection has been handled. WindowEventHandlers.onresize- Is an
EventHandlerrepresenting the code to be called when theresizeevent is raised. WindowEventHandlers.onstorage- Is an
EventHandlerrepresenting the code to be called when thestorageevent is raised. WindowEventHandlers.onunhandledrejection- An
EventHandlerrepresenting the code executed when theunhandledrejectionevent is raised, indicating that aPromisewas rejected but the rejection was not handled. WindowEventHandlers.onunload- Is an
EventHandlerrepresenting the code to be called when theunloadevent 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