MediaQueryList: matches property
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("CSSOM view API")}}
The **matches** read-only property of the {{DOMxRef("MediaQueryList")}} interface is a boolean value that returns true if the {{DOMxRef("document")}} currently matches the media query list, or false if not.
You can be notified when the value of matches changes by watching for the {{domxref("MediaQueryList.change_event", "change")}} event to be fired at the MediaQueryList.
Value
A boolean value that is true if the {{DOMxRef("document")}} currently matches the media query list; otherwise, it's false.
Examples
This example detects viewport orientation changes by creating a media query using the {{cssxref("@media/orientation")}} media feature:
const mql = window.matchMedia("(orientation:landscape)");
mql.addEventListener("change", (event) => {
if (event.matches) {
console.log("Now in landscape orientation");
} else {
console.log("Now in portrait orientation");
}
});Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- Media queries
- Using media queries from code
- {{DOMxRef("window.matchMedia()")}}
- {{DOMxRef("MediaQueryList")}}
- {{DOMxRef("MediaQueryListEvent")}}