Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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

js
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.

namespace Optional

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 removeAttributes Array definiert, das bereits das angegebene Attribut enthält (und daher bereits gefiltert ist)
  • stattdessen ein attributes Array 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.

js
// 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

Browser-Kompatibilität