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 returnstrue
if thedocument
currently matches the media query list, orfalse
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
Specification | Status | Comment |
---|---|---|
CSS Object Model (CSSOM) View Module The definition of 'MediaQueryListEvent' in that specification. |
Working Draft | Initial definition |
Browser compatibility
Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | (Yes) | ? | 55 (55) | No support | (Yes) | ? |
Feature | Android | Edge | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile | Chrome for Android |
---|---|---|---|---|---|---|---|
Basic support | No support | ? | 55.0 (55) | No support | (Yes) | ? | (Yes) |
See also
Document Tags and Contributors
Tags:
Contributors to this page:
chrisdavidmills
Last updated by:
chrisdavidmills,