Sanitizer: setDataAttributes()-Methode
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Die setDataAttributes()-Methode der Sanitizer-Schnittstelle legt fest, ob alle data-* Attribute vom Sanitizer zugelassen werden oder ob sie einzeln angegeben werden müssen.
Wenn dies auf true gesetzt ist, 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 Zulassungskonfigurationen ist, die viele data-* Attribute enthalten, die Sie zulassen möchten.
Die Methode gibt false zurück, wenn sie mit Entfernkonfigurationen verwendet wird, die alle data-* Attribute einfach durch Weglassen zulassen können.
Syntax
setDataAttributes(allow);
Parameter
allow-
true, wenn alledata-*Attribute erlaubt sind, undfalse, wenn sie ausdrücklich 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 kann, da dieser Sanitizer eine Entfernkonfiguration hat.
Beispiele
Grundlegende Nutzung
Der folgende 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 |