Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

Zdroje