Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

MediaQueryList: vlastnosť matches a udalosť change

Pomocou `matches` zistíš aktuálny výsledok mediálneho dopytu CSS. Na zmenu výsledku môžeš reagovať pomocou udalosti `change`.

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

Syntax

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) prijíma mediálny dopyt CSS ako reťazec a vracia nový objekt MediaQueryList. Jeho booleovská vlastnosť matches je len na čítanie: má hodnotu true, ak dokument práve spĺňa podmienku dopytu, inak false. Dopyt (max-width: 600px) zahŕňa aj šírku zobrazovacej oblasti presne 600 CSS pixelov.

Zaregistruj funkciu pomocou mql.addEventListener("change", onChange). Prehliadač na tomto objekte MediaQueryList vyvolá udalosť change, keď sa výsledok zmení z false na true alebo naopak, nie pri každej zmene veľkosti. Funkcia dostane objekt MediaQueryListEvent: event.matches obsahuje nový výsledok a event.media text dopytu.

Samotná registrácia funkciu hneď nezavolá. Na inicializáciu stavu prečítaj mql.matches a pri neskorších zmenách používaj event.matches. Keď už upozornenia nepotrebuješ, zavolaj mql.removeEventListener("change", onChange) na rovnakom objekte a odovzdaj tú istú funkciu.

Ide o API prehliadača, nie o súčasť ECMAScriptu 2024. Mimo prehliadača jeho dostupnosť nepredpokladaj. addListener() a removeListener() sú staršie metódy ponechané kvôli kompatibilite; v novom kóde uprednostni addEventListener() a removeEventListener().

Prí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ýsledok

initial: false
change: true
change: false

Otvor v prehliadači `about:blank` a spusti kód v konzole. Kód zmení šírku zobrazovacej oblasti prvku `iframe` z 800 na 600, potom na 500 a späť na 800 CSS pixelov. Pri prechode na 500 nepribudne žiadny riadok. Po odstránení poslucháča nepribudne žiadny riadok ani pri ďalšom prechode na 600.

Súvisiace lekcie

  • JavaScript · Lekcia 29 · Pokročilá · Verzia: 4
  • JavaScript · Lekcia 34 · Pokročilá · Verzia: 4
  • JavaScript · Lekcia 35 · Pokročilá · Verzia: 4
  • JavaScript · Lekcia 36 · Pokročilá · Verzia: 4
  • JavaScript · Lekcia 37 · Pokročilá · Verzia: 4
  • JavaScript · Lekcia 39 · Pokročilá · Verzia: 4
  • JavaScript · Lekcia 45 · Pokročilá · Verzia: 4
  • JavaScript · Lekcia 27 · Stredne pokročilá · Verzia: 3
  • JavaScript · Lekcia 28 · Stredne pokročilá · Verzia: 3
  • JavaScript · Lekcia 29 · Stredne pokročilá · Verzia: 3

Zdroje