caption

Роль для видимой подписи к таблице, сетке и автономного графического содержимого с ролью figure.

Время чтения: меньше 5 мин

Это незавершённая статья. Вы можете помочь её закончить! Почитайте о том, как контрибьютить в Доку.

Кратко

Скопировано

Роль структуры документа из WAI-ARIA для видимой подписи к таблице, обычной или древовидной сетке и автономного графического содержимого.

В HTML эта роль есть у <caption> по умолчанию.

Как пишется

Скопировано

Задайте тегу role="caption", лучше всего <div> или <span>. При этом для <table> лучше использовать в первую очередь <caption>, а для <figure><figcaption>.

Элементы с caption могут быть описывать только некоторые элементы и ARIA-роли:

Элемент caption обязательно нужно вложить внутрь контейнеров с ролями figure, table, grid и treegrid. У table, grid и treegrid описание должно быть первым дочерним элементом, а у figure — первым или последним.

Чтобы связать подпись с ролью caption и элемент, к которому она относится, задайте aria-labelledby родительскому элементу и id с таким же значением для caption. Если хотите добавить ещё расширенное описание, его тоже можно вложить внутрь caption и связать с основным элементом при помощи aria-describedby.

Для элементов с ролью caption можно использовать все глобальные ARIA-атрибуты.