CKTIS / JavaScript
MediaQueryList: aktuální výsledek a událost change
MediaQueryList umožňuje zjistit výsledek mediálního dotazu a reagovat na jeho změnu. Vlastnost matches poskytuje aktuální logickou hodnotu, zatímco událost change oznamuje přechod mezi shodou a neshodou.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const mql = window.matchMedia("(min-width: 600px)");
mql.matches;
mql.addEventListener("change", handler);
mql.removeEventListener("change", handler);window.matchMedia(query) vrací objekt MediaQueryList, který popisuje výsledek mediálního dotazu pro dokument. MediaQueryList.matches je pouze pro čtení: true znamená shodu a false neshodu. Jde o vlastnost, nikoli metodu: čtěte mql.matches, ne mql.matches().
MediaQueryList.change označuje událost sledovanou pomocí mql.addEventListener("change", handler), nikoli metodu nazvanou mql.change(). Událost se vyvolá, když se výsledek dotazu změní mezi true a false, ne při každé změně velikosti. U (min-width: 600px) podmínce odpovídá šířka zobrazovací oblasti přesně 600 CSS pixelů; změna z 800 na 900 výsledek nemění. Objekt MediaQueryListEvent předaný obslužné funkci zpřístupňuje nový výsledek jako event.matches.
Registrace posluchače neprovede počáteční aktualizaci. Přečtěte také mql.matches, jak ukazuje příklad. Při odstraňování komponenty přestaňte událost poslouchat pomocí removeEventListener("change", handler) a předejte stejnou referenci funkce. V příkladu obslužná funkce události change volá přímo query.removeEventListener('change', handleChange), pokud má event.matches hodnotu true.
Jde o rozhraní prohlížeče z CSSOM View, nikoli o funkci konkrétní edice ECMAScriptu; verze Node v repozitáři nedokládá jeho podporu. MDN uvádí, že matches je široce dostupné od července 2015 a change od září 2020. Kompatibilitu se staršími prohlížeči ověřte zvlášť; zastaralé addListener() se pro nový kód nedoporučuje.
Pří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ýsledek
wide narrow wide
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.