IMediaList Interface

IMediaList interface

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”.

See also the CSS Object Model (CSSOM) # MediaList.

public interface IMediaList : IEnumerable<string>

Properties

NameDescription
Item { get; }RetuThe item(index) method must return a serialization of the media query in the collection of media queries given by index, or null, if index is greater than or equal to the number of media queries in the collection of media queries.
Length { get; }The length attribute must return the number of media queries in the collection of media queries. The range of valid media is 0 to length-1 inclusive.
MediaText { get; }A stringifier that returns a DOMString representing the MediaList as text, and also allows you to set a new MediaList.

Methods

NameDescription
AppendMedium(string)Adds the medium newMedium to the end of the list. If the newMedium is already used, it is first removed.
DeleteMedium(string)Deletes the medium indicated by oldMedium from the list.

Remarks

Note: MediaList is a live list; updating the list using properties or methods listed below will immediately update the behavior of the document.

CSSOM defines APIs (including generic parsing and serialization rules) for Media Queries, Selectors, and of course CSS itself.

Reference

CSS Working Group - The CSS Working Group is the W3C working group chartered to develop Cascading Style Sheets (CSS).CSS Object Model (CSSOM) - CSSOM defines APIs (including generic parsing and serialization rules) for Media Queries, Selectors, and of course CSS itself.CSS Object Model (CSSOM) # medialist – The CSSOM definition.

Examples

The following would log to the console a textual representation of the MediaList of the first stylesheet applied to the current document.

var stylesheets = document.StyleSheets;
var stylesheet = stylesheets[0];
Console.Write(stylesheet.Media.MediaText);

See Also