XML DOM insertRule() 方法

定义和用法

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

语法:

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 的一个替代方法。

实例

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

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

相关页面

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