CKTIS / JavaScript
window.matchMedia — preverjanje medijskih poizvedb
window.matchMedia iz JavaScripta preveri medijsko poizvedbo CSS. Vrne MediaQueryList s trenutnim rezultatom v matches in omogoča spremljanje sprememb ujemanja poizvedbe.
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);
mql.matches;
mql.media;
mql.addEventListener("change", handler);
mql.removeEventListener("change", handler);window.matchMedia(query) ustvari nov objekt MediaQueryList, ne logične vrednosti. Trenutni rezultat preberite z matches; media vsebuje serializirano poizvedbo.
Podajte poizvedbo CSS, na primer "(min-width: 768px)", brez @media. Medijska značilnost width se pri neprekinjenih medijih nanaša na širino vidnega območja (viewport), pri medijih, razdeljenih na strani, kot je tisk, pa na širino okvirja strani (page box). Enota px pomeni slikovne pike CSS. Ta poizvedba ni omejena na vrsto medija screen. Metoda preveri pogoj; sama ne uporabi slogov.
To je brskalniški API iz CSSOM View, ne funkcija ECMAScripta. Pred klicem window.matchMedia(query) preverite, ali velja typeof window !== "undefined" && typeof window.matchMedia === "function"; Node 24 sam po sebi ne dokazuje podpore. S tem ne preverite, ali vrnjeni objekt ponuja metode za dodajanje in odstranjevanje poslušalcev dogodkov.
Začetni rezultat preberite iz mql.matches, kjer je mql vrnjeni objekt MediaQueryList. Funkcijo za obravnavo dogodka registrirajte z mql.addEventListener("change", handler) le, če velja typeof mql.addEventListener === "function" && typeof mql.removeEventListener === "function". Če katera od metod manjka, registracijo preskočite; matches lahko še vedno berete. Dogodek sporoči spremembo rezultata, ne vsake spremembe velikosti; nov rezultat poda event.matches. Če ste funkcijo registrirali, pri čiščenju pokličite mql.removeEventListener("change", handler) z isto funkcijo.
Primer uporablja all in njegovo negacijo not all, zato rezultat ni odvisen od velikosti okna.
Primeri
const always = window.matchMedia("all");
const never = window.matchMedia("not all");
console.log(always.matches);
console.log(never.matches);Rezultat
true false
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.