Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

MediaQueryList: właściwość matches i zdarzenie change

Odczytaj `matches`, aby poznać bieżący wynik zapytania o media, i nasłuchuj `change`, aby reagować tylko na jego zmianę.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

const mql = window.matchMedia(mediaQueryString);

function onChange(event) {
  update(event.matches);
}

mql.addEventListener("change", onChange);
update(mql.matches);

// When observation is no longer needed:
mql.removeEventListener("change", onChange);

window.matchMedia(mediaQueryString) przyjmuje zapytanie o media w składni CSS i zwraca nowy obiekt MediaQueryList. Jego właściwość matches jest wartością logiczną tylko do odczytu: zwraca true, jeśli dokument obecnie spełnia warunek zapytania, a w przeciwnym razie false. Zapytanie (max-width: 600px) obejmuje szerokość obszaru widoku równą 600 pikselom CSS.

Zarejestruj funkcję za pomocą mql.addEventListener("change", onChange). Zdarzenie change jest wysyłane do tego obiektu MediaQueryList, gdy wynik zapytania zmienia się z false na true lub odwrotnie, a nie przy każdej zmianie rozmiaru. Funkcja otrzymuje obiekt MediaQueryListEvent: event.matches zawiera nowy wynik, a event.media — tekst zapytania.

Samo dodanie nasłuchu nie wywołuje funkcji od razu. Zainicjuj stan przez odczyt mql.matches, a późniejsze zmiany obsługuj za pomocą event.matches. Gdy nasłuch nie jest już potrzebny, wywołaj mql.removeEventListener("change", onChange) na tym samym obiekcie, przekazując tę samą funkcję.

To API przeglądarki, a nie część ECMAScript 2024. Nie zakładaj, że jest dostępne w środowisku bez przeglądarki. addListener() i removeListener() to starsza para metod używana dla zgodności; w nowych projektach wybieraj addEventListener() i removeEventListener().

Przykłady

(async () => {
  const frame = document.createElement("iframe");
  frame.style.cssText = "display: block; width: 800px; height: 80px; border: 0";
  frame.srcdoc = "<!doctype html><title>Media query demo</title>";

  const loaded = new Promise((resolve) => {
    frame.addEventListener("load", resolve, { once: true });
  });
  document.body.append(frame);
  await loaded;

  const view = frame.contentWindow;
  // Give the browser time to render and report media query changes.
  const afterRendering = () => new Promise((resolve) => {
    view.requestAnimationFrame(() => view.requestAnimationFrame(resolve));
  });
  await afterRendering();

  const mql = view.matchMedia("(max-width: 600px)");
  const onChange = (event) => console.log(`change: ${event.matches}`);

  mql.addEventListener("change", onChange);
  console.log(`initial: ${mql.matches}`);

  for (const width of [600, 500, 800]) {
    frame.style.width = `${width}px`;
    await afterRendering();
  }

  mql.removeEventListener("change", onChange);
  frame.style.width = "600px";
  await afterRendering();
  frame.remove();
})();

Wynik

initial: false
change: true
change: false

Otwórz `about:blank` w przeglądarce i uruchom kod w konsoli. Kod sam zmienia szerokość obszaru widoku ramki `iframe` z 800 na 600, 500 i z powrotem na 800 pikseli CSS. Przy 500 nie pojawia się nowy wpis. Po usunięciu nasłuchu ponowne ustawienie szerokości na 600 również nie dodaje wpisu.

Powiązane lekcje

  • JavaScript · Lekcja 29 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 34 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 35 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 36 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 37 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 39 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 45 · Zaawansowany · Wersja: 4
  • JavaScript · Lekcja 27 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 28 · Średniozaawansowany · Wersja: 3
  • JavaScript · Lekcja 29 · Średniozaawansowany · Wersja: 3

Źródła