CSSStyleSheet: replaceSync() 方法

Baseline 已廣泛支援

此功能已成熟，並可在許多裝置和瀏覽器版本上執行。自 2023 年 3 月以來，它已在各種瀏覽器中可用。

replaceSync() 方法是 CSSStyleSheet 介面的一部分，它同步地將樣式表的內容替換為傳入的內容。

replaceSync() 和 CSSStyleSheet.replace() 方法只能用於透過 CSSStyleSheet() 建構函式建立的樣式表。

語法

replaceSync(text)

文字: 一個包含要替換樣式表內容的樣式規則的字串。如果字串不包含可解析的規則列表，則該值將被設定為空字串。

注意： 如果 text 中傳入的任何規則是使用 @import 規則匯入的外部樣式表，則這些規則將被刪除，並在控制檯中列印警告。

無 (undefined)。

NotAllowedError DOMException: 如果樣式表不是使用 CSSStyleSheet() 建構函式建立的，或者樣式表被標記為不可修改，則會丟擲該異常。

在下面的示例中，建立了一個新的樣式表，並使用 replaceSync 添加了兩條 CSS 規則。

const stylesheet = new CSSStyleSheet();

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

規範
CSS 物件模型 (CSSOM) # dom-cssstylesheet-replacesync

本頁面最後修改於 2025 年 6 月 23 日，由 MDN 貢獻者進行。