CSSStyleSheet: Methode replaceSync()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit März 2023 browserübergreifend verfügbar.
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)
Parameter
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.
Rückgabewert
Keiner (undefined).
Ausnahmen
NotAllowedErrorDOMException-
Wird ausgelöst, wenn das Stylesheet nicht mit dem
CSSStyleSheet()-Konstruktor erstellt wurde oder wenn das Stylesheet als nicht änderbar gekennzeichnet ist.
Beispiele
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; }");
Spezifikationen
| Spezifikation |
|---|
| CSS Object Model (CSSOM) # dom-cssstylesheet-replacesync |