Sanitizer: removeAttribute() Methode
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die removeAttribute() Methode der Sanitizer Schnittstelle setzt ein Attribut, das von allen Elementen entfernt werden soll, wenn der Sanitizer verwendet wird.
Die Methode kann sowohl mit einer Allow-Konfiguration als auch mit einer Remove-Konfiguration verwendet werden. Bei Verwendung mit einer Remove-Konfiguration wird das angegebene Attribut dem removeAttributes Array hinzugefügt. Bei Verwendung mit einer Allow-Konfiguration wird das Attribut aus dem attributes Array entfernt (falls vorhanden).
Beachten Sie, dass um Attribute nur auf bestimmten Elementen zu erlauben oder zu verbieten, Sie Sanitizer.allowElement() verwenden sollten.
Syntax
removeAttribute(attribute)
Parameter
attribute-
Ein String, der den Namen des Attributs angibt, das global auf Elementen verboten werden soll, oder ein Objekt mit den folgenden Eigenschaften:
name-
Ein String, der den Namen des Attributs enthält.
namespaceOptional-
Ein String, der den Namensraum des Attributs enthält, standardmäßig
null.
Rückgabewert
true, wenn die Operation die Konfiguration geändert hat, um das Attribut zu verbieten, und false, wenn das Attribut bereits verboten war.
Beachten Sie, dass false zurückgegeben werden kann, wenn die interne Konfiguration:
- ein
removeAttributesArray definiert, das bereits das angegebene Attribut enthält (und daher bereits gefiltert ist) - stattdessen ein
attributesArray definiert, das das Attribut bereits auslässt (und daher bereits verboten ist)
Beispiele
>Anleitung zur Unzulässigkeit spezifischer Attribute
Dieses Beispiel zeigt, wie removeAttribute() verwendet wird, um festzulegen, dass ein Attribut von den Elementen entfernt werden soll.
JavaScript
Der Code erstellt zunächst ein neues Sanitizer-Objekt, das anfangs keine Attribute oder Elemente spezifiziert. Wir rufen dann removeAttribute() mit den Attributen title und mathcolor auf.
// Create sanitizer that allows
const sanitizer = new Sanitizer({
removeAttributes: [],
});
// Remove the title attribute
sanitizer.removeAttribute("title");
// Remove the mathcolor attribute
sanitizer.removeAttribute("mathcolor");
// Log the sanitizer configuration
let sanitizerConfig = sanitizer.get();
log(JSON.stringify(sanitizerConfig, null, 2));
Ergebnisse
Die endgültige Konfiguration wird unten protokolliert. Beachten Sie, wie beide Attribute nun zur removeAttributes Liste hinzugefügt wurden (diese Attribute werden entfernt, wenn der Sanitizer verwendet wird und sie auf Elementen vorhanden sind).
Spezifikationen
| Specification |
|---|
| HTML Sanitizer API> # dom-sanitizer-removeattribute> |