Module jdk.xml.dom
Package org.w3c.dom.stylesheets

Interface MediaList

public interface MediaList
MediaList接口提供了一个媒体有序集合的抽象，而不定义或限制如何实现此集合。空列表与包含媒体"all"的列表相同。

MediaList中的项目可通过整数索引访问，从0开始。

另请参阅文档对象模型（DOM）Level 2样式规范。

自：
1.4，DOM Level 2

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    appendMedium(String newMedium)
    将媒体newMedium添加到列表末尾。
    void
    deleteMedium(String oldMedium)
    从列表中删除由oldMedium指示的媒体。
    int
    getLength()
    列表中的媒体数量。
    String
    getMediaText()
    媒体列表的可解析文本表示。
    String
    item(int index)
    返回列表中的第index个。
    void
    setMediaText(String mediaText)
    媒体列表的可解析文本表示。

  • Method Details

    • 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：如果此列表是只读的，则引发。