CKTIS / JavaScript
window.matchMedia — testování mediálních dotazů
window.matchMedia testuje mediální dotaz CSS z JavaScriptu. Vrací MediaQueryList s aktuálním výsledkem v matches a umožňuje sledovat změny v tom, zda dotaz odpovídá.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const mql = window.matchMedia(query);
mql.matches;
mql.media;
mql.addEventListener("change", handler);
mql.removeEventListener("change", handler);window.matchMedia(query) vytvoří nový objekt MediaQueryList, nikoli logickou hodnotu. Aktuální výsledek zjistíte přečtením matches; media obsahuje serializovaný dotaz.
Předejte dotaz CSS, například "(min-width: 768px)", bez @media. Vlastnost média width označuje u spojitých médií šířku zobrazovací oblasti (viewport) a u stránkovaných médií, jako je tisk, šířku rámečku stránky (page box). Jednotka px znamená pixely CSS. Tento dotaz není omezen na typ média screen. Metoda testuje podmínku; sama styly nepoužije.
Jde o rozhraní prohlížeče z CSSOM View, nikoli o funkci ECMAScriptu. Před voláním window.matchMedia(query) ověřte, že platí typeof window !== "undefined" && typeof window.matchMedia === "function"; samotný Node 24 podporu nedokazuje. Tato kontrola neověřuje dostupnost metod pro registraci a odebrání obsluhy událostí na vráceném objektu.
Počáteční výsledek přečtěte z mql.matches, kde mql je vrácený objekt MediaQueryList. Funkci obsluhy zaregistrujte pomocí mql.addEventListener("change", handler) pouze tehdy, když platí typeof mql.addEventListener === "function" && typeof mql.removeEventListener === "function". Pokud některá z metod chybí, registraci vynechte; matches můžete číst i nadále. Událost oznamuje změnu výsledku, nikoli každou změnu velikosti; nový výsledek poskytuje event.matches. Pokud jste funkci obsluhy zaregistrovali, při úklidu zavolejte mql.removeEventListener("change", handler) se stejnou funkcí.
Příklad používá all a jeho negaci not all, takže výstup nezávisí na velikosti okna.
Příklady
const always = window.matchMedia("all");
const never = window.matchMedia("not all");
console.log(always.matches);
console.log(never.matches);Výsledek
true false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.