aria-pressed
aria-pressed
属性指示切换按钮的当前“按下”状态。
描述
将 aria-pressed
添加到具有 button
角色的元素会将按钮变成切换按钮。aria-pressed
属性仅与切换按钮相关。它表示按钮的当前“按下”状态。
该值是“三态”值,这意味着该值可以设置为 true
、false
、mixed
或 undefined
值。就 aria-pressed
而言,与大多数三态值类型一样,默认值为 undefined
。
切换按钮需要完整的按下和释放循环才能更改其值。按下并释放一次会将值更改为 true
。如果再次按下并释放,值会更改回 false
。
mixed
值表示按钮控制的多个项目的各个值并不都具有相同的值。
不要在状态发生变化时更改切换按钮标签的内容。如果按钮标签显示为“暂停”,则不要在按下时将其更改为“播放”。在此示例中,当按下状态为 true 时,标签仍然显示为“暂停”,因此屏幕阅读器会说类似“暂停切换按钮已按下”的内容。
html
<button aria-pressed="false">Pause</button>
如果希望标签在“已暂停”和“播放”之间切换,请不要使用 aria-pressed
。
ARIA 使用的首要规则是“如果您可以使用具有所需语义和行为的原生功能,而无需重新利用元素并添加 ARIA 角色、状态或属性来使其无障碍,那么就请使用该功能。”如果我们使用原生 HTML 语义和 <button>
,我们可以切换标签而不是切换按下状态,从而无需使用 aria-pressed
属性。
值
关联接口
Element.ariaPressed
-
ariaPressed
属性(Element
接口的一部分)反映了aria-pressed
属性的值。 ElementInternals.ariaPressed
-
ariaPressed
属性(ElementInternals
接口的一部分)反映了aria-pressed
属性的值。
关联角色
用于角色
规范
规范 |
---|
无障碍富互联网应用程序 (WAI-ARIA) # aria-pressed |