モジュール jdk.xml.dom
パッケージ org.w3c.dom.stylesheets

インタフェースMediaList

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 DOMException
      oldMediumで示されるメディアをリストから削除します。
      パラメータ:
      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: このリストが読取り専用の場合に発生する。