ProcessingInstruction: toggleAttribute() Methode
Die toggleAttribute() Methode der ProcessingInstruction Schnittstelle schaltet ein boolesches Attribut auf der angegebenen Verarbeitungshinweisung um, indem es entfernt wird, wenn es vorhanden ist, und hinzugefügt wird, wenn es nicht vorhanden ist.
Syntax
js
toggleAttribute(name)
toggleAttribute(name, force)
Parameter
name-
Ein String, der den Namen des umzusetzenden Attributs angibt.
forceOptional-
Ein boolescher Wert, der die folgenden Auswirkungen hat:
- Wenn er nicht angegeben wird, wird das Attribut entfernt, wenn es vorhanden ist, und hinzugefügt, wenn es nicht vorhanden ist.
- Wenn auf
truegesetzt, wird das Attribut hinzugefügt, wenn es nicht vorhanden ist, aber es wird nicht entfernt, wenn es vorhanden ist. - Wenn auf
falsegesetzt, wird das Attribut entfernt, wenn es vorhanden ist, aber es wird nicht hinzugefügt, wenn es nicht vorhanden ist.
Rückgabewert
true, wenn das Attribut nach Abschluss der toggleAttribute()-Operation vorhanden ist, und false, wenn nicht.
Ausnahmen
InvalidCharacterErrorDOMException-
Der angegebene Attributname
nameenthält ein oder mehrere Zeichen, die in Attributnamen nicht gültig sind. Dernamemuss mindestens ein Zeichen enthalten und darf keine ASCII-Leerzeichen,NULL,/,=oder>(U+0000, U+002F, U+003D oder U+003E, jeweils) enthalten.
Beispiele
Grundlegende Verwendung
js
const pi = document.createProcessingInstruction("start", 'name=""');
pi.toggleAttribute("name");
pi.toggleAttribute("surname");
console.log(pi);
// logs:
// <?start surname=""?>
Spezifikationen
| Spezifikation |
|---|
| DOM # dom-processinginstruction-toggleattribute |