CKTIS / JavaScript
Window.matchMedia a MediaQueryList.matches
Zjisti v JavaScriptu, zda je dotaz na médium v CSS právě splněn, a reaguj jen tehdy, když se výsledek změní.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
const mediaQueryList = window.matchMedia(mediaQueryString);
const matchesNow = mediaQueryList.matches;window.matchMedia(query) přijímá dotaz na médium v CSS jako řetězec a při každém volání vrací nový objekt MediaQueryList, nikoli logickou hodnotu. Předej jen samotný dotaz, bez @media a bez bloku pravidel. Podmínky týkající se vlastností média uzavři do závorek: (max-width: 600px) ověřuje, zda šířka zobrazovací oblasti nepřesahuje 600 CSS pixelů, včetně mezní hodnoty.
Hodnotu list.matches čti bez závorek. Tato logická vlastnost je jen pro čtení: vrací true, pokud je seznam dotazů na média prázdný nebo pokud dokument právě vyhovuje alespoň jednomu dotazu ze seznamu odděleného čárkami, jinak false. Hodnota false neoznamuje syntaktickou chybu. Opětovným čtením ze stejného objektu získáš aktuální výsledek; dříve uložená logická hodnota se sama neaktualizuje.
Pokud potřebuješ počáteční stav, přečti list.matches a potom sleduj změny pomocí list.addEventListener("change", handler). Událost nastane při přechodu z true na false nebo naopak, ne při každé změně velikosti. Nový výsledek přečti z event.matches. Až upozornění nebudeš potřebovat, zavolej list.removeEventListener("change", handler) se stejnou funkcí.
Jde o API prohlížeče, nikoli o součást ECMAScript 2024. Nepředpokládej, že je dostupné mimo okno prohlížeče. Pokud chceš jen měnit styly, použij v CSS @media: matchMedia() samo žádné styly nepoužije.
Příklady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>matchMedia example</title>
</head>
<body>
<script>
console.log(window.matchMedia("all").matches);
console.log(window.matchMedia("not all").matches);
</script>
</body>
</html>Výsledek
true false
Otevři soubor HTML v prohlížeči a zkontroluj výstup v jeho konzoli. `all` odpovídá všem médiím a `not all` žádnému, takže se vypíše nejprve `true` a potom `false` bez ohledu na šířku zobrazovací oblasti.
Související lekce
- JavaScript · Lekce 3 · Pokročilá · Verze: 4
- JavaScript · Lekce 6 · Pokročilá · Verze: 4
- JavaScript · Lekce 7 · Pokročilá · Verze: 4
- JavaScript · Lekce 19 · Pokročilá · Verze: 4
- JavaScript · Lekce 41 · Středně pokročilá · Verze: 3
- JavaScript · Lekce 42 · Středně pokročilá · Verze: 3
- JavaScript · Lekce 43 · Středně pokročilá · Verze: 3