HTMLTableCellElement: scope 属性

基线 广泛可用

此功能已完善,可在许多设备和浏览器版本上运行。自以下日期起,它已在各浏览器中提供 2015 年 7 月.

scope 属性是 HTMLTableCellElement 接口的一个属性,它指示 <th> 单元的范围。

可以使用 scope 属性配置表头单元格,使其应用于指定的行或列,或应用于当前行组中尚未设置范围的单元格(即,相同的祖先 <thead><tbody><tfoot> 元素)。如果未为 scope 指定值,则表头不会以这种方式直接与单元格关联。scope 的允许值为

注意:此属性在浏览器中没有视觉效果。它为辅助技术(如屏幕阅读器)添加了语义信息,以帮助它们以更连贯的方式呈现表格。

以下值之一

col

表头单元格应用于同一列(或列,如果也使用 colspan)中的后续单元格,直到列结束或列中的另一个 <th> 建立新的范围。

colgroup

表头单元格应用于当前列组中所有尚未应用范围的单元格。仅当单元格位于列组中时,才允许使用此值。

row

表头单元格应用于同一行(或行,如果也使用 rowspan)中的后续单元格,直到行结束或同一行中的另一个 <th> 建立新的范围。

rowgroup

表头单元格应用于当前行组中所有尚未应用范围的单元格。仅当单元格位于行组中时,才允许使用此值。

空字符串("")

表头单元格没有预定义的范围;用户代理将根据上下文线索建立范围。

示例

此示例为 tbody 的第一行的所有单元格编号添加标签。

HTML

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

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。