CKTIS / JavaScript
MediaQueryList.matches — overeenkomingsstatus van de mediaquery
MediaQueryList.matches is een alleen-lezen booleaanse eigenschap die aangeeft of een mediaquery overeenkomt met de huidige status van het document.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
const mql = window.matchMedia(query);
const matches = mql.matches;MediaQueryList.matches geeft true terug wanneer de bijbehorende lijst met mediaquery’s overeenkomt met de status van het document, en anders false. Verkrijg het object met window.matchMedia(query). Dit is een alleen-lezen eigenschap, geen methode: gebruik mql.matches, niet mql.matches().
De waarde van het object kan veranderen. Een eerder opgeslagen booleaanse waarde wordt niet automatisch bijgewerkt. Luister naar de gebeurtenis change om op wijzigingen in de overeenkomst te reageren; alleen de eigenschap uitlezen registreert geen listener.
Het voorbeeld gebruikt all en not all, dus de uitvoer hangt niet af van de venstergrootte. Dit is een browser-Web-API uit CSSOM View, geen ECMAScript-functie; Node 24 toont niet aan dat deze beschikbaar is.
Voorbeelden
const queries = ["all", "not all"];
for (const query of queries) {
const mql = window.matchMedia(query);
console.log(`${query}: ${mql.matches}`);
}Resultaat
all: true not all: false
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.