HTMLTableCellElement: свойство scope

Базовая линия Широко доступно

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

Свойство scope интерфейса HTMLTableCellElement указывает область действия ячейки <th>.

Ячейки заголовка могут быть настроены с помощью атрибута scope, чтобы применяться к определенному ряду или столбцу, или к еще не привязанным ячейкам в текущей группе строк (т.е. к одному и тому же предку элемента <thead>, <tbody> или <tfoot>). Если для scope не указано значение, то заголовок не будет связан напрямую с ячейками таким образом. Разрешенные значения для scope:

Примечание: Это свойство не оказывает визуального эффекта в браузерах. Оно добавляет семантическую информацию, помогающую средствам вспомогательной технологи, таким как экранные читалки, отобразить таблицу более последовательно.

Значение

Одно из следующих значений:

col: Ячейка заголовка применяется к последующим ячейкам в том же столбце (или столбцах, если также используется colspan), до конца столбца или другой <th>, устанавливающей новую область действия в столбце.
colgroup: Ячейка заголовка применяется ко всем ячейкам в текущей группе столбцов, которым еще не применена область действия. Это значение допускается только если ячейка находится в группе столбцов.
row: Ячейка заголовка применяется к последующим ячейкам в той же строке (или строках, если также используется rowspan), до конца строки или другой <th>, устанавливающей новую область действия в той же строке.
rowgroup: Ячейка заголовка применяется ко всем ячейкам в текущей группе строк, которым еще не применена область действия. Это значение допускается только если ячейка находится в группе строк.
Пустая строка (""): Ячейка заголовка не имеет предопределенной области действия; пользовательский агент установит область действия на основе контекстных подсказок.

Примеры

В этом примере добавляется метка ко всем номерам ячеек первой строки tbody.

HTML

<table>
  <caption>
    Tallest Dams
  </caption>
  <tr>
    <td></td>
    <th scope="col">Dam</th>
    <th scope="col">Country</th>
    <th scope="col">Height</th>
  </tr>
  <tr>
    <td>1.</td>
    <th scope="row">Jinping-I Dam</th>
    <td>China</td>
    <td>305 m</td>
  </tr>
  <tr>
    <td>2.</td>
    <th scope="row">Nurek Dam</th>
    <td>Tajikistan</td>
    <td>300 m</td>
  </tr>
  <tr>
    <td>3.</td>
    <th scope="row">Lianghekou Dam</th>
    <td>China</td>
    <td>295 m</td>
  </tr>
  <tr>
    <td>4.</td>
    <th scope="row">Xiowan Dam</th>
    <td>China</td>
    <td>292 m</td>
  </tr>
  <tr>
    <td>5.</td>
    <th scope="row">Balhetan Dam</th>
    <td>China</td>
    <td>289 m</td>
  </tr>
  <tr>
    <td>6.</td>
    <th scope="row">Xiluodu Dam</th>
    <td>China</td>
    <td>285.5 m</td>
  </tr>
  <tr>
    <td>7.</td>
    <th scope="row">Grande-Dixence Dam</th>
    <td>Switzerland</td>
    <td>285 m</td>
  </tr>
</table>

Результаты

Спецификации

Спецификация
HTML # dom-th-scope

Совместимость с браузерами

	Рабочие столы					Мобильные
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`scope`	1	12	1	≤12.1	3	18	4	≤12.1	1	1.0	4.4

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLTableCellElement/scope