<caption> HTML-элемент подписи таблицы
Базовый уровень Широко доступно *
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и в разных версиях браузеров. Она доступна во всех браузерах с июля 2015 года.
* Некоторые части этой функции могут поддерживаться в разной степени.
Элемент <caption> HTML задаёт подпись (или заголовок) таблицы, предоставляя ей доступное имя или доступное описание.
Попробуйте
<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;
}
Атрибуты
Этот элемент включает глобальные атрибуты.
Устаревшие атрибуты
Следующие атрибуты устарели и не должны использоваться. Они описаны ниже для справки при обновлении существующего кода и только для исторического интереса.
align-
Указывает, с какой стороны таблицы следует отображать подпись. Возможные перечисляемые значения:
left,top,rightилиbottom. Вместо этого используйте свойства CSScaption-sideиtext-align, поскольку этот атрибут устарел.
Примечания по использованию
- Если элемент
<caption>используется, он должен быть первым дочерним элементом своего родительского элемента<table>. - Если элемент
<table>вложен в<figure>и является единственным содержимым рисунка, его следует снабдить подписью с помощью<figcaption>для<figure>, а не использовать<caption>, вложенный в<table>. - Любой
background-color, применённый к таблице, не будет применён к её подписи. Если вы хотите, чтобы оба элемента имели одинаковый цвет фона, добавьтеbackground-colorтакже к элементу<caption>.
Пример
Полный пример таблицы, знакомящий с общими стандартами и рекомендациями, см. в разделе <table>.
Таблица с подписью
В этом примере показана простая таблица с подписью, описывающей представленные данные.
Такой «заголовок» полезен для пользователей, которые быстро просматривают страницу, и особенно удобен для пользователей с нарушениями зрения: он позволяет им быстро определить актуальность таблицы, не заставляя программу чтения с экрана зачитывать содержимое множества ячеек, чтобы понять, о чём таблица.
HTML
Элемент <caption> используется как первый дочерний элемент <table>. Его текст, похожий на заголовок, описывает данные таблицы. После <caption> с помощью элементов <tr>, <th> и <td> создаются три строки, первая из которых является строкой заголовков, с двумя столбцами.
<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
Для выравнивания и выделения <caption> используются базовые стили CSS.
caption {
caption-side: top;
text-align: left;
padding-bottom: 10px;
font-weight: bold;
}
Результат
Техническая сводка
| Категории содержимого | Нет. |
|---|---|
| Допустимое содержимое | Потоковое содержимое. |
| Пропуск тегов | Закрывающий тег можно опустить, если сразу за элементом не следует пробел ASCII или комментарий. |
| Допустимые родители | Элемент <table> в качестве первого потомка. |
| Неявная роль ARIA | caption |
| Допустимые роли ARIA | Роль role не допускается |
| Интерфейс DOM | HTMLTableCaptionElement |
Спецификации
| Спецификация |
|---|
| HTML> # the-caption-element> |
Совместимость с браузерами
| Настольные компьютеры | Мобильные устройства | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на IOS | Samsung Internet | WebView Android | WebView на iOS | |
caption |
1 | 12 | 1 | 15 | ≤4 | 18 | 4 | 14 | ≤3.2 | 1.0 | 4.4 | ≤3.2 |
align |
1 | 12 | 1 | 15 | ≤4 | 18 | 4 | 14 | ≤3.2 | 1.0 | 4.4 | ≤3.2 |
См. также
- Узнайте: основы таблиц HTML
-
<col>,<colgroup>,<table>,<tbody>,<td>,<tfoot>,<th>,<thead>,<tr>: другие элементы, связанные с таблицами -
caption-side: свойство CSS для позиционирования<caption>относительно родительского элемента<table> -
text-align: свойство CSS для горизонтального выравнивания текстового содержимого элемента<caption>
© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/caption