CKTIS / JavaScript
Window.matchMedia i MediaQueryList.matches
Sprawdź w JavaScripcie, czy zapytanie medialne CSS jest teraz spełnione, i reaguj tylko wtedy, gdy wynik się zmieni.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
const mediaQueryList = window.matchMedia(mediaQueryString);
const matchesNow = mediaQueryList.matches;Wywołaj window.matchMedia(query), przekazując zapytanie medialne CSS jako ciąg znaków. Każde wywołanie zwraca nowy obiekt MediaQueryList, a nie wartość logiczną. Przekaż samo zapytanie, bez @media i bez bloku reguł. Warunek dotyczący cechy medium ujmij w nawiasy: (max-width: 600px) sprawdza, czy szerokość obszaru widoku nie przekracza 600 pikseli CSS, łącznie z wartością graniczną.
Odczytaj list.matches bez nawiasów. To właściwość tylko do odczytu: zwraca true, jeśli lista zapytań jest pusta lub dokument w danej chwili spełnia co najmniej jedno z zapytań na liście rozdzielonej przecinkami, i false w przeciwnym razie. false nie świadczy o błędzie składni. Ponowny odczyt z tego samego obiektu daje bieżący wynik; wcześniej zapisana wartość logiczna nie aktualizuje się sama.
Jeśli potrzebujesz stanu początkowego, odczytaj list.matches, a do śledzenia późniejszych zmian użyj list.addEventListener("change", handler). Zdarzenie pojawia się, gdy wynik zmienia się z true na false lub odwrotnie, a nie przy każdej zmianie rozmiaru. Nowy wynik znajdziesz w event.matches. Gdy nasłuchiwanie nie jest już potrzebne, wywołaj list.removeEventListener("change", handler) z tą samą funkcją.
To interfejs API przeglądarki, a nie część ECMAScript 2024. Nie zakładaj, że jest dostępny w kodzie uruchamianym poza oknem przeglądarki. Jeśli chodzi wyłącznie o zmianę stylów, użyj w CSS reguły @media: matchMedia() niczego samodzielnie nie styluje.
Przykłady
<!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>Wynik
true false
Otwórz plik HTML w przeglądarce i sprawdź wynik w konsoli. `all` pasuje do każdego medium, a `not all` do żadnego, więc zobaczysz kolejno `true` i `false` niezależnie od szerokości obszaru widoku.
Powiązane lekcje
- JavaScript · Lekcja 3 · Zaawansowany · Wersja: 4
- JavaScript · Lekcja 6 · Zaawansowany · Wersja: 4
- JavaScript · Lekcja 7 · Zaawansowany · Wersja: 4
- JavaScript · Lekcja 19 · Zaawansowany · Wersja: 4
- JavaScript · Lekcja 41 · Średniozaawansowany · Wersja: 3
- JavaScript · Lekcja 42 · Średniozaawansowany · Wersja: 3
- JavaScript · Lekcja 43 · Średniozaawansowany · Wersja: 3