CSSStyleSheet: Methode replaceSync()

Baseline 2023

Newly available

Since March 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Die replaceSync()-Methode der CSSStyleSheet-Schnittstelle ersetzt synchron den Inhalt des Stylesheets mit dem übergebenen Inhalt.

Die Methoden replaceSync() und CSSStyleSheet.replace() können nur auf einem Stylesheet verwendet werden, das mit dem CSSStyleSheet()-Konstruktor erstellt wurde.

Syntax

replaceSync(text)

text: Ein String, der die Stilregeln enthält, um den Inhalt des Stylesheets zu ersetzen. Wenn der String keine parsefähige Liste von Regeln enthält, wird der Wert auf einen leeren String gesetzt.

Hinweis: Wenn eine der in text übergebenen Regeln ein externes Stylesheet ist, das mit der @import-Regel importiert wird, werden diese Regeln entfernt, und eine Warnung wird in der Konsole ausgegeben.

Keiner (undefined).

NotAllowedError DOMException: Wird ausgelöst, wenn das Stylesheet nicht mit dem CSSStyleSheet()-Konstruktor erstellt wurde oder wenn das Stylesheet als nicht änderbar gekennzeichnet ist.

Im folgenden Beispiel wird ein neues Stylesheet erstellt und zwei CSS-Regeln mit replaceSync hinzugefügt.

const stylesheet = new CSSStyleSheet();

stylesheet.replaceSync("body { font-size: 1.4em; } p { color: red; }");

Specification
CSS Object Model (CSSOM) # dom-cssstylesheet-replacesync