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

HTML

HTML caption 標籤:表格標題寫法

HTML caption 標籤:表格標題寫法 特色圖片

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

五個表格對照:A 只有 caption、未設定樣式,標題置中顯示在上方;B 設定 caption-side top 與 text-align left,標題靠左加粗;C 設定 caption-side bottom,標題在表格下方;D 只替 caption 設定藍色背景;E 沒有 caption 的表格

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

參考資料與延伸閱讀

發佈留言