CKTIS / JavaScript
MediaQueryList.matches — stanje ujemanja medijske poizvedbe
MediaQueryList.matches je logična lastnost samo za branje, ki pove, ali se medijska poizvedba ujema s trenutnim stanjem dokumenta.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
const mql = window.matchMedia(query);
const matches = mql.matches;MediaQueryList.matches vrne true, kadar se povezan seznam medijskih poizvedb ujema s stanjem dokumenta, sicer pa false. Objekt pridobiš z window.matchMedia(query). To je lastnost samo za branje, ne metoda: uporabi mql.matches, ne mql.matches().
Vrednost objekta se lahko spremeni. Prej shranjena logična vrednost se ne posodablja samodejno. Če se želiš odzvati na spremembe ujemanja, poslušaj dogodek change; že samo branje lastnosti ne registrira poslušalnika dogodkov.
Primer uporablja all in not all, zato rezultat ni odvisen od velikosti okna. Gre za spletni API brskalnika iz CSSOM View, ne za funkcionalnost ECMAScripta; Node 24 ne potrjuje njegove razpoložljivosti.
Primeri
const queries = ["all", "not all"];
for (const query of queries) {
const mql = window.matchMedia(query);
console.log(`${query}: ${mql.matches}`);
}Rezultat
all: true not all: false
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.