The change event of the MediaQueryList interface fires when the status of media query support changes.
On this page
MediaQueryList: change event
Syntax
Use the event name in methods like addEventListener(), or set an event handler property.
js
addEventListener("change", (event) => {});
onchange = (event) => {};
Event type
A MediaQueryListEvent. Inherits from Event.
Event properties
The MediaQueryListEvent interface inherits properties from its parent interface, Event.
MediaQueryListEvent.matchesRead only-
A boolean value that is
trueif thedocumentcurrently matches the media query list, orfalseif not. MediaQueryListEvent.mediaRead only-
A string representing a serialized media query.
Example
js
const mql = window.matchMedia("(max-width: 600px)");
mql.onchange = (e) => {
if (e.matches) {
/* the viewport is 600 pixels wide or less */
console.log("This is a narrow screen — less than 600px wide.");
} else {
/* the viewport is more than 600 pixels wide */
console.log("This is a wide screen — more than 600px wide.");
}
};
Specifications
| Specification |
|---|
| CSSOM View Module # dom-mediaquerylist-onchange |
Browser compatibility
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
change_event |
39 | 79 | 55 | No | 26 | 14 | 39 | 39 | 55 | 26 | 14 | 4.0 |
See also
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/MediaQueryList/change_event