CKTIS / JavaScript
MediaQueryList.matches — stav shody mediálního dotazu
MediaQueryList.matches je logická vlastnost pouze pro čtení, která udává, zda mediální dotaz odpovídá aktuálnímu stavu dokumentu.
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);
const matches = mql.matches;MediaQueryList.matches vrací true, pokud přidružený seznam mediálních dotazů odpovídá stavu dokumentu, a jinak false. Objekt získáš pomocí window.matchMedia(query). Jde o vlastnost pouze pro čtení, nikoli o metodu: použij mql.matches, ne mql.matches().
Hodnota objektu se může měnit. Dříve uložená logická hodnota se automaticky neaktualizuje. Pokud chceš reagovat na změny shody, poslouchej událost change; samotné čtení vlastnosti posluchač událostí neregistruje.
Příklad používá all a not all, takže jeho výsledek nezávisí na velikosti okna. Jde o webové rozhraní prohlížeče z CSSOM View, nikoli o funkci ECMAScriptu; Node 24 nepotvrzuje jeho dostupnost.
Příklady
const queries = ["all", "not all"];
for (const query of queries) {
const mql = window.matchMedia(query);
console.log(`${query}: ${mql.matches}`);
}Výsledek
all: true not all: 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.