紀錄工作經驗、相關知識,解決技術相關問題。

HTML

HTML body 標籤:頁面內容區與常用屬性

HTML body 標籤:頁面內容區與常用屬性 特色圖片

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 寫出的畫面:

左邊 body 使用 bgcolor、text、link 等舊式屬性,右邊改用 CSS 的 background-color、color 與連結偽類別,兩者顯示相同的淡黃底與深紅文字

圖為 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 的巢狀邏輯陷阱。

參考資料與延伸閱讀

發佈留言