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