HTMLBodyElement

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

HTMLBodyElement 接口提供了操作 <body> 元素的特殊属性(除了继承自常规 HTMLElement 接口的属性)。

EventTarget Node Element HTMLElement HTMLBodyElement

实例属性

继承自其父级 HTMLElement 的属性。

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

HTMLBodyElement.background 已弃用

一个字符串,表示背景图像资源位置的描述。请注意,这不是 URI,尽管某些较旧版本的某些浏览器会期望它。

HTMLBodyElement.bgColor 已弃用

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

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

HTMLBodyElement.text 已弃用

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

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

实例方法

没有特定方法;从其父级 HTMLElement 继承方法。

事件处理器

HTMLElement 事件是继承的。

以下 WindowonXYZ 事件处理程序属性也可以作为指向 window 对象的别名。但是,建议直接在 window 对象上监听它们,而不是在 HTMLBodyElement 上。

注意:HTMLBodyElement 上使用 addEventListener() 对下面列出的 onXYZ 事件处理程序不起作用。请在 window 对象上监听事件。

HTMLBodyElement.onafterprint

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

HTMLBodyElement.onbeforeprint

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

HTMLBodyElement.onbeforeunload

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

HTMLBodyElement.onblur

当窗口失去焦点时触发。

HTMLBodyElement.onerror

当发生错误并冒泡到窗口时触发。

HTMLBodyElement.onfocus

当窗口获得焦点时触发。

HTMLBodyElement.ongamepadconnected

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

HTMLBodyElement.ongamepaddisconnected

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

HTMLBodyElement.onhashchange

当 URL 的片段标识符(以 # 符号开头并跟随的部分)发生变化时触发。

HTMLBodyElement.onlanguagechange

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

HTMLBodyElement.onload

文档加载完成时触发。

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

当文档视图的大小被调整时触发。

HTMLBodyElement.onscroll

当文档视图或元素已滚动时触发。

HTMLBodyElement.onstorage

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

HTMLBodyElement.onunhandledrejection

每当 Promise 被拒绝但该拒绝未处理时触发。

HTMLBodyElement.onunload

当文档正在卸载时触发。

请注意,虽然 onbluronerroronfocusonloadonresizeonscroll 在任何元素上都可用,但它们在 <body> 元素上的含义与其他元素不同。它们监听的是 window 对象上的事件。

规范

规范
HTML
# htmlbodyelement

浏览器兼容性

另见

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