<caption>: Элемент заголовка таблицы
Базовая Широко доступная
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.
Элемент <caption> HTML определяет заголовок (или название) таблицы, предоставляя таблице доступное описание.
Попробовать
Атрибуты
Этот элемент включает глобальные атрибуты.
Устаревшие атрибуты
Следующие атрибуты устарели и не должны использоваться. Они документированы ниже для справки при обновлении существующего кода и для исторической справки.
-
alignУстаревший -
Указывает, с какой стороны таблицы должен отображаться заголовок. Возможные перечислимые значения:
left,top,right, илиbottom. Используйте CSS-свойстваcaption-sideиtext-alignвместо этого атрибута, так как он устарел.
Примечания по использованию
- Если включён, элемент
<caption>должен быть первым дочерним элементом своего родительского элемента<table>. - Когда элемент
<table>вложен в элемент<figure>в качестве единственного содержимого, он должен иметь заголовок с помощью элемента<figcaption>для<figure>, а не в качестве элемента<caption>внутри<table>. - Любой
background-color, применённый к таблице, не будет применён к её заголовку. Добавьтеbackground-colorк элементу<caption>также, если вам нужен тот же цвет фона для обоих.
Пример
См. <table> для примера полной таблицы, демонстрирующего общие стандарты и рекомендации по наилучшей практике.
Таблица с заголовком
Этот пример демонстрирует простую таблицу, включающую заголовок, описывающий представленные данные.
Такой "заголовок" полезен для пользователей, быстро просматривающих страницу, и особенно полезен для пользователей с нарушениями зрения, позволяя им быстро определить релевантность таблицы, не заставляя экранного читателя читать содержимое множества ячеек, чтобы узнать, о чём таблица.
HTML
Элемент <caption> используется в качестве первого дочернего элемента <table>, с текстовым содержимым, подобным заголовку, для описания данных таблицы. Три строки, первая из которых — строка заголовка, с двумя столбцами, создаются с помощью элементов <tr>, <th> и <td> после элемента <caption>.
<table> <caption> User login email addresses </caption> <tr> <th>Login</th> <th>Email</th> </tr> <tr> <td>user1</td> <td>user1@example.com</td> </tr> <tr> <td>user2</td> <td>user2@example.com</td> </tr> </table>
CSS
Используется несколько базовых CSS-правил для выравнивания и выделения <caption>.
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 | |
caption |
1 | 12 | 1 | 15 | ≤4 | 18 | 4 | 14 | ≤3.2 | 1.0 | 4.4 |
align |
1 | 12 | 1 | 15 | ≤4 | 18 | 4 | 14 | ≤3.2 | 1.0 | 4.4 |
См. также
- Учебник: HTML-таблицы
-
<col>,<colgroup>,<table>,<tbody>,<td>,<tfoot>,<th>,<thead>,<tr>: Другие элементы, относящиеся к таблицам -
caption-side: CSS-свойство для позиционирования<caption>относительно его родительского элемента<table> -
text-align: CSS-свойство для горизонтального выравнивания текстового содержимого элемента<caption>
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/HTML/Element/caption