Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje