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

CKTIS / JavaScript

MediaQueryList: aktuálny výsledok a udalosť change

MediaQueryList umožňuje zistiť výsledok mediálneho dotazu a reagovať na jeho zmenu. Vlastnosť matches poskytuje aktuálnu booleovskú hodnotu, zatiaľ čo udalosť change oznamuje prechod medzi zhodou a nezhodou.

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

Syntax

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

window.matchMedia(query) vracia objekt MediaQueryList, ktorý opisuje výsledok mediálneho dotazu pre dokument. MediaQueryList.matches je iba na čítanie: true znamená zhodu a false nezhodu. Je to vlastnosť, nie metóda: čítaj mql.matches, nie mql.matches().

MediaQueryList.change označuje udalosť sledovanú pomocou mql.addEventListener("change", handler), nie metódu s názvom mql.change(). Udalosť sa vyvolá, keď sa výsledok dotazu zmení medzi true a false, nie pri každej zmene veľkosti. Pri (min-width: 600px) podmienke zodpovedá šírka zobrazovacej oblasti presne 600 CSS pixelov; zmena z 800 na 900 výsledok nemení. Objekt MediaQueryListEvent odovzdaný obslužnej funkcii sprístupňuje nový výsledok ako event.matches.

Registrácia poslucháča nevykoná počiatočnú aktualizáciu. Prečítaj aj mql.matches, ako v príklade. Pri odstraňovaní komponentu prestaň udalosť počúvať pomocou removeEventListener("change", handler) a odovzdaj tú istú referenciu funkcie. V príklade obslužná funkcia udalosti change volá priamo query.removeEventListener('change', handleChange), ak má event.matches hodnotu true.

Ide o rozhranie prehliadača z CSSOM View, nie o funkciu konkrétnej edície ECMAScriptu; verzia Node v repozitári nedokazuje jeho podporu. MDN uvádza, že matches je široko dostupné od júla 2015 a change od septembra 2020. Kompatibilitu so staršími prehliadačmi over osobitne; zastarané addListener() sa pre nový kód neodporúča.

Príklady

<!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>

Výsledok

wide
narrow
wide

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje