ProcessingInstruction: setAttribute() Methode
Die setAttribute()-Methode des ProcessingInstruction Interfaces setzt den Wert eines Attributs auf 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 festgelegt werden soll.
Das Format des qualifizierten Namens ist
prefix:localNameoderlocalName, wobei die Teile wie folgt definiert sind:prefixOptional-
Ein "kurzer Alias" für den Namespace, wie er von der
Attr.prefixEigenschaft zurückgegeben wird. localName-
Der lokale Name des Attributs, wie er 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 konventionell
valueauf 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
prefixoderlocalNameungültig ist:- Der
prefixmuss mindestens ein Zeichen enthalten und darf kein ASCII-Leerzeichen,NULL,/, oder>(U+0000, U+002F, oder U+003E, jeweils) enthalten. - Der
localNamemuss mindestens ein Zeichen lang sein und darf kein ASCII-Leerzeichen,NULL,/,=oder>(U+0000, U+002F, U+003D, oder U+003E, jeweils) enthalten.
- Der
Beschreibung
setAttribute() setzt den Wert eines Attributs auf 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, festzulegen, 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 angesehen.
Konventionell 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 des Aktivierens 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 Nutzung
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 |