aria-current

元素上的非空 aria-current 状态表示此元素代表容器或一组相关元素中的当前项。

描述

当您有一组相关元素时,例如面包屑中的几个链接或多步骤流程中的步骤,其中一个元素在组中与其他元素的样式不同,以指示有视力的用户这是其组中的当前元素,则应使用 aria-current 通知辅助技术用户通过样式指示的内容。

在面包屑列表中,当一组分页链接中的链接的样式指示用户当前位于该页面时,应在该链接上设置 aria-current="page"。在具有步骤指示器(例如多页调查或多步骤结账或注册流程)的多步骤流程中,当当前步骤图标在视觉上有所不同以表示它是当前步骤时,该图标的容器应具有 aria-current="step",以便无法“看到”视觉差异的辅助技术用户可以使用。

aria-current 属性将设置为非 false 值的元素指示为容器或一组相关元素中的当前项。仅使用 aria-current 将一组元素中的一个元素标记为当前。

aria-current 属性接受有限的列表,包括 pagesteplocationdatetimetruefalse。此枚举值列表中未包含的任何非空字符串值都将被视为已设置 aria-current="true",而不是默认的 false 值。如果属性不存在、为空字符串、存在但没有值或设置为 aria-current="false",则不会将其公开给用户。

当选择某些内容而不是当前内容时,例如tabtablist 中,使用aria-selected 指示当前显示的 tabpanel。

注意:不要使用 aria-current 作为aria-selected 的替代品,在gridcelloptionrowtab 中。

示例

“当前页面”的面包屑应在其上设置 aria-current="page"

html
<nav aria-label="Breadcrumb" class="breadcrumb">
  <ol>
    <li>
      <a href="../../../../../">Web technology for developers</a>
    </li>
    <li>
      <a href="../../../../">Accessibility</a>
    </li>
    <li>
      <a href="../../../">ARIA</a>
    </li>
    <li>
      <a href="../../">ARIA States and Properties</a>
    </li>
    <li>
      <a href="./" aria-current="page">ARIA: `aria-current` attribute</a>
    </li>
  </ol>
</nav>

如果表示面包屑中当前页面的元素不是链接,则 aria-current 是可选的。

page

表示一组页面中的当前页面,例如面包屑中当前文档的链接。

step

表示流程中的当前步骤,例如枚举的多步骤结账流程中的当前步骤。

location

表示环境或上下文中的当前位置,例如在流程图中视觉上突出显示为当前组件的图像。

date

表示日期集合中的当前日期,例如日历中的当前日期。

time

表示时间集中的当前时间,例如时间表中的当前时间。

true

表示集合中的当前项。

false(默认)

不表示集合中的当前项。

关联接口

Element.ariaCurrent

ariaCurrent 属性(Element 接口的一部分)反映 aria-current 属性的值。

ElementInternals.ariaCurrent

ariaCurrent 属性(ElementInternals 接口的一部分)反映 aria-current 属性的值。

关联角色

可在所有角色中使用;除了角色为gridcelloptionrowtab 的元素,在这种情况下应使用aria-selected

规范

规范
可访问的富互联网应用程序 (WAI-ARIA)
# aria-current

另请参阅