MediaQueryListEvent

The MediaQueryListEvent object stores information on the changes that have happened to a MediaQueryList object — instances are available as the event object on a function referenced by a MediaQueryList.onchange property or MediaQueryList.addEvent() call.

Constructor

MediaQueryListEvent.MediaQueryListEvent()

 Creates a new MediaQueryListEvent instance.

Properties

The MediaQueryListEvent interface inherits properties from its parent interface, Event.

MediaQueryListEvent.matches Read only

 A Boolean that returns true if the document currently matches the media query list, or false if not.

MediaQueryListEvent.media Read only

 A DOMString representing a serialized media query.

Methods

The MediaQueryListEvent interface inherits methods from its parent interface, Event.

Examples

var mql = window.matchMedia('(max-width: 600px)');

function screenTest(e) {
  if (e.matches) {
    /* the viewport is 600 pixels wide or less */
    para.textContent = 'This is a narrow screen — less than 600px wide.';
    document.body.style.backgroundColor = 'red';
  } else {
    /* the viewport is more than than 600 pixels wide */
    para.textContent = 'This is a wide screen — more than 600px wide.';
    document.body.style.backgroundColor = 'blue';
  }
}

mql.addListener(screenTest);

Specifications

Browser compatibility

See also

• Media queries
• Using media queries from code
• window.matchMedia()
• MediaQueryListListener
• MediaQueryListEvent