ARIA:aria-pressed 属性
aria-pressed
属性用于指示切换按钮当前的“按下”状态。
描述
向具有 button
角色的元素添加 aria-pressed
会将该按钮转换为一个切换按钮。aria-pressed
属性仅对切换按钮有意义。它表示按钮当前的“按下”状态。
该值为“三态”,意味着它可以被设置为 true
、false
、mixed
或 undefined
。对于 aria-pressed
,与其他大多数三态值类型一样,默认值为 undefined
。
切换按钮需要完整的按下-释放周期才能更改其值。按下并释放一次将其值更改为 true
。如果再次按下并释放,则值将变回 false
。
值为 mixed
表示由该按钮控制的多个项目的状态不尽相同。
当状态发生变化时,不要更改切换按钮的标签内容。如果按钮标签显示“暂停”,在按下时不要将其更改为“播放”。在此示例中,当按下状态为 true 时,标签保持为“暂停”,因此屏幕阅读器会读出类似“暂停切换按钮,已按下”的内容。
<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 |