大网数据广告活动
Web 标准与前端开发

<body>:文档主体元素

· 52CE 我爱测

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

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

属性

这个元素只包含全局属性、事件属性和弃用属性:

事件属性

[!NOTE] 以下每个事件属性名称都链接到其对应的 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
    • : 当文档即将被卸载时调用的函数。

已弃用的属性

[!WARNING] 请勿使用这些已弃用的属性;应选择每个弃用属性所列的 CSS 替代方案。

  • alink
    • : 选中时超链接文本的颜色。请结合使用 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)。
  • link
    • : 未访问超文本链接文本的颜色。请结合使用 CSS color 属性和 :link 伪类来代替。
  • rightmargin
    • : body 右侧的外边距。请结合使用 CSS margin-right 属性(或逻辑属性 margin-inline-end)。
  • text
    • : 文字的前景色。请改用 CSS 的 color 属性。
  • topmargin
    • : body 顶部的外边距。请结合使用 CSS margin-top 属性(或逻辑属性 margin-block-start)。
  • vlink
    • : 已访问超文本链接文本的颜色。请结合使用 CSS color 属性和 :visited 伪类来代替。

示例

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

结果

示例

技术概要

<table class="properties"> <tbody> <tr> <th scope="row"> <a href="/zh-CN/docs/Web/HTML/Guides/Content_categories" >内容分类</a > </th> <td> 无。 </td> </tr> <tr> <th scope="row">允许的内容</th> <td> <a href="/zh-CN/docs/Web/HTML/Guides/Content_categories#流式内容" >流式内容</a >。 </td> </tr> <tr> <th scope="row">标签省略</th> <td> 如果开始标签内的第一个内容不是空格符、注释、script 元素或 style 元素,则可以省略起始标签。如果 <code><body></code> 元素有内容或有开始标记,且后面没有紧跟注释,则可以省略结束标记。 </td> </tr> <tr> <th scope="row">允许的父元素</th> <td> 它必须是 html 元素的第二个元素。 </td> </tr> <tr> <th scope="row">隐含的 ARIA 角色</th> <td> <code ><a href="/zh-CN/docs/Web/Accessibility/ARIA/Reference/Roles/generic_role" >generic</a ></code > </td> </tr> <tr> <th scope="row">允许的 ARIA 角色</th> <td>没有允许的 <code>role</code></td> </tr> <tr> <th scope="row">DOM 接口</th> <td> HTMLBodyElement <ul> <li> <code><body></code> 元素使用 HTMLBodyElement 接口。 </li> <li> 你可以通过 document.body 属性访问 <code><body></code> 元素。 </li> </ul> </td> </tr> </tbody> </table>

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。