CSSStyleSheet: 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.

replaceSync() は CSSStyleSheet インターフェイスのメソッドで、スタイルシートの内容を渡された内容で同期的に置き換えます。

replaceSync() と CSSStyleSheet.replace() の両メソッドは、 CSSStyleSheet() コンストラクターで作成されたスタイルシートでのみ使用できます。

構文

replaceSync(text)

text: スタイルシートのコンテンツを置き換えるためのスタイルルールを格納した文字列。文字列に解釈可能なルールのリストが入っていない場合、値は空文字列に設定されます。

メモ: もし text に渡されたルールの中に @import ルールでインポートされた外部スタイルシートがあった場合は、それらのルールは除去され、コンソールに警告が出力されます。

なし (undefined)。

NotAllowedError DOMException: このスタイルシートが CSSStyleSheet() コンストラクターを使用して作成されていない場合、または変更不可に設定されている場合に発生します。

次の例では、新しいスタイルシートを作成し、replaceSync() を使って 2 つの CSS ルールを追加しています。

const stylesheet = new CSSStyleSheet();

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

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