JavaScript/DOM/Element/toggleAttribute

Aus SELFHTML-Wiki
< JavaScript‎ | DOM‎ | Element
Wechseln zu: Navigation, Suche

Die Methode Element.toggleAttribute schaltet den Wert eines booleschen Attributs (z.B. hidden oder open) um. Das bedeutet: Wenn es am Element vorhanden ist, wird es entfernt, und wenn es fehlt, wird es erzeugt.

Syntax

element.toggleAttribute(qualifizierterName [, zwang]);

  • element: Element, dessen Attribut umgeschaltet werden soll
  • qualifizierterName: Qualifizierter Name des Attributs, das hinzugefügt oder geändert werden soll.
  • zwang: Optionaler boolescher Wert, um zu erzwingen, dass das Attribut gesetzt (true) oder entfernt (false) werden soll.

Die Methode gibt true zurück, wenn das Attribut nach ihrer Ausführung gesetzt ist, andernfalls false

Ein ungültiger Name wirft einen InvalidCharacterError.

Wenn das Attribut angelegt wird, so wird als Wert der Leerstring eingetragen.