<body>:文档主体元素

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

<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

规范

Specification
HTML
# the-body-element

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
body
alink
Deprecated
background
Deprecated
bgcolor
Deprecated
bottommargin
Deprecated
leftmargin
Deprecated
link
Deprecated
rightmargin
Deprecated
text
Deprecated
topmargin
Deprecated
vlink
Deprecated

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Deprecated. Not for use in new websites.
See implementation notes.

参见