aria-pressed

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

描述

aria-pressed 添加到具有 button 角色的元素会将按钮变成切换按钮。aria-pressed 属性仅与切换按钮相关。它表示按钮的当前“按下”状态。

该值是“三态”值,这意味着该值可以设置为 truefalsemixedundefined 值。就 aria-pressed 而言,与大多数三态值类型一样,默认值为 undefined

切换按钮需要完整的按下和释放循环才能更改其值。按下并释放一次会将值更改为 true。如果再次按下并释放,值会更改回 false

mixed 值表示按钮控制的多个项目的各个值并不都具有相同的值。

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

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

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

ARIA 使用的首要规则是“如果您可以使用具有所需语义和行为的原生功能,而无需重新利用元素并添加 ARIA 角色、状态或属性来使其无障碍,那么就请使用该功能。”如果我们使用原生 HTML 语义和 <button>,我们可以切换标签而不是切换按下状态,从而无需使用 aria-pressed 属性。

false

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

mixed

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

true

按钮已按下。

undefined(默认)

元素不支持按下。

关联接口

Element.ariaPressed

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

ElementInternals.ariaPressed

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

关联角色

用于角色

规范

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

另请参阅