Element : propriété ariaPressed

Baseline Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis octobre 2023.

En savoir plus
Voir la compatibilité complète

La propriété ariaPressed de l'interface Element reflète la valeur de l'attribut aria-pressed, qui indique l'état actuel « pressé » des boutons bascule.

Note : Ici, il est possible d'utiliser un élément HTML <input> avec type="button" ou un <button>, car ils ont une sémantique intégrée et ne nécessitent pas d'attributs ARIA.

Valeur

Une chaîne de caractères avec l'une des valeurs suivantes :

"true": L'élément est pressé.
"false": L'élément peut être pressé mais ne l'est pas actuellement.
"mixed": Indique une valeur en mode mixte pour un bouton bascule à trois états.
"undefined": L'élément ne peut pas être pressé.

Dans cet exemple, l'attribut aria-pressed de l'élément avec un ID de sauvegarderChangements a été défini sur "false", indiquant que cette entrée n'est actuellement pas pressée. En utilisant ariaPressed, nous mettons à jour la valeur à "true".

html

<div
  id="sauvegarderChangements"
  tabindex="0"
  role="button"
  aria-pressed="false">
  Enregistrer
</div>

let el = document.getElementById("sauvegarderChangements");
console.log(el.ariaPressed); // "false"
el.ariaPressed = "true";
console.log(el.ariaPressed); // "true"