ProcessingInstruction: setAttribute() 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 setAttribute() Methode der ProcessingInstruction Schnittstelle setzt den Wert eines Attributs in der Verarbeitungsanweisung.
Wenn das Attribut bereits existiert, wird der Wert aktualisiert; andernfalls wird ein neues Attribut mit dem angegebenen Namen und Wert hinzugefügt.
Syntax
setAttribute(qualifiedName, value)
Parameter
qualifiedName-
Ein String, der den qualifizierten Namen des Attributs enthält, dessen Wert gesetzt werden soll.
Das Format des qualifizierten Namens ist
prefix:localNameoderlocalName, wobei die Teile wie folgt definiert sind:prefixOptional-
Ein "kurzes Alias" für den Namensraum, wie es von der
Attr.prefixEigenschaft zurückgegeben wird. localName-
Der lokale Name des Attributs, wie es von der
Attr.localNameEigenschaft zurückgegeben wird.
value-
Ein String, der den Wert enthält, der dem Attribut zugewiesen werden soll.
Angegebene Nicht-String-Werte werden automatisch in Strings konvertiert.
Für boolesche Attribute sollten Sie den
valuekonventionell auf den leeren String ("") oder den Namen des Attributs setzen, ohne führende oder nachfolgende Leerzeichen.
Rückgabewert
Keiner (undefined).
Ausnahmen
InvalidCharacterErrorDOMException-
Wird ausgelöst, wenn entweder das
prefixoderlocalNamenicht gültig ist:- Das
prefixmuss mindestens ein Zeichen haben und darf keine ASCII-Leerzeichen,NULL,/, oder>(U+0000, U+002F, oder U+003E, jeweils) enthalten. - Das
localNamemuss mindestens ein Zeichen haben und darf keine ASCII-Leerzeichen,NULL,/,=oder>(U+0000, U+002F, U+003D, oder U+003E, jeweils) enthalten.
- Das
Beschreibung
setAttribute() setzt den Wert eines Attributs in der angegebenen Verarbeitungsanweisung.
Wenn das Attribut bereits existiert, wird der Wert aktualisiert; andernfalls wird ein neues Attribut mit dem angegebenen Namen und Wert hinzugefügt.
Um den Wert eines booleschen Attributs, wie disabled, zu setzen, können Sie einen beliebigen Wert angeben.
Es spielt keine Rolle, welchen Wert Sie verwenden; wenn das Attribut vorhanden ist, wird sein Wert als true betrachtet.
Nach Konvention aktivieren wir boolesche Attribute, indem wir ihren Wert entweder auf den Namen des Attributs oder den leeren String ("") setzen.
Das Fehlen eines booleschen Attributs bedeutet, dass sein Wert false ist; Sie müssen ProcessingInstruction.removeAttribute() aufrufen, um die Wirkung der Aktivierung eines booleschen Attributs "rückgängig zu machen".
Um den aktuellen Wert eines Attributs zu erhalten, verwenden Sie getAttribute(); um ein Attribut zu entfernen, rufen Sie removeAttribute() auf.
Beispiele
Grundlegende Verwendung
const pi = document.createProcessingInstruction("start", 'name="placeholder"');
pi.setAttribute("name", "new text");
console.log(pi);
// logs:
// <?start name="new text"?>
Spezifikationen
| Spezifikation |
|---|
| DOM # dom-processinginstruction-setattribute |