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

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

namespace Optional

Ein String, der den Namespace des Attributs enthält, der standardmäßig auf null gesetzt 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.

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

Browser-Kompatibilität