Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła