aria-level

层次结构级别出现在标题、树、嵌套网格、嵌套选项卡列表等中。如果 DOM 祖先关系不能准确地表示级别，则应使用 aria-level 属性来定义其层次结构结构中的元素的层次结构级别。级别随着深度的增加而增加。aria-level 的值为大于或等于 1 的整数。

在文档结构中的标题方面，您可以拥有第一级标题、第二级标题、第三级标题等。在树中，您有根元素、其子元素、子元素的子元素（或孙元素）等等。

aria-level 属性向辅助技术公开层次结构，以便可以将其传达给用户。与所有 ARIA 属性一样，它对用户代理没有影响，因此对用户代理确定文档结构也没有影响。

如果 DOM 祖先关系准确地表示级别，则用户代理可以根据文档结构计算项目的级别，这使得 aria-level 不仅冗余，而且存在创建错误信息的风险。aria-level 实际上只应在无法根据文档结构计算级别时，用于提供级别的明确指示。测试以查看是否需要此属性。如果用户代理可以计算级别，最好省略 aria-level 属性。

aria-level 属性是 heading 角色的必需属性，它指示辅助技术应将元素视为标题。<div role="heading" aria-level="1"> 将 <div> 定义为页面上的主标题。使用 aria-level="2" 定义的二级标题将是第一个子部分，三级是该子部分的子部分，依此类推。

<div role="heading" aria-level="3">Heading for this sub section</div>

最好使用 h1 到 h6 元素。

在 treegrid 的情况下，aria-level 在具有 row 角色的元素上受支持，而不是在具有 gridcell 角色的元素上受支持。行充当网格垂直方向中的叶节点。网格单元格是每行水平方向中的叶节点。Aria-level 不支持行中的单元格。因此，在树状网格中，aria-level 属性应用于具有 row 角色的元素。

如果由于动态加载（当用户在树中移动焦点或滚动树时）导致 DOM 中不存在完整的可用节点集，则每个节点都包含 aria-level、aria-setsize 和 aria-posinset。

<integer>

大于或等于 1 的整数

Element.ariaLevel

ariaLevel 属性（Element 接口的一部分）反映了 aria-level 属性的值。

ElementInternals.ariaLevel

ariaLevel 属性（ElementInternals 接口的一部分）反映了 aria-level 属性的值。

用于角色

• associationlistitemkey
• comment
• heading
• row

• <h1> 到 <h6>：HTML 节标题元素 (h1、h2、h3、h4、h5 和 h6)