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 |