CSSGroupingRule: insertRule() 方法

insertRule() 方法是 CSSGroupingRule 接口的一个方法，它将一个新的 CSS 规则添加到一个 CSS 规则列表中。

语法

js

insertRule(rule)
insertRule(rule, index)

参数

rule: 一个字符串
index 可选: 一个可选的索引，用于插入规则；默认为 0。

返回值

新规则的索引。

异常

IndexSizeError DOMException: 如果index大于子 CSS 规则的数量，则抛出此异常。
HierarchyRequestError DOMException: 如果由于 CSS 指定的约束，新规则无法插入到给定的（从零开始的索引）索引位置，则抛出此异常。
InvalidStateError DOMException: 如果新规则是 @namespace at-rule，并且子 CSS 规则列表包含除 @import at-rule 和 @namespace at-rule 之外的任何内容，则抛出此异常。

示例

js

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

浏览器兼容性

BCD 表格仅在浏览器中加载