CSSGroupingRule：insertRule() 方法

Baseline 已廣泛支援

此特性已得到良好支援，可在多種裝置和瀏覽器版本上使用。自 2021 年 4 月起，所有瀏覽器均已支援此特性。

CSSGroupingRule 介面的 insertRule() 方法將一個新的 CSS 規則新增到 CSS 規則列表中。

語法

insertRule(rule)
insertRule(rule, index)

引數

rule: 字串
index 可選: 插入規則的可選索引；預設為 0。

返回值

新規則的索引。

異常

IndexSizeError DOMException: 如果 index 大於子 CSS 規則的數量，則丟擲該異常。
HierarchyRequestError DOMException: 如果由於某些 CSS 限制而無法在指定索引處插入 rule，則丟擲該異常。
HierarchyRequestError DOMException: 如果 rule 是一個有效語句但不是巢狀語句，則丟擲該異常。

示例

let myRules = document.styleSheets[0].cssRules;
myRules[0].insertRule(
  "html {background-color: blue;}",
  0,
); /* inserts a rule for the HTML element at position 0 */

規範

規範
CSS 物件模型 (CSSOM) # dom-cssgroupingrule-insertrule

瀏覽器相容性

幫助改進 MDN

瞭解如何貢獻

此頁面最後修改於 ⁨2025年6月22日⁩，由 MDN 貢獻者更新。

在 GitHub 上檢視此頁面 • 報告此內容的錯誤