<caption>: Phần tử Chú thích Bảng

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.

* Some parts of this feature may have varying levels of support.

Phần tử <caption> trong HTML xác định chú thích (hoặc tiêu đề) của một bảng, cung cấp cho bảng một accessible name hoặc accessible description.

Try it

<table>
  <caption>
    He-Man and Skeletor facts
  </caption>
  <tbody>
    <tr>
      <td></td>
      <th scope="col" class="heman">He-Man</th>
      <th scope="col" class="skeletor">Skeletor</th>
    </tr>
    <tr>
      <th scope="row">Role</th>
      <td>Hero</td>
      <td>Villain</td>
    </tr>
    <tr>
      <th scope="row">Weapon</th>
      <td>Power Sword</td>
      <td>Havoc Staff</td>
    </tr>
    <tr>
      <th scope="row">Dark secret</th>
      <td>Expert florist</td>
      <td>Cries at romcoms</td>
    </tr>
  </tbody>
</table>
caption {
  caption-side: bottom;
  padding: 10px;
  font-weight: bold;
}

table {
  border-collapse: collapse;
  border: 2px solid rgb(140 140 140);
  font-family: sans-serif;
  font-size: 0.8rem;
  letter-spacing: 1px;
}

th,
td {
  border: 1px solid rgb(160 160 160);
  padding: 8px 10px;
}

th {
  background-color: rgb(230 230 230);
}

td {
  text-align: center;
}

tr:nth-child(even) td {
  background-color: rgb(250 250 250);
}

tr:nth-child(odd) td {
  background-color: rgb(240 240 240);
}

.heman {
  font:
    1.4rem "molot",
    sans-serif;
  text-shadow:
    1px 1px 1px white,
    2px 2px 1px black;
}

.skeletor {
  font:
    1.7rem "rapscallion",
    fantasy;
  letter-spacing: 3px;
  text-shadow:
    1px 1px 0 white,
    0 0 9px black;
}

Thuộc tính

Phần tử này bao gồm các thuộc tính toàn cục.

Thuộc tính không còn dùng

Các thuộc tính sau đây đã không còn được dùng và không nên sử dụng. Chúng được ghi lại dưới đây để tham khảo khi cập nhật code hiện có và chỉ vì lý do lịch sử.

align Deprecated

Xác định phía nào của bảng mà chú thích sẽ được hiển thị. Các giá trị liệt kê có thể là left, top, right hoặc bottom. Thay vào đó hãy sử dụng thuộc tính CSS caption-sidetext-align, vì thuộc tính này đã không còn được dùng.

Ghi chú sử dụng

  • Nếu được bao gồm, phần tử <caption> phải là con đầu tiên của phần tử <table> cha của nó.
  • Khi một <table> được lồng bên trong <figure> như nội dung duy nhất của figure, nó nên được chú thích qua <figcaption> cho <figure> thay vì như một <caption> lồng trong <table>.
  • Bất kỳ background-color nào được áp dụng cho bảng sẽ không được áp dụng cho chú thích. Thêm background-color vào phần tử <caption> nếu bạn muốn cùng màu nền cho cả hai.

Ví dụ

Xem <table> để biết ví dụ bảng đầy đủ giới thiệu các chuẩn và thực hành phổ biến.

Bảng có chú thích

Ví dụ này minh họa một bảng cơ bản có chú thích mô tả dữ liệu được trình bày.

"Tiêu đề" như vậy rất hữu ích cho người dùng đang xem nhanh trang, và đặc biệt có lợi cho người dùng khiếm thị, cho phép họ xác định nhanh mức độ liên quan của bảng mà không cần trình đọc màn hình đọc nội dung của nhiều ô.

HTML

Phần tử <caption> được sử dụng như con đầu tiên của <table>, với nội dung văn bản tương tự tiêu đề để mô tả dữ liệu bảng. Ba hàng, hàng đầu là hàng tiêu đề, với hai cột được tạo bằng các phần tử <tr>, <th><td> sau <caption>.

html
<table>
  <caption>
    User login email addresses
  </caption>
  <thead>
    <tr>
      <th>Login</th>
      <th>Email</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>user1</td>
      <td>user1@example.com</td>
    </tr>
    <tr>
      <td>user2</td>
      <td>user2@example.com</td>
    </tr>
  </tbody>
</table>

CSS

Một số CSS cơ bản được sử dụng để căn chỉnh và làm nổi bật <caption>.

css
caption {
  caption-side: top;
  text-align: left;
  padding-bottom: 10px;
  font-weight: bold;
}

Kết quả

Tóm tắt kỹ thuật

Danh mục nội dung Không có.
Nội dung được phép Nội dung luồng.
Bỏ qua thẻ Thẻ đóng có thể bị bỏ qua nếu phần tử không được theo sau ngay bởi khoảng trắng ASCII hoặc comment.
Phần tử cha được phép Phần tử <table>, là con đầu tiên của nó.
Vai trò ARIA ngầm định caption
Vai trò ARIA được phép Không có role nào được phép
Giao diện DOM HTMLTableCaptionElement

Đặc tả

Specification
HTML
# the-caption-element

Tương thích trình duyệt

Xem thêm