Element: toggleAttribute()-Methode
Die toggleAttribute()
-Methode der Element
Schnittstelle wechselt ein boolesches Attribut (entfernt es, wenn es vorhanden ist und fügt es hinzu, wenn es nicht vorhanden ist) auf dem gegebenen Element.
Syntax
toggleAttribute(name)
toggleAttribute(name, force)
Parameter
name
-
Ein String, der den Namen des Attributs angibt, das umgeschaltet werden soll. Der Attributname wird automatisch in Kleinbuchstaben umgewandelt, wenn
toggleAttribute()
auf einem HTML-Element in einem HTML-Dokument aufgerufen wird. force
Optional-
Ein boolescher Wert, der die folgenden Auswirkungen hat:
- Wenn überhaupt nicht angegeben, "schaltet" die
toggleAttribute
-Methode das Attribut mit dem Namenname
um — entfernt es, wenn es vorhanden ist, oder fügt es hinzu, wenn es nicht vorhanden ist - Wenn true, fügt die
toggleAttribute
-Methode ein Attribut mit dem Namenname
hinzu - Wenn false, entfernt die
toggleAttribute
-Methode das Attribut mit dem Namenname
- Wenn überhaupt nicht angegeben, "schaltet" die
Rückgabewert
true
, wenn das Attribut name
schließlich vorhanden ist, andernfalls false
.
Ausnahmen
InvalidCharacterError
DOMException
-
Der angegebene Attributname
name
enthält ein oder mehrere Zeichen, die in Attributnamen ungültig sind.
Beispiele
Im folgenden Beispiel wird toggleAttribute()
verwendet, um das disabled
-Attribut eines <input>
zu wechseln.
HTML
<input value="text" /> <button>toggleAttribute("disabled")</button>
JavaScript
const button = document.querySelector("button");
const input = document.querySelector("input");
button.addEventListener("click", () => {
input.toggleAttribute("disabled");
});
Ergebnis
Spezifikationen
Specification |
---|
DOM Standard # ref-for-dom-element-toggleattribute① |
Browser-Kompatibilität
BCD tables only load in the browser