База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / HTML

HTML елемент: caption

Елементът за надпис на таблица дава заглавие или кратко обяснение и помага да се разбере обхватът на данните преди клетките.

Версия: WHATWG HTML Living Standard; index snapshot date recorded separately

Синтаксис

<table><caption>Table title</caption>…</table>

Когато caption присъства, трябва да е първото пряко дете на table, което е елемент; текстови или коментарни възли могат да го предхождат, а таблицата може да има само един.

В DOM table.caption сочи свързания надпис; createCaption() го създава или връща съществуващия, а deleteCaption() премахва само този елемент.

Надписът не заменя заглавните клетки: th със scope или връзка headers–id продължава да описва отношенията в мрежата.

CSS caption-side може да промени визуалната позиция. Примерът чете firstElementChild, колекциите rows и tBodies и броя заглавни клетки.

Примери

<!doctype html>
<meta charset="utf-8">
<table id="sales">
  <caption>Quarterly sales</caption>
  <thead><tr><th scope="col">Quarter</th><th scope="col">Units</th></tr></thead>
  <tbody><tr><th scope="row">Q1</th><td>42</td></tr></tbody>
</table>
<output id="result"></output>
<script>
const sales = document.querySelector("#sales");
document.querySelector("#result").textContent = `caption=${sales.caption.textContent}; first=${sales.firstElementChild.tagName}; rows=${sales.rows.length}; bodies=${sales.tBodies.length}; headers=${sales.querySelectorAll("th").length}`;
</script>

Резултат

caption=Quarterly sales; first=CAPTION; rows=2; bodies=1; headers=3

Резултатът потвърждава един надпис като първи елемент и структура от два реда; не симулира обявяване от екранен четец.

Източници