HTML caption 標籤是表格的標題,告訴讀者這張表在講什麼。它放在 <table> 裡面,瀏覽器會把它顯示在表格的上方。
白話一點,<caption> 就像論文裡「表 1」旁邊那行說明:讀者不用把整張表看完,就能判斷這張表跟自己要找的資料有沒有關係。
caption 的基本寫法
<caption> 要放在 <table> 裡,而且是第一個子元素,後面才接 <thead>、<tbody> 或 <tr>:
<table>
<caption>使用者登入 Email 清單</caption>
<thead>
<tr>
<th scope="col">帳號</th>
<th scope="col">Email</th>
</tr>
</thead>
<tbody>
<tr>
<td>user1</td>
<td>[email protected]</td>
</tr>
</tbody>
</table>
MDN 說明,<caption> 提供表格的標題,並讓表格有「無障礙名稱」或「無障礙描述」。MDN 也寫明,有 <caption> 時,它必須是 <table> 的第一個子元素。
WHATWG 規格的說法是:<caption> 代表它所屬那張表格的標題,只能出現在 table 元素的第一個元素子節點位置。
caption 裡可以放什麼
規格規定 <caption> 的內容是「流內容」(flow content),但裡面不能有 table 元素的後代。也就是說,標題可以不只一行文字,可以放段落。
規格自己的範例就是在 <caption> 裡放兩個 <p>:第一段寫「Table 1.」這樣的編號,第二段說明表格怎麼讀。
<caption>
<p>表 1。</p>
<p>這張表列出每個使用者的登入帳號與 Email。</p>
</caption>
補充說明:規格指出,標題可以交代表格的編號與用途,讓表格更容易理解。MDN 對
<table>的建議是標題要清楚、簡明地說出表格的用途。
結束標籤可以省略嗎
規格說明,<caption> 的結束標籤可以省略,條件是它後面沒有緊接空白字元或註解。
實務上空白與換行很常見,省略就容易踩到條件。寫成成對的 <caption>...</caption> 最不容易出錯。
用 CSS 調整位置與樣式
<caption> 預設顯示在表格上方。MDN 說明,caption-side 屬性可以指定標題放在哪一側,值是相對於表格的 writing-mode。
標題文字的左右對齊用 text-align。下面的 CSS 把標題放在上方並靠左:
caption {
caption-side: top;
text-align: left;
padding-bottom: 8px;
font-weight: bold;
}
想放到表格下方,改成 caption-side: bottom 即可。
MDN 的使用說明另外提醒,套在 <table> 上的 background-color 不會套用到標題。想讓標題背後也有同樣的顏色,要另外替 caption 設定。
下圖是同一個表格套用不同 CSS 的畫面:

圖為 Windows 11、無頭 Chrome 158 的渲染畫面。每個表格的 <table> 都有淡黃色背景,D 表只有標題另外設了藍色背景。
caption 是表格的無障礙名稱
MDN 指出,<caption> 的作用不只是顯示標題:它讓表格有無障礙名稱或無障礙描述,使用螢幕閱讀器的人可以先知道這張表是什麼,再決定要不要讀裡面的內容。
瀏覽器的無障礙樹可以看到這個差別。同一個表格,有 <caption> 與沒有時,Chrome 輸出的無障礙快照如下(節錄表格最外層):
有 caption:
- table "使用者登入 Email 清單":
- caption: 使用者登入 Email 清單
沒有 caption:
- table:
- rowgroup: ...
有 <caption> 的表格,名稱就是標題文字;沒有的話,這張表就沒有名稱。
補充說明:以上是 Chrome 無障礙樹顯示的名稱,並不代表各種螢幕閱讀器實際怎麼朗讀,朗讀行為依輔助工具而異。
舊的 align 與 summary 不要再用
MDN 把 <caption> 的 align 屬性列為已棄用。它原本用來指定標題顯示在表格的哪一側,現在請改用前面說的 CSS caption-side 與 text-align。
同樣地,<table> 的 summary 屬性也已棄用。MDN 的建議是改用 <caption> 元素描述表格。
表格放在 figure 裡時
有時候表格會放在 <figure> 裡面。MDN 說明,當 <table> 是 <figure> 裡唯一的內容時,應該用 <figure> 的 <figcaption> 當標題,不要再在表格裡放 <caption>。
WHATWG 規格也寫了相同的建議:table 是 figure 中除了 figcaption 以外唯一的內容時,應省略 caption,改用 figcaption。
<figure>
<figcaption>使用者登入 Email 清單</figcaption>
<table>
<thead>
<tr>
<th scope="col">帳號</th>
<th scope="col">Email</th>
</tr>
</thead>
<tbody>
<tr>
<td>user1</td>
<td>[email protected]</td>
</tr>
</tbody>
</table>
</figure>
反過來說,表格單獨放在頁面上、沒有 <figure> 包著時,就用 <caption>。
小結
<caption>是表格的標題,必須放在<table>的第一個子元素,內容是流內容、不能再放 table。- 位置用 CSS 的
caption-side調整,文字對齊用text-align;table的背景色不會套到標題。 <caption>提供表格的無障礙名稱,讓使用輔助工具的人先判斷表格是否相關。align與summary屬性已棄用;表格是<figure>唯一內容時改用<figcaption>。
想進一步了解 HTML 語意化標籤怎麼選用,可以參考站內文章:HTML 語意化標籤的邊界:談 section、article 與 aside 的巢狀邏輯陷阱。
發佈留言