XML DOM insertRule() 方法

定义和用法

insertRule() 方法在样式表中插入一条规则。

语法：

  1. insertRule(rule,index)
参数 描述
rule 必需。要添加到样式表的规则的完整的、可解析的文本表示。 - 对于规则集（rule sets），rule 指示选择器和样式声明。 - 对于 @ 规则（At rules），rule 指示 @ 标识符和规则内容。
index 必需。要把规则插入或附加到 cssRules 数组中的位置。

返回值

参数 index 的值。

抛出

该方法在下列情况下将抛出具有以下代码的 DOMException 异常：

  • HIERARCHY_REQUEST_ERR
  • CSS 语法不允许指定的规则出现在指定的位置。
  • INDEX_SIZE_ERR
  • index 不对应样式表的规则集中的任何规则，比如 index 是负数或者大于 cssRules.length 的值。
  • NO_MODIFICATION_ALLOWED_ERR
  • 该样式表是只读的。
  • SYNTAX
  • 指定的 rule 文本具有文本错误。

描述

该方法将在样式表的 cssRules 数组的指定 index 处插入（或附加）新的 CSS rule。这是一个 DOM 标准方法，请参阅 CSSStyleSheet.addRule()，它是特定于 IE 的一个替代方法。

实例

把一条规则推放到样式表的顶端：

  1. myStyle.insertRule("#blanc { color: white }", 0);

相关页面

XML DOM 参考手册：CSSStyleSheet.addRule()