MediaList (Java SE 23 & JDK 23)
Description: declaration: module: jdk.xml.dom, package: org.w3c.dom.stylesheets, interface: MediaList
Keywords: org.w3c.dom.stylesheets.MediaList interface

# Interface MediaList

public interface MediaList
The `MediaList` interface provides the abstraction of an ordered collection of media, without defining or constraining how this collection is implemented. An empty list is the same as a list that contains the medium `"all"`.

The items in the `MediaList` are accessible via an integral index, starting from 0.

See also the Document Object Model (DOM) Level 2 Style Specification.

Since:
  1.4, DOM Level 2

- ## Method Summary

  Modifier and Type
  Method
  Description
  `void`
  `appendMedium(String newMedium)`
  Adds the medium `newMedium` to the end of the list.
  `void`
  `deleteMedium(String oldMedium)`
  Deletes the medium indicated by `oldMedium` from the list.
  `int`
  `getLength()`
  The number of media in the list.
  `String`
  `getMediaText()`
  The parsable textual representation of the media list.
  `String`
  `item(int index)`
  Returns the `index`th in the list.
  `void`
  `setMediaText(String mediaText)`
  The parsable textual representation of the media list.

- ## Method Details

  - ### getMediaText

    String getMediaText()
    The parsable textual representation of the media list. This is a comma-separated list of media.

  - ### setMediaText

    void setMediaText(String mediaText) throws DOMException
    The parsable textual representation of the media list. This is a comma-separated list of media.
    Throws:
      `DOMException` - SYNTAX_ERR: Raised if the specified string value has a syntax error and is unparsable.
      NO_MODIFICATION_ALLOWED_ERR: Raised if this media list is readonly.

  - ### getLength

    int getLength()
    The number of media in the list. The range of valid media is `0` to `length-1` inclusive.

  - ### item

    String item(int index)
    Returns the `index`th in the list. If `index` is greater than or equal to the number of media in the list, this returns `null`.
    Parameters:
      `index` - Index into the collection.
    Returns:
      The medium at the `index`th position in the `MediaList`, or `null` if that is not a valid index.

  - ### deleteMedium

    void deleteMedium(String oldMedium) throws DOMException
    Deletes the medium indicated by `oldMedium` from the list.
    Parameters:
      `oldMedium` - The medium to delete in the media list.
    Throws:
      `DOMException` - NO_MODIFICATION_ALLOWED_ERR: Raised if this list is readonly.
      NOT_FOUND_ERR: Raised if `oldMedium` is not in the list.

  - ### appendMedium

    void appendMedium(String newMedium) throws DOMException
    Adds the medium `newMedium` to the end of the list. If the `newMedium` is already used, it is first removed.
    Parameters:
      `newMedium` - The new medium to add.
    Throws:
      `DOMException` - INVALID_CHARACTER_ERR: If the medium contains characters that are invalid in the underlying style language.
      NO_MODIFICATION_ALLOWED_ERR: Raised if this list is readonly.