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

接口 MediaList

public interface MediaList
MediaList 接口提供了有序媒体集合的抽象，但没有定义或限制该集合的实现方式。空列表与包含介质 "all" 的列表相同。

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

另见 文档对象模型 (DOM) 级别 2 样式规范 。

自从：
1.4、DOM Level 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：如果此list是只读的则引发。
      NOT_FOUND_ERR：如果 oldMedium 不在列表中则引发。

    • appendMedium

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