<body>: 文档主体元素

Baseline 已广泛支持

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

<body> HTML 元素表示 HTML 文档的内容。一个文档中只能有一个 <body> 元素。

属性

此元素包括全局属性、事件属性和已废弃属性。

事件属性

注意:下面每个事件属性名称都链接到其等效的 Window 接口事件。你可以使用 addEventListener() 监听这些事件,而不是将 oneventname 属性添加到 <body> 元素。

onafterprint

用户打印文档后调用的函数。

onbeforeprint

用户请求打印文档时调用的函数。

onbeforeunload

文档即将卸载时调用的函数。

onblur

文档失去焦点时调用的函数。

onerror

文档加载失败时调用的函数。

onfocus

文档获得焦点时调用的函数。

onhashchange

文档当前地址的片段标识符部分(以哈希('#')字符开头)发生变化时调用的函数。

onlanguagechange

首选语言更改时调用的函数。

onload

文档加载完成时调用的函数。

onmessage

文档收到消息时调用的函数。

onmessageerror

文档收到无法反序列化的消息时调用的函数。

onoffline

网络通信失败时调用的函数。

ononline

网络通信恢复时调用的函数。

onpageswap

在文档之间导航时,当上一个文档即将卸载时调用的函数。

onpagehide

浏览器在显示会话历史记录中的不同页面时隐藏当前页面时调用的函数。

onpagereveal

文档首次渲染时调用的函数,无论是从网络加载新文档还是激活文档。

onpageshow

由于导航导致浏览器显示窗口文档时调用的函数。

onpopstate

用户导航会话历史记录时调用的函数。

onresize

文档大小调整时调用的函数。

onrejectionhandled

JavaScript Promise 延迟处理时调用的函数。

onstorage

存储区域更改时调用的函数。

onunhandledrejection

没有拒绝处理程序的 JavaScript Promise 被拒绝时调用的函数。

onunload 已废弃

文档即将卸载时调用的函数。

已弃用属性

警告:请勿使用这些已废弃的属性;应选择每个已废弃属性列出的 CSS 替代方案。

选定超链接的文本颜色。请改用 CSS color 属性与 :active:focus 伪类结合使用。

background 已废弃

用作背景图像的 URI。请改用 CSS background-image 属性。

bgcolor 已弃用

文档的背景颜色。请改用 CSS background-color 属性。

bottommargin 已废弃

主体的下边距。请改用 CSS margin-bottom 属性(或逻辑属性 margin-block-end)。

leftmargin 已废弃

主体的左边距。请改用 CSS margin-left 属性(或逻辑属性 margin-inline-start)。

未访问超链接的文本颜色。请改用 CSS color 属性与 :link 伪类结合使用。

rightmargin 已废弃

主体的右边距。请改用 CSS margin-right 属性或逻辑属性 margin-inline-end)。

text 已废弃

文本的前景色。请改用 CSS color 属性。

topmargin 已废弃

主体的上边距。请改用 CSS margin-top 属性(或逻辑属性 margin-block-start)。

已访问超链接的文本颜色。请改用 CSS color 属性与 :visited 伪类结合使用。

示例

html
<html lang="en">
  <head>
    <title>Document title</title>
  </head>
  <body>
    <p>
      The <code>&lt;body&gt;</code> HTML element represents the content of an
      HTML document. There can be only one <code>&lt;body&gt;</code> element in
      a document.
    </p>
  </body>
</html>

结果

技术摘要

内容类别 无。
允许内容 流内容.
标签省略 如果其内部的第一个内容不是空格字符、注释、<script> 元素或 <style> 元素,则可以省略开始标签。如果 <body> 元素有内容或有开始标签,并且后面没有立即跟着注释,则可以省略结束标签。
允许父级 它必须是 <html> 元素的第二个元素。
隐式 ARIA 角色 generic
允许的 ARIA 角色 不允许 role
DOM 接口 HTMLBodyElement

规范

规范
HTML
# the-body-element

浏览器兼容性

另见