Interface MediaList

MediaList インターフェイスは、序列つき media リストの概念を、定義されているか否か、またこのリストが実装されているか否かの制約なしに提供する。空リストはメディア "all" のリストと同義である。

MediaList 内の各項目には 0 から始まる整数のインデックス経由でアクセス可能である。

プロパティ:

`medialistObject`.`length`

unsigned long型, 読取専用

リスト内のメディアの数。有効なメディアの範囲は 0 から length-1 までとなる。

`medialistObject`.`mediaText`

DOMString型

メディアリストの解析可能な原文の表現。カンマで区切られたメディアのリスト。

設定時の例外:

SYNTAX_ERR / DOMException: 文字列値に文法違反があり解析不能である場合に発生。
NO_MODIFICATION_ALLOWED_ERR / DOMException: メディアリストが読み出し専用である場合に発生。

メソッド:

`medialistObject`.`appendMedium`( `newMedium` )

リストの末尾にメディア newMedium を追加する。newMedium がすでに使用されていれば、まず取り除かれる。

引数:

newMedium / DOMString: 追加する新たなメディア。

戻り値:

(無し)

例外:

INVALID_CHARACTER_ERR / DOMException: 基礎になるスタイル言語において無効な文字がメディアに含まれる場合に発生。
NO_MODIFICATION_ALLOWED_ERR / DOMException: リストが読み出し専用である場合に発生。

`medialistObject`.`deleteMedium`( `oldMedium` )

リストから oldMedium で示されるメディアを削除する。

引数:

oldMedium / DOMString: メディアリストから削除するメディア。

戻り値:

(無し)

例外:

NO_MODIFICATION_ALLOWED_ERR / DOMException: リストが読み出し専用である場合に発生。
NOT_FOUND_ERR / DOMException: リストに oldMedium が存在しない場合に発生

`medialistObject`.`item`( `index` )

リスト内の index 番目を返す。リスト内のメディアの数と同じかそれ以上である場合、null を返す。

引数:

index / unsigned long: リスト内のインデックス。

戻り値:

DOMString 型。MediaList 内の index 番目のメディア。有効なインデックスで内場合は null。

IDL 定義:

// Introduced in DOM Level 2: interface MediaList { attribute DOMString mediaText; // raises(DOMException) on setting readonly attribute unsigned long length; DOMString item(in unsigned long index); void deleteMedium(in DOMString oldMedium) raises(DOMException); void appendMedium(in DOMString newMedium) raises(DOMException); };