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 上查看此页面 • 报告此内容的错误