Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

MediaQueryList: svojstvo matches i događaj change

S pomoću `matches` saznaj trenutačni rezultat CSS medijskog upita, a događaj `change` slušaj kako bi reagirao samo na promjenu rezultata.

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

Sintaksa

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) prima CSS medijski upit kao znakovni niz i vraća novi objekt MediaQueryList. Njegovo Booleovo svojstvo matches samo je za čitanje: iznosi true ako dokument trenutačno zadovoljava uvjet upita, a inače false. Upit (max-width: 600px) obuhvaća i širinu prikaznog područja od točno 600 CSS piksela.

Registriraj funkciju s pomoću mql.addEventListener("change", onChange). Preglednik na tom objektu MediaQueryList pokreće događaj change kad rezultat prijeđe iz false u true ili obrnuto, a ne pri svakoj promjeni veličine. Funkcija prima objekt MediaQueryListEvent: event.matches sadrži novi rezultat, a event.media tekst upita.

Sama registracija ne poziva funkciju odmah. Za početno stanje pročitaj mql.matches, a za kasnije promjene koristi event.matches. Kad ti obavijesti više nisu potrebne, pozovi mql.removeEventListener("change", onChange) na istom objektu i proslijedi istu funkciju.

To je API preglednika, a ne dio standarda ECMAScript 2024. Ne pretpostavljaj da je dostupan izvan preglednika. addListener() i removeListener() starije su metode zadržane radi kompatibilnosti; u novom kodu prednost daj metodama addEventListener() i removeEventListener().

Primjeri

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

Rezultat

initial: false
change: true
change: false

Otvori `about:blank` u pregledniku i pokreni kôd u konzoli. Kôd mijenja širinu prikaznog područja elementa `iframe` s 800 na 600, zatim na 500 i ponovno na 800 CSS piksela. Pri prelasku na 500 ne ispisuje se novi redak. Nakon uklanjanja slušatelja ni pri ponovnom prelasku na 600 ne ispisuje se novi redak.

Povezane lekcije

  • JavaScript · Lekcija 29 · Napredno · Verzija: 4
  • JavaScript · Lekcija 34 · Napredno · Verzija: 4
  • JavaScript · Lekcija 35 · Napredno · Verzija: 4
  • JavaScript · Lekcija 36 · Napredno · Verzija: 4
  • JavaScript · Lekcija 37 · Napredno · Verzija: 4
  • JavaScript · Lekcija 39 · Napredno · Verzija: 4
  • JavaScript · Lekcija 45 · Napredno · Verzija: 4
  • JavaScript · Lekcija 27 · Srednje · Verzija: 3
  • JavaScript · Lekcija 28 · Srednje · Verzija: 3
  • JavaScript · Lekcija 29 · Srednje · Verzija: 3

Izvori