CKTIS / JavaScript
MediaQueryList: trenutni rezultat in dogodek change
MediaQueryList omogoča preverjanje rezultata medijske poizvedbe in odziv na njegovo spremembo. Lastnost matches zagotavlja trenutno logično vrednost, dogodek change pa sporoči prehod med ujemanjem in neujemanjem.
Različica: 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) vrne objekt MediaQueryList, ki opisuje rezultat medijske poizvedbe za dokument. MediaQueryList.matches je samo za branje: true pomeni ujemanje, false pa neujemanje. To je lastnost, ne metoda: preberi mql.matches, ne mql.matches().
MediaQueryList.change označuje dogodek, ki ga spremljamo z mql.addEventListener("change", handler), in ne metode z imenom mql.change(). Sproži se, ko se rezultat poizvedbe spremeni med true in false, ne ob vsaki spremembi velikosti. Pri (min-width: 600px) se širina vidnega polja, ki znaša natanko 600 slikovnih pik CSS, ujema s pogojem; sprememba z 800 na 900 rezultata ne spremeni. Objekt MediaQueryListEvent, posredovan funkciji za obravnavo, ponudi nov rezultat kot event.matches.
Registracija poslušalnika ne izvede začetne posodobitve. Preberi tudi mql.matches, kot je prikazano v primeru. Ob odstranitvi komponente prenehaj poslušati z removeEventListener("change", handler) in posreduj isti sklic funkcije. V primeru funkcija za obravnavo dogodka change neposredno pokliče query.removeEventListener('change', handleChange), če ima event.matches vrednost true.
To je API brskalnika iz CSSOM View, ne funkcija določene izdaje ECMAScripta; različica Node v repozitoriju ne dokazuje njegove podpore. MDN navaja, da je matches široko dostopen od julija 2015, change pa od septembra 2020. Združljivost s starejšimi brskalniki preveri posebej; zastareli addListener() ni priporočljiv za novo kodo.
Primeri
<!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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.