# class MediaList

###

Module | khtml
Namespace | DOM
Class | MediaList
Inherits |

The MediaList interface provides the abstraction of an ordered collection of media, without defining or constraining how this collection is implemented. All media are lowercase strings.

### methods

- MediaList ( )

  returns ctor

- MediaList (other)

  returns ctor

  Argument | Type | Default
  --- | --- | ---
  other | DOM.MediaList |

- MediaList (impl)

  returns ctor
  Not implemented

  Argument | Type | Default
  --- | --- | ---
  impl | MediaListImpl |

- appendMedium (newMedium)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  newMedium | DOM.DOMString |

  Adds the medium newMedium to the end of the list. If the newMedium is already used, it is first removed.

  newMedium - The new medium to add.

  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.

- deleteMedium (oldMedium)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  oldMedium | DOM.DOMString |

  Deletes the medium indicated by oldMedium from the list.

  oldMedium - The medium to delete in the media list.

  DOMException NO_MODIFICATION_ALLOWED_ERR: Raised if this list is readonly.

  NOT_FOUND_ERR: Raised if oldMedium is not in the list.

- handle ( )

  returns MediaListImpl
  Not implemented

  Internal

- isNull ( )

  returns bool

- item (index)

  returns DOM.DOMString

  Argument | Type | Default
  --- | --- | ---
  index | unsigned long |

  Returns the indexth in the list. If index is greater than or equal to the number of media in the list, this returns null.

  index - Index into the collection.

  Returns The medium at the indexth position in the MediaList, or null if that is not a valid index.

- length ( )

  returns unsigned long

  The number of media in the list. The range of valid media is 0 to length-1 inclusive.

- mediaText ( )

  returns DOM.DOMString

  The parsable textual representation of the media list. This is a comma-separated list of media.

  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.

- setMediaText (value)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  value | DOM.DOMString |

  see mediaText