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 Standard
# htmlbodyelement

浏览器兼容性

BCD tables only load in the browser

参见

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