<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 {{deprecated_inline}}
    • : 选中时超链接文本的颜色。请结合使用 CSS {{cssxref("color")}} 属性，配合 {{cssxref(":active")}} 和 {{cssxref(":focus")}} 伪类。
  • background {{deprecated_inline}}
    • : 用作背景的图片的 URI。请改用 CSS 的 {{cssxref("background-image")}} 属性。
  • bgcolor {{deprecated_inline}}
    • : 文档的背景颜色。请改用 CSS 的 {{cssxref("background-color")}} 属性。
  • bottommargin {{deprecated_inline}}
    • : body 底部的外边距。请改用 CSS 的 {{cssxref("margin-bottom")}} 属性（或逻辑属性 {{cssxref("margin-block-end")}}）。
  • leftmargin {{deprecated_inline}}
    • : body 左侧的外边距。请改用 CSS 的 {{cssxref("margin-left")}} 属性（或逻辑属性 {{cssxref("margin-inline-start")}}）。
  • link {{deprecated_inline}}
    • : 未访问超文本链接文本的颜色。请结合使用 CSS {{cssxref("color")}} 属性和 {{cssxref(":link")}} 伪类来代替。
  • rightmargin {{deprecated_inline}}
    • : body 右侧的外边距。请结合使用 CSS {{cssxref("margin-right")}} 属性（或逻辑属性 {{cssxref("margin-inline-end")}}）。
  • text {{deprecated_inline}}
    • : 文字的前景色。请改用 CSS 的 {{cssxref("color")}} 属性。
  • topmargin {{deprecated_inline}}
    • : body 顶部的外边距。请结合使用 CSS {{cssxref("margin-top")}} 属性（或逻辑属性 {{cssxref("margin-block-start")}}）。
  • vlink {{deprecated_inline}}
    • : 已访问超文本链接文本的颜色。请结合使用 CSS {{cssxref("color")}} 属性和 {{cssxref(":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>

结果

{{EmbedLiveSample('示例')}}

技术概要

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