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

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.

Zdroje