Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori