Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

MediaQueryList: trenutačni rezultat i događaj change

MediaQueryList omogućuje provjeru rezultata medijskog upita i reakciju na njegovu promjenu. Svojstvo matches daje trenutačnu logičku vrijednost, a događaj change javlja prijelaz između podudaranja i nepodudaranja.

Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

const mql = window.matchMedia("(min-width: 600px)");
mql.matches;
mql.addEventListener("change", handler);
mql.removeEventListener("change", handler);

window.matchMedia(query) vraća objekt MediaQueryList koji opisuje rezultat medijskog upita za dokument. MediaQueryList.matches je samo za čitanje: true znači podudaranje, a false nepodudaranje. To je svojstvo, a ne metoda: čitaj mql.matches, a ne mql.matches().

MediaQueryList.change označava događaj koji se prati pomoću mql.addEventListener("change", handler), a ne metodu naziva mql.change(). Aktivira se kada se rezultat upita promijeni između true i false, a ne pri svakoj promjeni veličine. Za (min-width: 600px) širina područja prikaza od točno 600 CSS piksela zadovoljava uvjet; promjena s 800 na 900 ne mijenja rezultat. Objekt MediaQueryListEvent proslijeđen funkciji za obradu izlaže novi rezultat kao event.matches.

Registriranje slušatelja ne izvršava početno ažuriranje. Pročitaj i mql.matches, kao što je prikazano u primjeru. Pri uklanjanju komponente prestani slušati pomoću removeEventListener("change", handler) i proslijedi istu referencu funkcije. U primjeru funkcija za obradu događaja change izravno poziva query.removeEventListener('change', handleChange) ako event.matches ima vrijednost true.

Ovo je API preglednika iz CSSOM View, a ne značajka određene edicije ECMAScripta; verzija Nodea u repozitoriju ne dokazuje njegovu podršku. MDN navodi da je matches široko dostupan od srpnja 2015., a change od rujna 2020. Kompatibilnost sa starijim preglednicima provjeri zasebno; zastarjeli addListener() ne preporučuje se za novi kod.

Primjeri

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>MediaQueryList matches and change</title>
</head>
<body>
  <script>
    const frame = document.createElement('iframe');
    frame.title = 'Media query test viewport';
    frame.style.cssText = 'display:block; width:320px; height:60px; border:0';
    frame.srcdoc = '<!doctype html><html lang="en"><head><meta charset="utf-8"><title>Test viewport</title></head><body></body></html>';

    frame.addEventListener('load', () => {
      const query = frame.contentWindow.matchMedia('(min-width: 250px)');
      const report = matches => console.log(matches ? 'wide' : 'narrow');

      function handleChange(event) {
        report(event.matches);
        if (event.matches) {
          query.removeEventListener('change', handleChange);
        } else {
          frame.style.width = '320px';
        }
      }

      query.addEventListener('change', handleChange);
      report(query.matches);
      frame.style.width = '120px';
    }, { once: true });

    document.body.append(frame);
  </script>
</body>
</html>

Rezultat

wide
narrow
wide

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori