CKTIS / JavaScript
window.matchMedia — sprawdzanie zapytań medialnych
window.matchMedia sprawdza zapytanie medialne CSS z poziomu JavaScript. Zwraca MediaQueryList z bieżącym wynikiem matches i pozwala obserwować zmiany dopasowania.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
const mql = window.matchMedia(query);
mql.matches;
mql.media;
mql.addEventListener("change", handler);
mql.removeEventListener("change", handler);window.matchMedia(query) tworzy nowy MediaQueryList, nie wartość logiczną. Odczytaj matches, aby poznać bieżący wynik; media zawiera zserializowane zapytanie.
Przekaż zapytanie CSS, np. "(min-width: 768px)", bez @media. Cecha medialna width odnosi się do szerokości obszaru widoku w mediach ciągłych, a w mediach stronicowanych, takich jak druk, do szerokości ramki strony (page box). Jednostka px oznacza piksele CSS. To zapytanie nie ogranicza się do typu mediów screen. Metoda sprawdza warunek; sama nie stosuje stylów.
To API przeglądarki z CSSOM View, nie funkcja ECMAScript. Przed wywołaniem window.matchMedia(query) sprawdź typeof window !== "undefined" && typeof window.matchMedia === "function"; samo Node 24 nie dowodzi obsługi. Ten test nie sprawdza dostępności metod obsługi zdarzeń na zwróconym obiekcie.
Odczytaj początkowy wynik z mql.matches, gdzie mql to zwrócony MediaQueryList. Zarejestruj funkcję obsługi za pomocą mql.addEventListener("change", handler) tylko wtedy, gdy typeof mql.addEventListener === "function" && typeof mql.removeEventListener === "function". Jeśli którejś metody brakuje, pomiń rejestrację; nadal możesz odczytywać matches. Zdarzenie sygnalizuje zmianę wyniku, nie każdą zmianę rozmiaru; nowy wynik udostępnia event.matches. Jeśli funkcja obsługi została zarejestrowana, podczas sprzątania wywołaj mql.removeEventListener("change", handler) z tą samą funkcją.
Przykład używa all i jego negacji not all, więc wynik nie zależy od rozmiaru okna.
Przykłady
const always = window.matchMedia("all");
const never = window.matchMedia("not all");
console.log(always.matches);
console.log(never.matches);Wynik
true false
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.