ProcessingInstruction: toggleAttribute() Methode
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Die toggleAttribute() Methode der ProcessingInstruction Schnittstelle schaltet ein boolesches Attribut an der angegebenen Verarbeitungsvorschrift 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.
forceOptional-
Ein boolescher Wert, der die folgenden Auswirkungen hat:
- Wenn er überhaupt 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 ungültig sind. Dernamemuss mindestens ein Zeichen enthalten und darf keine ASCII-Leerzeichen,NULL,/,=oder>(U+0000, U+002F, U+003D oder U+003E) enthalten.
Beispiele
Grundlegende Nutzung
const pi = document.createProcessingInstruction("start", 'name=""');
pi.toggleAttribute("name");
pi.toggleAttribute("surname");
console.log(pi);
// logs:
// <?start surname=""?>
Spezifikationen
| Spezifikation |
|---|
| DOM # dom-processinginstruction-toggleattribute |