模块  jdk.xml.dom
软件包  org.w3c.dom.stylesheets

Interface MediaList

  • public interface MediaList
    MediaList接口提供有序的媒体集合的抽象，而不定义或约束此集合的实现方式。 空列表与包含介质"all"的列表相同。

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

    另见Document Object Model (DOM) Level 2 Style Specification 。

    从以下版本开始：
    1.4，DOM Level 2

    • 方法详细信息

      • getMediaText

        String getMediaText()
        媒体列表的可解析文本表示。 这是一个以逗号分隔的媒体列表。

      • setMediaText

        void setMediaText​(String mediaText)
           throws DOMException
        媒体列表的可解析文本表示。 这是一个以逗号分隔的媒体列表。
        异常
        DOMException - SYNTAX_ERR：如果指定的字符串值具有语法错误且不可DOMException此异常。
        NO_MODIFICATION_ALLOWED_ERR：如果此媒体列表是只读的，则引发此异常。

      • getLength

        int getLength()
        列表中的媒体数量。 有效媒体的范围是0到length-1含）。

      • item

        String item​(int index)
        返回列表中的index 。 如果index大于或等于列表中的媒体数，则返回null 。
        参数
        index - 索引到集合中。
        结果
        在该介质 index在个位置 MediaList ，或 null如果不是有效的索引。

      • deleteMedium

        void deleteMedium​(String oldMedium)
           throws DOMException
        从列表中删除 oldMedium指示的介质。
        参数
        oldMedium - 要在媒体列表中删除的媒体。
        异常
        DOMException - NO_MODIFICATION_ALLOWED_ERR：如果此列表是只读的，则引发此异常。
        NOT_FOUND_ERR：如果oldMedium不在列表中，则oldMedium 。

      • appendMedium

        void appendMedium​(String newMedium)
           throws DOMException
        将介质newMedium添加到列表的末尾。 如果已使用newMedium ，则首先将其删除。
        参数
        newMedium - 要添加的新媒体。
        异常
        DOMException - INVALID_CHARACTER_ERR：如果介质包含基础样式语言中无效的字符。
        NO_MODIFICATION_ALLOWED_ERR：如果此列表是只读的，则引发。