<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() を用いて待ち受けすることができます。これが <body> 要素に onイベント名 属性を追加する代わりになります。
onafterprint-
ユーザーによる印刷データ作成直後に呼び出す関数です。
onbeforeprint-
ユーザーによるブラウザーへの印刷指示直後に呼び出す関数です。
onbeforeunload-
文書のアンロードの直前に呼び出す関数です。
onblur-
文書からフォーカスが外されたときに呼び出す関数です。
onerror-
文書を正常にロードできなかった際に呼び出す関数です。
onfocus-
文書にフォーカスが当たった際に呼び出す関数です。
onhashchange-
文書の現在のアドレスのフラグメント識別子 (ハッシュ文字
'#'から始まる部分) が変更された際に呼び出す関数です。 onlanguagechange-
言語が変更された際に呼び出す関数です。
onload-
文書の読み込み完了時に呼び出す関数です。
onmessage-
文書が API からメッセージを受信した際に呼び出す関数です。
onmessageerror-
文書がデシリアライズできないメッセージを受信したときに呼び出す関数です。
onoffline-
ネットワークとの交信が不能になった際に呼び出す関数です。
ononline-
ネットワークとの交信が発生あるいは回復した際に呼び出す関数です。
onpageswap-
文書間を移動する際に、前回の文書がアンロードされようとしたときに呼び出す関数です。
onpagehide-
セッションの履歴から別のページを表示する過程で、ブラウザーが現在のページを非表示にしたときに呼び出す関数です。
onpagereveal-
新しい文書をネットワークから読み込んだとき、または文書をアクティブにした際に、文書が最初にレンダリングされたときに呼び出す関数です。
onpageshow-
ナビゲーションによりブラウザーがウィンドウの文書を表示するときに呼び出す関数です。
onpopstate-
ユーザーによるセッション履歴のナビゲート時に呼び出す関数です。
onresize-
文書を表示するウィンドウがリサイズされた際に呼び出す関数です。
onrejectionhandled-
JavaScript のプロミス (
Promise) が遅れて処理されたときに呼び出す関数です。 onstorage-
ストレージ領域が変化した際に呼び出す関数です。
onunhandledrejection-
JavaScript の拒否ハンドラーを持たないプロミス (
Promise) が拒否されたときに発生します。 onunload-
文書からの離脱時に呼び出す関数です。
非推奨の属性
警告: これらの非推奨の属性は使用しないでください。代わりに、各非推奨の属性とともに掲載されている 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プロパティを使用してください。 text非推奨;-
基本文字色です。 代わりに CSS の
colorプロパティを使用してください。 topmargin非推奨;-
body の上マージンです。 代わりに CSS の
margin-topプロパティを使用してください。 vlink非推奨;-
訪問済みのハイパーリンクの文字色です。 代わりに CSS の
colorプロパティを:visited擬似クラスで使用してください。
例
<html lang="en">
<head>
<title>Document title</title>
</head>
<body>
<p>
The <code><body></code> HTML element represents the content of an
HTML document. There can be only one <code><body></code> element in
a document.
</p>
</body>
</html>
結果
技術的概要
| コンテンツカテゴリー | なし。 |
|---|---|
| 許可されている内容 | フローコンテンツ |
| タグの省略 |
開始タグは、内容の先頭が空白文字、コメント、 <script> 要素、 <style> 要素でない場合は省略可能です。終了タグは、 <body> 要素に内容または開始タグがあり、かつ、直後のノードがコメントでない場合は省略可能です。
|
| 許可されている親要素 |
<html> 要素の子要素でなければなりません。
|
| 暗黙の ARIA ロール |
generic
|
| 許可されている ARIA ロール | 許可されている role なし |
| DOM インターフェイス |
HTMLBodyElement
|
仕様書
| Specification |
|---|
| HTML # the-body-element |