JavaScript: The Definitive Guide, Fourth Edition

Name

MediaList.appendMedium( ) — add a new media type to the list

Availability

DOM Level 2 StyleSheets

Synopsis

void appendMedium(String newMedium)
    throws DOMException;

Arguments

newMedium

The name of the new media type to append. See the MediaList reference page for the set of valid media type names.

Throws

This method may throw a DOMException with a code of NO_MODIFICATION_ALLOWED_ERR if the media list is read-only, or INVALID_CHARACTER_ERR if the specified newMedium argument contains illegal characters.

Description

This method appends the specified newMedium to the end of the MediaList. If the MediaList already contains the specified media type, it is first removed from its current position and then appended at the end of the list.