Element: toggleAttribute()-Methode
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Oktober 2018.
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. forceOptional-
Ein boolescher Wert, der die folgenden Auswirkungen hat:
- Wenn überhaupt nicht angegeben, "schaltet" die
toggleAttribute-Methode das Attribut mit dem Namennameum — 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 Namennamehinzu - 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
InvalidCharacterErrorDOMException-
Der angegebene Attributname
nameenthä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 # ref-for-dom-element-toggleattribute① |
Browser-Kompatibilität
Loading…