Element: ariaPressed 屬性

Baseline 2023
新推出

自 ⁨2023 年 10 月⁩ 以來,此功能已在最新裝置和瀏覽器版本中得到支援。此功能可能無法在舊裝置或瀏覽器上執行。

Element 介面的 ariaPressed 屬性反映了 aria-pressed 屬性的值,該屬性指示切換按鈕當前是否處於“按下”狀態。

注意: 儘可能使用帶有 type="button" 的 HTML <input> 元素或 <button> 元素,因為它們具有內建的語義,不需要 ARIA 屬性。

一個字串,其值可能為以下之一:

"true"

元素被按下。

"false"

元素支援被按下,但當前未被按下。

"mixed"

指示三態切換按鈕的混合模式值。

"undefined"

元素不支援被按下。

示例

在此示例中,ID 為 saveChanges 的元素上的 aria-pressed 屬性設定為“false”,表示此輸入當前未被按下。使用 ariaPressed,我們將值更新為“true”。

html
<div id="saveChanges" tabindex="0" role="button" aria-pressed="false">Save</div>
js
let el = document.getElementById("saveChanges");
console.log(el.ariaPressed); // "false"
el.ariaPressed = "true";
console.log(el.ariaPressed); // "true"

規範

規範
無障礙富網際網路應用程式 (WAI-ARIA)
# dom-ariamixin-ariapressed

瀏覽器相容性

另見