CKTIS / JavaScript
window.matchMedia — provjera medijskih upita
window.matchMedia iz JavaScripta provjerava CSS medijski upit. Vraća MediaQueryList s trenutačnim rezultatom u matches i omogućuje praćenje promjena u tome podudara li se upit.
Verzija: 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) stvara novi objekt MediaQueryList, a ne logičku vrijednost. Pročitajte matches da biste dobili trenutačni rezultat; media sadrži serijalizirani upit.
Proslijedite CSS upit, primjerice "(min-width: 768px)", bez @media. Medijsko obilježje width odnosi se na širinu područja prikaza (viewport) u kontinuiranim medijima, a u medijima podijeljenima na stranice, kao što je ispis, na širinu okvira stranice (page box). Jedinica px označava CSS piksele. Ovaj upit nije ograničen na vrstu medija screen. Metoda provjerava uvjet; sama ne primjenjuje stilove.
Ovo je API preglednika iz CSSOM Viewa, a ne značajka ECMAScripta. Prije poziva window.matchMedia(query) provjerite vrijedi li typeof window !== "undefined" && typeof window.matchMedia === "function"; sam Node 24 ne dokazuje podršku. Tom provjerom ne utvrđujete jesu li na vraćenom objektu dostupne metode za dodavanje i uklanjanje slušatelja događaja.
Početni rezultat pročitajte iz mql.matches, pri čemu je mql vraćeni objekt MediaQueryList. Registrirajte funkciju za obradu događaja pozivom mql.addEventListener("change", handler) samo ako vrijedi typeof mql.addEventListener === "function" && typeof mql.removeEventListener === "function". Ako neka od metoda nedostaje, preskočite registraciju; i dalje možete čitati matches. Događaj označava promjenu rezultata, a ne svaku promjenu veličine; novi rezultat daje event.matches. Ako ste registrirali funkciju, pri čišćenju pozovite mql.removeEventListener("change", handler) s istom funkcijom.
Primjer upotrebljava all i njegovu negaciju not all, pa rezultat ne ovisi o veličini prozora.
Primjeri
const always = window.matchMedia("all");
const never = window.matchMedia("not all");
console.log(always.matches);
console.log(never.matches);Rezultat
true false
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.