Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

MediaQueryList: lastnost matches in dogodek change

Z `matches` prebereš trenutni rezultat medijske poizvedbe CSS, z dogodkom `change` pa se odzoveš le na spremembo rezultata.

Različica: 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) sprejme medijsko poizvedbo CSS kot niz in vrne nov objekt MediaQueryList. Njegova logična lastnost matches je samo za branje: ima vrednost true, če dokument trenutno ustreza poizvedbi, sicer false. Poizvedba (max-width: 600px) vključuje tudi prikazno območje, široko natanko 600 slikovnih pik CSS.

Funkcijo registriraj z mql.addEventListener("change", onChange). Brskalnik na tem objektu MediaQueryList sproži dogodek change, ko se rezultat spremeni iz false v true ali obratno, ne ob vsaki spremembi velikosti. Funkcija prejme objekt MediaQueryListEvent: event.matches vsebuje nov rezultat, event.media pa besedilo poizvedbe.

Registracija funkcije ne pokliče takoj. Za začetno stanje preberi mql.matches, za poznejše spremembe pa uporabi event.matches. Ko obvestil ne potrebuješ več, na istem objektu pokliči mql.removeEventListener("change", onChange) in posreduj isto funkcijo.

To je API brskalnika, ne del standarda ECMAScript 2024. Ne predvidevaj, da je na voljo zunaj brskalnika. addListener() in removeListener() sta starejši metodi, ohranjeni zaradi združljivosti; v novi kodi raje uporabi addEventListener() in removeEventListener().

Primeri

(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

V brskalniku odpri `about:blank` in zaženi kodo v konzoli. Koda spremeni širino prikaznega območja elementa `iframe` z 800 na 600, nato na 500 in nazaj na 800 slikovnih pik CSS. Pri prehodu na 500 se ne izpiše nova vrstica. Ko koda odstrani poslušalca, se tudi ob ponovnem prehodu na 600 ne izpiše nova vrstica.

Povezane lekcije

  • JavaScript · Lekcija 29 · Napredna · Različica: 4
  • JavaScript · Lekcija 34 · Napredna · Različica: 4
  • JavaScript · Lekcija 35 · Napredna · Različica: 4
  • JavaScript · Lekcija 36 · Napredna · Različica: 4
  • JavaScript · Lekcija 37 · Napredna · Različica: 4
  • JavaScript · Lekcija 39 · Napredna · Različica: 4
  • JavaScript · Lekcija 45 · Napredna · Različica: 4
  • JavaScript · Lekcija 27 · Srednja · Različica: 3
  • JavaScript · Lekcija 28 · Srednja · Različica: 3
  • JavaScript · Lekcija 29 · Srednja · Različica: 3

Viri