Interface CSSMediaRule

CSSMediaRule インターフェイスは、CSS スタイルシート内の @media規則 を表す。@media 規則は、特定のメディア型の為にスタイル規則を分けるのに使われる。

プロパティ:

`cssmediaruleObject`.`cssRules`

CSSRuleList型, 読取専用

メディアブロック内に含まれる CSS 規則のリスト。

`cssmediaruleObject`.`media`

stylesheets::MediaList型, 読取専用

この規則内の メディアタイプ のリスト。

メソッド:

`cssmediaruleObject`.`deleteRule`( `index` )

メディアブロックから規則を削除する。

引数:

index / unsigned long: メディアブロック内規則リストにおける、削除する規則のインデックス。

戻り値:

(無し)

例外:

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

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

メディアブロック内に新しい規則を挿入する。

引数:

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

戻り値:

unsigned long 型。メディアブロックの規則リストにおける、新たに追加された規則のインデックス。

例外:

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

IDL 定義:

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