Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Window.matchMedia in MediaQueryList.matches

V JavaScriptu preveri, ali je medijska poizvedba CSS trenutno izpolnjena, in se odzovi le ob spremembi rezultata.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

const mediaQueryList = window.matchMedia(mediaQueryString);
const matchesNow = mediaQueryList.matches;

window.matchMedia(query) sprejme medijsko poizvedbo CSS kot niz in ob vsakem klicu vrne nov objekt MediaQueryList, ne logične vrednosti. Podaj samo poizvedbo, brez @media in brez bloka pravil. Pogoje za značilnosti medija postavi v oklepaje: (max-width: 600px) preveri, ali je prikazno območje široko največ 600 slikovnih pik CSS, vključno z mejno vrednostjo.

Lastnost list.matches preberi brez oklepajev. Gre za logično lastnost samo za branje: vrne true, če je seznam medijskih poizvedb prazen ali če dokument trenutno ustreza vsaj eni poizvedbi s seznama, ločenega z vejicami, sicer vrne false. Vrednost false ni znak napake v sintaksi. Ob ponovnem branju istega objekta dobiš trenutni rezultat; prej shranjena logična vrednost se ne posodobi sama.

Če potrebuješ začetno stanje, preberi list.matches, nato pa za spremljanje sprememb uporabi list.addEventListener("change", handler). Dogodek se sproži ob prehodu iz true v false ali obratno, ne ob vsaki spremembi velikosti. Novi rezultat preberi iz event.matches. Ko obvestil ne potrebuješ več, pokliči list.removeEventListener("change", handler) z isto funkcijo.

To je API brskalnika, ne del standarda ECMAScript 2024. Ne predpostavljaj, da je na voljo zunaj okna brskalnika. Če želiš le spremeniti sloge, v CSS uporabi @media: matchMedia() samo ne uveljavi nobenega sloga.

Primeri

<!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>

Rezultat

true
false

Odpri datoteko HTML v brskalniku in preveri izpis v konzoli. `all` ustreza vsakemu mediju in `not all` nobenemu, zato se ne glede na širino prikaznega območja izpiše najprej `true`, nato `false`.

Povezane lekcije

  • JavaScript · Lekcija 3 · Napredna · Različica: 4
  • JavaScript · Lekcija 6 · Napredna · Različica: 4
  • JavaScript · Lekcija 7 · Napredna · Različica: 4
  • JavaScript · Lekcija 19 · Napredna · Različica: 4
  • JavaScript · Lekcija 41 · Srednja · Različica: 3
  • JavaScript · Lekcija 42 · Srednja · Različica: 3
  • JavaScript · Lekcija 43 · Srednja · Različica: 3

Viri