Element: ariaPressed プロパティ
Baseline 2023
Newly available
Since October 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
ariaPressed
は Element
インターフェイスのプロパティで、トグルボタンの現在の押下状態を示す aria-pressed
属性の値を反映します。
値
以下のいずれかの値を持つ文字列です。
"true"
-
この要素は押下状態にあります。
"false"
-
この要素は押されることに対応していますが、現在は押下状態にありません。
"mixed"
-
3 状態トグルボタンの混在モード値を示します。
"undefined"
-
この要素は押下状態に対応していません。
例
この例では、saveChanges
という ID を持つ要素の 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"
仕様書
Specification |
---|
Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariapressed |
ブラウザーの互換性
BCD tables only load in the browser