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

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.

Viri