CKTIS / JavaScript
Window.matchMedia a MediaQueryList.matches
Zisti v JavaScripte, či je mediálny dopyt CSS práve splnený, a reaguj iba vtedy, keď sa výsledok zmení.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
const mediaQueryList = window.matchMedia(mediaQueryString);
const matchesNow = mediaQueryList.matches;window.matchMedia(query) prijíma mediálny dopyt CSS ako reťazec a pri každom volaní vracia nový objekt MediaQueryList, nie logickú hodnotu. Odovzdaj len samotný dopyt, bez @media a bez bloku pravidiel. Podmienky týkajúce sa vlastností média uzavri do zátvoriek: (max-width: 600px) overuje, či šírka zobrazovacej oblasti nepresahuje 600 pixelov CSS vrátane hraničnej hodnoty.
Hodnotu list.matches čítaj bez zátvoriek. Táto logická vlastnosť je len na čítanie: vracia true, ak je zoznam mediálnych dopytov prázdny alebo ak dokument práve vyhovuje aspoň jednému dopytu zo zoznamu oddeleného čiarkami, inak false. Hodnota false neoznamuje syntaktickú chybu. Opakovaným čítaním z toho istého objektu získaš aktuálny výsledok; predtým uložená logická hodnota sa sama neaktualizuje.
Ak potrebuješ počiatočný stav, prečítaj list.matches a potom sleduj zmeny pomocou list.addEventListener("change", handler). Udalosť nastane pri prechode z true na false alebo naopak, nie pri každej zmene veľkosti. Nový výsledok prečítaj z event.matches. Keď oznámenia už nepotrebuješ, zavolaj list.removeEventListener("change", handler) s tou istou funkciou.
Ide o API prehliadača, nie o súčasť ECMAScript 2024. Nepredpokladaj, že je dostupné mimo okna prehliadača. Ak chceš len meniť štýly, použi v CSS @media: matchMedia() samo žiadne štýly neuplatní.
Prí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ýsledok
true false
Otvor súbor HTML v prehliadači a skontroluj výstup v jeho konzole. `all` zodpovedá všetkým médiám a `not all` žiadnemu, takže sa vypíše najprv `true` a potom `false` bez ohľadu na šírku zobrazovacej oblasti.
Súvisiace lekcie
- JavaScript · Lekcia 3 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 6 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 7 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 19 · Pokročilá · Verzia: 4
- JavaScript · Lekcia 41 · Stredne pokročilá · Verzia: 3
- JavaScript · Lekcia 42 · Stredne pokročilá · Verzia: 3
- JavaScript · Lekcia 43 · Stredne pokročilá · Verzia: 3