Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

MediaQueryList: vlastnost matches a událost change

Pomocí `matches` zjistíš aktuální výsledek dotazu CSS na média. Událost `change` ti umožní reagovat jen na změnu výsledku.

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

Syntaxe

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) přijímá dotaz CSS na média jako řetězec a vrací nový objekt MediaQueryList. Jeho booleovská vlastnost matches je jen pro čtení: má hodnotu true, pokud dokument právě splňuje podmínku dotazu, jinak false. Dotaz (max-width: 600px) zahrnuje i šířku zobrazovací oblasti přesně 600 CSS pixelů.

Zaregistruj funkci pomocí mql.addEventListener("change", onChange). Prohlížeč na tomto objektu MediaQueryList vyvolá událost change, když se výsledek změní z false na true nebo naopak, ne při každé změně velikosti. Funkce dostane objekt MediaQueryListEvent: event.matches obsahuje nový výsledek a event.media text dotazu.

Samotná registrace funkci hned nezavolá. Pro počáteční stav přečti mql.matches a pro pozdější změny používej event.matches. Jakmile už oznámení nepotřebuješ, zavolej mql.removeEventListener("change", onChange) na stejném objektu a předej stejnou funkci.

Jde o API prohlížeče, ne o součást ECMAScriptu 2024. Mimo prohlížeč jeho dostupnost nepředpokládej. addListener() a removeListener() jsou starší metody zachované kvůli kompatibilitě; v novém kódu dávej přednost addEventListener() a removeEventListener().

Příklady

(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();
})();

Výsledek

initial: false
change: true
change: false

Otevři v prohlížeči `about:blank` a spusť kód v konzoli. Kód změní šířku zobrazovací oblasti prvku `iframe` z 800 na 600, potom na 500 a zpět na 800 CSS pixelů. Při přechodu na 500 se nový řádek nevypíše. Po odebrání posluchače se ani při dalším přechodu na 600 žádný řádek nevypíše.

Související lekce

  • JavaScript · Lekce 29 · Pokročilá · Verze: 4
  • JavaScript · Lekce 34 · Pokročilá · Verze: 4
  • JavaScript · Lekce 35 · Pokročilá · Verze: 4
  • JavaScript · Lekce 36 · Pokročilá · Verze: 4
  • JavaScript · Lekce 37 · Pokročilá · Verze: 4
  • JavaScript · Lekce 39 · Pokročilá · Verze: 4
  • JavaScript · Lekce 45 · Pokročilá · Verze: 4
  • JavaScript · Lekce 27 · Středně pokročilá · Verze: 3
  • JavaScript · Lekce 28 · Středně pokročilá · Verze: 3
  • JavaScript · Lekce 29 · Středně pokročilá · Verze: 3

Zdroje