Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje