SanitizerConfig

elements

Ein Array, das die zu erlaubenden Elemente beim Bereinigen von HTML angibt, optional auch ihre erlaubten oder zu entfernenden Attribute spezifizierend.

Jedes Element kann durch einen Namen (ein String) angegeben werden oder als Objekt mit den folgenden Eigenschaften:

name

Ein String, der den Namen des Elements enthält.

namespace Optional

Ein String, der den Namespace des Elements enthält. Der Standard-Namespace ist "http://www.w3.org/1999/xhtml".

attributes Optional

Ein Array, das die Attribute angibt, die bei diesem (erlaubten) Element beim Bereinigen von HTML erlaubt sind.

Jedes Attribut kann durch einen Namen (ein String) angegeben werden oder als 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 null ist.

removeAttributes Optional

Ein Array, das die Attribute angibt, die bei diesem (erlaubten) Element beim Bereinigen von HTML entfernt werden sollen.

Jedes Attribut kann durch einen Namen (ein String) angegeben werden oder als 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 null ist.

removeElements

Ein Array, das die zu entfernenden Elemente beim Bereinigen von HTML angibt.

Jedes Element kann durch einen Namen (ein String) angegeben werden oder als Objekt mit den folgenden Eigenschaften:

name

Ein String, der den Namen des Elements enthält.

namespace Optional

Ein String, der den Namespace des Elements enthält. Der Standard-Namespace ist "http://www.w3.org/1999/xhtml".

replaceWithChildrenElements

Ein Array, das die Elemente angibt, die durch ihren Inhalt ersetzt werden sollen, wenn HTML bereinigt wird. Dies wird hauptsächlich verwendet, um Stile aus Text zu entfernen (zum Beispiel könnte dies verwendet werden, um <b>some text</b> in some text zu ändern).

Jedes Element kann durch einen Namen (ein String) angegeben werden oder als Objekt mit den folgenden Eigenschaften:

name

Ein String, der den Namen des Elements enthält.

namespace Optional

Ein String, der den Namespace des Elements enthält. Der Standard-Namespace ist "http://www.w3.org/1999/xhtml".

attributes

Ein Array, das die Attribute angibt, die beim Bereinigen von HTML erlaubt sind.

Jedes Attribut kann durch einen Namen (ein String) angegeben werden oder als 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 null ist.

removeAttributes

Ein Array, das die Attribute angibt, die von Elementen entfernt werden sollen, wenn HTML bereinigt wird.

Jedes Attribut kann durch einen Namen (ein String) angegeben werden oder als 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 null ist.

comments

true, wenn Kommentare erlaubt sind, und false, wenn sie entfernt werden sollen.

dataAttributes

true, wenn Datenattribute erlaubt sind, und false, wenn sie entfernt werden sollen.

Dieses Beispiel zeigt, wie man eine "allow"-Sanitizer-Konfiguration erstellen könnte, und in diesem Fall an den Sanitizer()-Konstruktor übergibt.

const sanitizer = new Sanitizer({
  elements: ["div", "p", "script"],
  attributes: ["id"],
  replaceWithChildrenElements: ["b"],
  comments: true,
  dataAttributes: false,
});

Beachten Sie, dass Sie nicht sowohl Zulassungs- als auch Entfernung-Listen in derselben Konfiguration angeben können, ohne eine Ausnahme zu verursachen, wenn die Konfiguration an den Konstruktor oder eine Bereinigungsmethode übergeben wird.

Dieses Beispiel zeigt, wie man eine "remove"-Sanitizer-Konfiguration erstellen könnte, und in diesem Fall an den Sanitizer()-Konstruktor übergibt.

const sanitizer = new Sanitizer({
  removeElements: ["span", "script"],
  removeAttributes: ["lang", "id"],
  comments: false,
});

Beachten Sie, dass Sie nicht sowohl Zulassungs- als auch Entfernung-Listen in derselben Konfiguration angeben können, ohne eine Ausnahme zu verursachen, wenn die Konfiguration an den Konstruktor oder eine Bereinigungsmethode übergeben wird.