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 des Sanitizer-Interfaces legt ein Attribut fest, das beim Einsatz des Sanitizers von allen Elementen entfernt werden soll.
Die Methode kann entweder mit einer Allow-Konfiguration oder einer Remove-Konfiguration verwendet werden.
Wird sie mit einer Remove-Konfiguration verwendet, wird das angegebene Attribut zum removeAttributes-Array hinzugefügt.
Wird sie mit einer Allow-Konfiguration verwendet, wird das Attribut aus dem attributes-Array entfernt (sofern vorhanden).
Beachten Sie, dass Sie zur gezielten Erlaubnis/Verweigerung von Attributen bei bestimmten Elementen Sanitizer.allowElement() verwenden können.
Syntax
removeAttribute(attribute)
Parameter
attribute-
Ein String, der den Namen des Attributs angibt, das global für Elemente verweigert werden soll, oder ein Objekt mit den folgenden Eigenschaften:
name-
Ein String, der den Namen des Attributs enthält.
namespaceOptional-
Ein String, der den Namespace des Attributs enthält, der standardmäßig auf
nullgesetzt ist.
Rückgabewert
true, wenn die Operation die Konfiguration geändert hat, um das Attribut zu verweigern, und false, wenn das Attribut bereits verweigert war.
Beachten Sie, dass false zurückgegeben werden kann, wenn die interne Konfiguration:
- ein
removeAttributes-Array definiert, das das angegebene Attribut bereits enthält (und somit bereits gefiltert ist) - stattdessen ein
attributes-Array definiert, das das Attribut bereits ausschließt (und somit bereits verweigert ist)
Beispiele
>Anleitung: Bestimmte Attribute verweigern
Dieses Beispiel zeigt, wie removeAttribute() verwendet wird, um festzulegen, dass ein Attribut von Elementen entfernt werden soll.
JavaScript
Der Code erstellt zunächst ein neues Sanitizer-Objekt, das anfänglich keine Attribute oder Elemente spezifiziert.
Dann rufen wir 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 jetzt zur removeAttributes-Liste hinzugefügt sind (diese Attribute werden entfernt, wenn sie beim Einsatz des Sanitizers auf Elementen vorhanden sind).
Spezifikationen
| Specification |
|---|
| HTML Sanitizer API> # dom-sanitizer-removeattribute> |