Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri