1. 面向开发者的 Web 技术
  2. HTML（超文本标记语言）
  3. HTML 参考
  4. HTML 元素参考
  5. <body>

此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

<body>：文档主体元素

基线
广泛可用

自 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

body 底部的外边距。请改用 CSS 的 margin-bottom 属性（或逻辑属性 margin-block-end）。

leftmargin

body 左侧的外边距。请改用 CSS 的 margin-left 属性（或逻辑属性 margin-inline-start）。

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

rightmargin

body 右侧的外边距。请结合使用 CSS margin-right 属性（或逻辑属性 margin-inline-end）。

text

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

topmargin

body 顶部的外边距。请结合使用 CSS margin-top 属性（或逻辑属性 margin-block-start）。

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

示例

html
<html lang="zh-CN">
  <head>
    <title>文档标题</title>
  </head>
  <body>
    <p>
      <code>&lt;body&gt;</code> HTML 元素代表 HTML
      文档的内容。一个文档中只能有一个 <code>&lt;body&gt;</code> 元素。
    </p>
  </body>
</html>

结果

技术概要

内容分类 无。
允许的内容 流式内容。
标签省略 如果开始标签内的第一个内容不是空格符、注释、<script> 元素或 <style> 元素，则可以省略起始标签。如果 <body> 元素有内容或有开始标记，且后面没有紧跟注释，则可以省略结束标记。
允许的父元素 它必须是 <html> 元素的第二个元素。
隐含的 ARIA 角色 generic
允许的 ARIA 角色 没有允许的 role
DOM 接口 HTMLBodyElement
  • <body> 元素使用 HTMLBodyElement 接口。
  • 你可以通过 document.body 属性访问 <body> 元素。

规范

规范
HTML
# the-body-element

浏览器兼容性

参见

帮助改进 MDN

了解如何参与贡献

此页面最后更新于 ，由 MDN 贡献者更新。

在 GitHub 上查看此页面 • 报告此内容的问题