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 |