HTMLBodyElement

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

HTMLBodyElement 接口提供了用于操作 <body> 元素的特定属性(除继承自 HTMLElement 接口的属性以外)。

EventTarget Node Element HTMLElement HTMLBodyElement

实例属性

从其父接口 HTMLElement 继承属性。

一个表示活动链接颜色的字符串。

HTMLBodyElement.background 已弃用

一个表示背景图片资源位置的字符串。注意,这不是 URI,尽管一些旧版浏览器可能会期望它是。

HTMLBodyElement.bgColor 已弃用

一个表示文档背景颜色的字符串。

一个表示未访问链接颜色的字符串。

HTMLBodyElement.text 已弃用

一个表示文本前景色的字符串。

一个表示已访问链接颜色的字符串。

实例方法

无特定方法;从其父接口 HTMLElement 继承方法。

事件处理器

HTMLElement 继承事件。

以下以 Window 为目标的 onXYZ 事件处理器属性同样在 window 对象这一别名目标上可用。但建议直接在 window 对象上监听这些事件,而不是在 HTMLBodyElement 上。

备注: 对于以下的 onXYZ 事件处理器,在 HTMLBodyElement 上使用 addEventListener() 将不会生效。请在 window 对象上监听这些事件。

HTMLBodyElement.onafterprint

在关联的文档开始打印或打印预览关闭后触发。

HTMLBodyElement.onbeforeprint

在关联的文档即将打印或预览打印时触发。

HTMLBodyElement.onbeforeunload

在窗口、文档及其资源即将被卸载时触发。

HTMLBodyElement.ongamepadconnected

在浏览器检测到游戏手柄已连接或首次使用游戏手柄的按钮/轴时触发。

HTMLBodyElement.ongamepaddisconnected

在浏览器检测到游戏手柄已断开连接时触发。

HTMLBodyElement.onhashchange

在 URL 的片段标识符(URL 中以 # 符号开头和紧跟的部分)发生变化时触发。

HTMLBodyElement.onlanguagechange

在用户首选语言发生变更时触发。

HTMLBodyElement.onmessage

在窗口接收到消息时触发,例如来自另一个浏览上下文的 Window.postMessage() 调用。

HTMLBodyElement.onmessageerror

在窗口接收到无法反序列化的消息时触发。

HTMLBodyElement.onoffline

在浏览器失去网络连接且 Navigator.onLine 的值变为 false 时触发。

HTMLBodyElement.ononline

在浏览器获得网络连接且 Navigator.onLine 的值变为 true 时触发。

HTMLBodyElement.onpagehide

在浏览器在呈现会话历史中的不同页面而隐藏当前页面时触发。

HTMLBodyElement.onpageshow

在浏览器由于导航而显示窗口的文档时触发。

HTMLBodyElement.onpopstate

在用户导航会话历史而使活动历史条目发生变化时触发。

HTMLBodyElement.onrejectionhandled

在 JavaScript Promise 被拒绝且拒绝已被处理时触发。

HTMLBodyElement.onstorage

在另一个文档的上下文中修改存储区(localStorage)时触发。

HTMLBodyElement.onunhandledrejection

在 JavaScript Promise 被拒绝且拒绝未被处理时触发。

HTMLBodyElement.onunload

在文档被卸载时触发。

规范

Specification
HTML
# htmlbodyelement

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
HTMLBodyElement
aLink
Deprecated
background
Deprecated
bgColor
Deprecated
link
Deprecated
text
Deprecated
vLink
Deprecated

Legend

Tip: you can click/tap on a cell for more information.

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

参见

  • 实现了此接口的 HTML 元素:<body>