HTML body 標籤(<body>)代表一份 HTML 文件的內容,瀏覽器視窗裡看得到的文字、圖片與連結,都放在它裡面。一份文件只能有一個 <body>。
白話一點,<head> 是文件的資料夾封面,放標題與設定;<body> 才是翻開之後讀者實際看到的內容。
body 的基本結構
<body> 必須是 <html> 的第二個子元素,緊接在 <head> 後面,裡面放流動內容(flow content),也就是一般的段落、標題、清單、圖片等。
<!DOCTYPE html>
<html lang="zh-Hant">
<head>
<meta charset="utf-8">
<title>文件標題</title>
</head>
<body>
<h1>頁面標題</h1>
<p>這裡是讀者看得到的內容。</p>
</body>
</html>
MDN 與 WHATWG 規格都寫明:符合規範的文件只能有一個 body 元素。另外,MDN 列出 <body> 的隱含 ARIA 角色是 generic,且不允許另外指定 role。
開始與結束標籤可以省略
在 text/html 文件中,<body> 的標籤在特定條件下可以省略,這是規格明文允許的:
- 開始標籤:元素內容是空的,或裡面第一個東西不是空白字元或註解時可以省略;但第一個東西若是
meta、noscript、link、script、style或template,就不能省略。 - 結束標籤:
<body>後面緊接的不是註解時可以省略。
標籤省略後,瀏覽器解析時仍會自己補上 <body>。下面這份文件沒寫 <head> 與 <body>:
<!doctype html>
<title>t</title>
<p>hello</p>
用 document.documentElement.outerHTML 讀出解析後的結果,會是:
<html><head><title>t</title></head><body><p>hello</p></body></html>
補充說明:以上是在 Windows 11、Chrome 158 讀到的結果。能省略不代表建議省略,明確寫出
<body>讓結構一眼看得懂,也比較不會踩到上面「第一個東西」的例外。
預設邊距與常見的重設寫法
瀏覽器預設會讓 <body> 四周留白。規格的渲染章節說明,body 的上下左右邊距在沒有其他屬性指定時,預設值是 8px。在 Chrome 158 用 getComputedStyle(document.body) 讀到的 marginTop、marginRight、marginBottom、marginLeft 也都是 8px,display 是 block。
想自己控制版面邊距,用 CSS 調整即可:
body {
margin: 0;
}
不想要四周預設留白時,常見做法就是像上面這樣先把 margin 設成 0,再用其他容器決定內容的寬度與留白。
已淘汰的展示屬性:bgcolor、text 等
早期的 HTML 會直接在 <body> 上用屬性設定顏色與邊距。MDN 把這些屬性都標示為已棄用(deprecated),並提醒不要使用,改用對應的 CSS:
| 已淘汰的屬性 | 用途 | 改用的 CSS |
|---|---|---|
bgcolor | 文件背景色 | background-color |
background | 背景圖片網址 | background-image |
text | 文字顏色 | color |
link | 未造訪連結的顏色 | color 搭配 :link |
vlink | 已造訪連結的顏色 | color 搭配 :visited |
alink | 被點選中連結的顏色 | color 搭配 :active、:focus |
leftmargin、topmargin | 左右、上下邊距 | margin-inline、margin-block 等 |
rightmargin、bottommargin | 邊距 | MDN 標示為「Ignored」,沒有作用 |
HTML 規格的「淘汰功能」章節也把 alink、bgcolor、bottommargin、leftmargin、link、marginheight、marginwidth、rightmargin、text、topmargin、vlink(都在 body 上)列為已淘汰,並說明作者不得使用。
要注意,「淘汰」不等於「瀏覽器不認」。規格的渲染章節仍然要求瀏覽器把這些屬性當作展示提示(presentational hint)處理,例如 bgcolor 對應到 background-color、text 對應到 color。所以舊網頁看起來沒壞,只是新寫的頁面不該再用。
下圖是同樣的顏色,左邊用舊式屬性、右邊用 CSS 寫出的畫面:

圖為 Windows 11、無頭 Chrome 158 的渲染畫面:兩邊的背景色、文字色、連結色與 40px 邊距相同。
兩邊用的程式碼如下,先是舊式屬性:
<body bgcolor="#ffe9a8" text="#7a1f1f" link="#0645ad" vlink="#6b2c91"
leftmargin="40" topmargin="40">
再來是等效的 CSS:
body {
background-color: #ffe9a8;
color: #7a1f1f;
margin: 40px;
}
a:link { color: #0645ad; }
a:visited { color: #6b2c91; }
事件屬性:onload、onresize 等
<body> 還能接 onload、onresize、onhashchange、onpopstate、ononline、onoffline 等事件屬性。MDN 與規格都說明,這些事件其實是 Window 的事件,只是寫在 <body> 標籤上:規格寫道,這些屬性會取代一般元素的同名事件處理器,作用對象是 Window 而不是 <body> 本身。
規格的範例用 ononline 與 onoffline 在網路狀態改變時更新畫面上的文字:
<body ononline="update(true)" onoffline="update(false)" onload="update(navigator.onLine)">
<p>You are: <span id="status">(Unknown)</span></p>
</body>
MDN 建議,與其在標籤上寫 oneventname 屬性,不如用 addEventListener() 監聽事件。下面兩種寫法可以同時存在,兩個處理器都會執行:
<script>
window.log = [];
window.addEventListener('load', () => log.push('window listener'));
</script>
<body onload="log.push('body onload attr')">
在 Chrome 158 執行後,log 的內容依序是 window listener、body onload attr,而 document.body.onload === window.onload 為 true,也就是 body 上的 onload 與 window.onload 是同一個處理器。
補充說明:MDN 把
onunload標示為已棄用。需要離開頁面前的處理時,查看對應事件的官方文件再決定寫法。
在 JavaScript 中取得 body
腳本用 document.body 取得 <body> 元素,它是 HTMLBodyElement 介面的實例。若文件沒有 <body>,document.body 會是 null;MDN 還說明,在框架集(frameset)文件中它會回傳最外層的 <frameset>。
比較常遇到的情況是時機:寫在 <head> 裡的腳本在 <body> 還沒被解析出來時就執行,這時讀到的是 null。
<head>
<script>
console.log(document.body); // null
</script>
</head>
<body>
<script>
console.log(document.body.tagName); // "BODY"
</script>
</body>
在 Chrome 158 執行,<head> 裡的腳本讀到 null,<body> 裡的腳本讀到 "BODY"。要在 <head> 裡寫需要操作 body 的腳本時,等文件載入後(例如放進 DOMContentLoaded 事件)再執行。
補充說明:
document.body可以重新指定。MDN 提醒,指定新的 body 會把原本<body>的子節點全部移除。
小結
<body>代表文件的內容,一份文件只能有一個,是<html>的第二個子元素。- 開始與結束標籤在規格允許的條件下可以省略,但明確寫出來比較清楚。
- 預設有
8px的邊距,需要時用 CSS 的margin調整。 bgcolor、text、link等展示屬性已淘汰,用 CSS 取代。onload等事件屬性實際對應的是Window事件,建議用addEventListener()。document.body在<body>解析前會是null。
想了解語意化標籤如何在 <body> 裡搭配使用,可以參考站內另一篇:HTML 語意化標籤的邊界:談 section、article 與 aside 的巢狀邏輯陷阱。
發佈留言