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()