Element: toggleAttribute() Methode

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Oktober 2018 browserübergreifend verfügbar.

Die toggleAttribute() Methode der Element Schnittstelle schaltet ein Boolean-Attribut des angegebenen Elements um, indem es entfernt wird, wenn es vorhanden ist, und hinzugefügt wird, wenn es nicht vorhanden ist.

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 ein HTML-Element in einem HTML-Dokument angewendet wird.

force Optional

Ein booleanes Wert, der folgende Auswirkungen hat:

Wenn er überhaupt nicht angegeben wird, "schaltet" die toggleAttribute Methode das Attribut mit dem Namen name um — es wird entfernt, wenn es vorhanden ist, oder hinzugefügt, wenn es nicht vorhanden ist
Wenn true, fügt die toggleAttribute Methode ein Attribut mit dem Namen name hinzu
Wenn false, entfernt die toggleAttribute Methode das Attribut mit dem Namen name

Rückgabewert

true, wenn das Attribut name letztendlich vorhanden ist, ansonsten false.

Ausnahmen

InvalidCharacterError DOMException: Der angegebene Attributname name enthält ein oder mehrere Zeichen, die in Attributnamen nicht gültig sind. Der name muss mindestens ein Zeichen enthalten und darf keine ASCII-Leerzeichen, NULL, /, = oder > (U+0000, U+002F, U+003D oder U+003E) enthalten.

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

JavaScript

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

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