CKTIS / JavaScript
window.matchMedia — testovanie mediálnych dotazov
window.matchMedia testuje mediálny dotaz CSS z JavaScriptu. Vráti MediaQueryList s aktuálnym výsledkom v matches a umožňuje sledovať zmeny v tom, či dotaz zodpovedá.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
const mql = window.matchMedia(query);
mql.matches;
mql.media;
mql.addEventListener("change", handler);
mql.removeEventListener("change", handler);window.matchMedia(query) vytvorí nový objekt MediaQueryList, nie logickú hodnotu. Aktuálny výsledok zistíte prečítaním matches; media obsahuje serializovaný dotaz.
Odovzdajte dotaz CSS, napríklad "(min-width: 768px)", bez @media. Vlastnosť média width označuje pri spojitých médiách šírku zobrazovacej oblasti (viewport) a pri stránkovaných médiách, ako je tlač, šírku rámčeka stránky (page box). Jednotka px znamená pixely CSS. Tento dotaz nie je obmedzený na typ média screen. Metóda testuje podmienku; sama štýly nepoužije.
Ide o rozhranie prehliadača z CSSOM View, nie o funkciu ECMAScriptu. Pred volaním window.matchMedia(query) overte, či platí typeof window !== "undefined" && typeof window.matchMedia === "function"; samotný Node 24 podporu nedokazuje. Táto kontrola neoveruje dostupnosť metód na registráciu a odstránenie obsluhy udalostí na vrátenom objekte.
Počiatočný výsledok prečítajte z mql.matches, pričom mql je vrátený objekt MediaQueryList. Obslužnú funkciu zaregistrujte pomocou mql.addEventListener("change", handler) iba vtedy, keď platí typeof mql.addEventListener === "function" && typeof mql.removeEventListener === "function". Ak niektorá z metód chýba, registráciu vynechajte; matches môžete čítať aj naďalej. Udalosť oznamuje zmenu výsledku, nie každú zmenu veľkosti; nový výsledok poskytuje event.matches. Ak ste obslužnú funkciu zaregistrovali, pri upratovaní zavolajte mql.removeEventListener("change", handler) s tou istou funkciou.
Príklad používa all a jeho negáciu not all, takže výstup nezávisí od veľkosti okna.
Príklady
const always = window.matchMedia("all");
const never = window.matchMedia("not all");
console.log(always.matches);
console.log(never.matches);Výsledok
true false
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.