MediaQueryList: matches-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die schreibgeschützte matches-Eigenschaft der MediaQueryList-Schnittstelle ist ein boolescher Wert, der true zurückgibt, wenn das document derzeit die Medienabfrageliste erfüllt, oder false, wenn nicht.
Sie können benachrichtigt werden, wenn sich der Wert von matches ändert, indem Sie auf das change-Ereignis achten, das bei der MediaQueryList ausgelöst wird.
Wert
Ein boolescher Wert, der true ist, wenn das document derzeit die Medienabfrageliste erfüllt; andernfalls ist er false.
Beispiele
Dieses Beispiel erkennt Änderungen der Ausrichtung des Ansichtsfensters, indem es eine Medienabfrage mit der orientation-Medienfunktion erstellt:
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");
}
});
Spezifikationen
| Spezifikation |
|---|
| CSSOM View Module # dom-mediaquerylist-matches |