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

另見