KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen