Element : méthode toggleAttribute()

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 2018.

En savoir plus
Voir la compatibilité complète

La méthode toggleAttribute() de l'interface Element bascule un attribut booléen sur l'élément donné, le supprimant s'il est présent et l'ajoutant s'il n'est pas présent.

Une chaîne de caractères définissant le nom de l'attribut à basculer. Le nom de l'attribut est automatiquement converti en minuscules lorsque toggleAttribute() est appelé sur un élément HTML dans un document HTML.

force Facultatif

Une valeur booléenne qui a les effets suivants :

si elle n'est pas définie du tout, la méthode toggleAttribute « bascule » l'attribut nommé name — le supprimant s'il est présent, ou l'ajoutant s'il n'est pas présent
si elle vaut true, la méthode toggleAttribute ajoute un attribut nommé name
si elle vaut false, la méthode toggleAttribute supprime l'attribut nommé name

Valeur de retour

true si l'attribut name est finalement présent, et false sinon.

Exceptions

InvalidCharacterError DOMException: L'attribut défini name contient un ou plusieurs caractères qui ne sont pas valides dans les noms d'attributs. Le name doit comporter au moins un caractère et ne peut pas contenir d'espaces ASCII, NULL, /, = ou > (U+0000, U+002F, U+003D ou U+003E, respectivement).

<input value="texte" /> <button>toggleAttribute("disabled")</button>

JavaScript

const button = document.querySelector("button");
const champ = document.querySelector("input");

button.addEventListener("click", () => {
  champ.toggleAttribute("disabled");
});