ARIA:aria-pressed 属性

aria-pressed 属性用于指示切换按钮当前的“按下”状态。

描述

向具有 button 角色的元素添加 aria-pressed 会将该按钮转换为一个切换按钮。aria-pressed 属性仅对切换按钮有意义。它表示按钮当前的“按下”状态。

该值为“三态”,意味着它可以被设置为 truefalsemixedundefined。对于 aria-pressed,与其他大多数三态值类型一样,默认值为 undefined

切换按钮需要完整的按下-释放周期才能更改其值。按下并释放一次将其值更改为 true。如果再次按下并释放,则值将变回 false

值为 mixed 表示由该按钮控制的多个项目的状态不尽相同。

当状态发生变化时,不要更改切换按钮的标签内容。如果按钮标签显示“暂停”,在按下时不要将其更改为“播放”。在此示例中,当按下状态为 true 时,标签保持为“暂停”,因此屏幕阅读器会读出类似“暂停切换按钮,已按下”的内容。

html
<button aria-pressed="false">Pause</button>

如果您希望标签在“已暂停”和“播放”之间切换,请不要使用 aria-pressed

ARIA 使用的第一条规则是:“如果可以使用具有您所需语义和行为的本机功能,而不是重新利用元素并添加 ARIA 角色、状态或属性使其可访问,则应这样做。” 如果我们使用具有 <button> 的原生 HTML 语义,我们可以切换标签而不是切换按下状态,从而无需使用 aria-pressed 属性。

false

该按钮支持按下,但当前未按下。

mixed

指示三态切换按钮的混合模式值。

true

该按钮已按下。

undefined(默认值)

元素不支持被按下。

相关接口

Element.ariaPressed

Element 接口的一部分 ariaPressed 属性反映了 aria-pressed 属性的值。

ElementInternals.ariaPressed

ElementInternals 接口的一部分 ariaPressed 属性反映了 aria-pressed 属性的值。

相关角色

用于角色

规范

规范
无障碍富互联网应用程序 (WAI-ARIA)
# aria-pressed

另见