public interface MediaList
MediaList
インタフェースでは、このコレクションの実装方法を定義したり制約したりすることなく、メディアの順序付けされたコレクションの抽象化を提供します。 空のリストは、メディア"all"
が含まれるリストと同じです。
MediaList
内の項目には、ゼロから始まる整数のインデックスを使用してアクセスできます。
「Document Object Model (DOM) Level 2 Style Specification」も参照してください。
- 導入されたバージョン:
- 1.4、DOMレベル2
-
メソッドのサマリー
修飾子と型 メソッド 説明 void
appendMedium(String newMedium)
メディアnewMedium
をリストの末尾に追加します。void
deleteMedium(String oldMedium)
oldMedium
で示されるメディアをリストから削除します。int
getLength()
リスト内のメディア数。String
getMediaText()
メディア・リストの、構文解析できるテキスト表現。String
item(int index)
リストのindex
番目を返します。void
setMediaText(String mediaText)
メディア・リストの、構文解析できるテキスト表現。
-
メソッドの詳細
-
getMediaText
String getMediaText()メディア・リストの、構文解析できるテキスト表現。 カンマで区切ったメディアのリストです。 -
setMediaText
void setMediaText(String mediaText) throws DOMExceptionメディア・リストの、構文解析できるテキスト表現。 カンマで区切ったメディアのリストです。- 例外:
DOMException
- SYNTAX_ERR: 指定した文字列値に構文エラーがあり、解析できない場合に発生する。
NO_MODIFICATION_ALLOWED_ERR: このメディア・リストが読取り専用の場合に発生する。
-
getLength
int getLength()リスト内のメディア数。 有効なメディアの範囲は、0
からlength-1
まで(両端を含む)です。 -
item
String item(int index)リストのindex
番目を返します。index
がリスト内のメディアの数以上である場合はnull
を返します。- パラメータ:
index
- コレクション内のインデックス。- 戻り値:
MediaList
のindex
番目の位置にあるメディア。インデックスが有効でない場合はnull
。
-
deleteMedium
void deleteMedium(String oldMedium) throws DOMExceptionoldMedium
で示されるメディアをリストから削除します。- パラメータ:
oldMedium
- メディア・リストから削除するメディア。- 例外:
DOMException
- NO_MODIFICATION_ALLOWED_ERR: このリストが読取り専用の場合に発生する。
NOT_FOUND_ERR:oldMedium
がリストにない場合に発生する。
-
appendMedium
void appendMedium(String newMedium) throws DOMExceptionメディアnewMedium
をリストの末尾に追加します。newMedium
がすでに使用されている場合は、先に削除されます。- パラメータ:
newMedium
- 追加する新しいメディア。- 例外:
DOMException
- INVALID_CHARACTER_ERR: 基盤となるスタイル言語で無効な文字がメディアに含まれる場合。
NO_MODIFICATION_ALLOWED_ERR: このリストが読取り専用の場合に発生する。
-