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.addListener()
call.
Constructor
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 ModuleThe definition of 'MediaQueryListEvent' in that specification. | Working Draft | Initial definition |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
MediaQueryListEvent
|
Chrome
Full support Yes |
Edge
Full support ≤79 |
Firefox
Full support 55 |
IE
No support No |
Opera
Full support Yes |
Safari
Full support 14 |
WebView Android
No support No |
Chrome Android
Full support Yes |
Firefox Android
Full support 55 |
Opera Android
Full support Yes |
Safari iOS
Full support 14 |
Samsung Internet Android
Full support Yes |
MediaQueryListEvent() constructor
|
Chrome
Full support Yes |
Edge
Full support ≤79 |
Firefox
Full support 55 |
IE
No support No |
Opera
Full support Yes |
Safari
Full support 14 |
WebView Android
No support No |
Chrome Android
Full support Yes |
Firefox Android
Full support 55 |
Opera Android
Full support Yes |
Safari iOS
Full support 14 |
Samsung Internet Android
Full support Yes |
matches
|
Chrome
Full support Yes |
Edge
Full support ≤79 |
Firefox
Full support 55 |
IE
No support No |
Opera
Full support Yes |
Safari
Full support 14 |
WebView Android
No support No |
Chrome Android
Full support Yes |
Firefox Android
Full support 55 |
Opera Android
Full support Yes |
Safari iOS
Full support 14 |
Samsung Internet Android
Full support Yes |
media
|
Chrome
Full support Yes |
Edge
Full support ≤79 |
Firefox
Full support 55 |
IE
No support No |
Opera
Full support Yes |
Safari
Full support 14 |
WebView Android
No support No |
Chrome Android
Full support Yes |
Firefox Android
Full support 55 |
Opera Android
Full support Yes |
Safari iOS
Full support 14 |
Samsung Internet Android
Full support Yes |
Legend
- Full support
- Full support
- No support
- No support
See also
MediaQueryListEvent by Mozilla Contributors is licensed under CC-BY-SA 2.5.