Sanitizer: setDataAttributes() Methode
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die setDataAttributes()-Methode der Sanitizer-Schnittstelle legt fest, ob alle data-* Attribute vom Sanitizer zugelassen werden, oder ob sie einzeln angegeben werden müssen.
Ist dies auf true gesetzt, werden Datenattribute automatisch zugelassen und Sie sollten sie nicht einzeln mit Sanitizer.allowAttribute() (oder Sanitizer.allowElement() für lokale Attribute) hinzufügen.
Beachten Sie, dass diese Methode nützlich für Erlaubniskonfigurationen ist, die viele data-* Attribute haben, die Sie zulassen möchten. Die Methode gibt false zurück, wenn sie mit Entfernungs-Konfigurationen verwendet wird, welche alle data-* Attribute einfach durch ihre Auslassung erlauben können.
Syntax
setDataAttributes(allow);
Parameter
allow-
true, wenn alledata-*Attribute zugelassen sind, undfalse, wenn sie explizit angegeben werden müssen.
Rückgabewert
true, wenn die Operation die Konfiguration geändert hat, und false, wenn die Konfiguration bereits dataAttributes auf den angegebenen Wert gesetzt hat oder dataAttributes nicht auf true gesetzt werden können, weil dieser Sanitizer eine Entfernungs-Konfiguration hat.
Beispiele
Grundlegende Verwendung
Der unten stehende Code zeigt die grundlegende Verwendung der setDataAttributes()-Methode.
// Create sanitizer (in this case the default)
const sanitizer = new Sanitizer();
// Allow all data-* attributes
sanitizer.setDataAttributes(true);
// data-* attributes are allowed by adding them
// to the attributes array
sanitizer.setDataAttributes(false);
Spezifikationen
| Specification |
|---|
| HTML Sanitizer API # dom-sanitizer-setdataattributes |