Interface CSSStyleSheet

CSSStyleSheet インターフェイスは CSS スタイルシート(つまり ContentType が "text/css" であるスタイルシート) を表す、具体的なインターフェイスである。

プロパティ:

`cssstylesheetObject`.`cssRules`

CSSRuleList型, 読取専用

そのスタイルシート内に含まれる全 CSS 規則のリスト。規則集合(rule set) と @規則(at-rules) の両方が含まれる。

`cssstylesheetObject`.`ownerRule`

CSSRule型, 読取専用

そのスタイルシートが @import規則に由来している場合、ownerRule プロパティには CSSImportRule が含まれる。その場合 StyleSheet インターフェイスの ownerNode プロパティは null になる。スタイルシートがエレメントまたは処理命令(processing-instruction)に由来しているる場合は、ownerRule プロパティは null になり、ownerNode プロパティは Node になる。

メソッド:

`cssstylesheetObject`.`deleteRule`( `index` )

スタイルシートから規則を削除する。

引数:

index / unsigned long: スタイルシートの規則リストにおける、削除する規則のインデックス。

戻り値:

(無し)

例外:

INDEX_SIZE_ERR / DOMException: スタイルシートの規則リスト内に、指定されたインデックスに該当する規則がない場合に発生。
NO_MODIFICATION_ALLOWED_ERR / DOMException: スタイルシートが読み出し専用であった場合に発生。

`cssstylesheetObject`.`insertRule`( `rule`, `index` )

スタイルシートに新しい規則を挿入する。新しい規則はカスケードの一部となる。

引数:

rule / DOMString: 規則を表す解析可能なテキスト。規則集合(rule set)であれば、これはセレクタとスタイル宣言の両方を含む。@規則であれば、@識別子と規則内容の両方を指定する。
index / unsigned long: スタイルシートの規則リスト(rule collection)内における、その前に指定した規則を挿入する規則のインデックス。スタイルシートの規則リストの長さと等しい場合は、規則はスタイルシートの末尾に追加される。

戻り値:

unsigned long 型。スタイルシート規則リスト(rule collection)における、新しく挿入された規則のインデックス。

例外:

HIERARCHY_REQUEST_ERR / DOMException: 指定されたインデックスに規則を挿入できない場合 (例: 通常の規則集合や他の@規則の後への @import 規則の挿入など) に発生。
INDEX_SIZE_ERR / DOMException: 指定されたインデックスが挿入個所として有効でない場合に発生。
NO_MODIFICATION_ALLOWED_ERR / DOMException: スタイルシートが読み出し専用である場合に発生。
SYNTAX_ERR / DOMException: 指定された規則に文法違反があり解析不能である場合に発生。

IDL 定義:

// Introduced in DOM Level 2: interface CSSStyleSheet : stylesheets::StyleSheet { readonly attribute CSSRule ownerRule; readonly attribute CSSRuleList cssRules; unsigned long insertRule(in DOMString rule, in unsigned long index) raises(DOMException); void deleteRule(in unsigned long index) raises(DOMException); };