CKTIS / JavaScript
MediaQueryList: svojstvo matches i događaj change
S pomoću `matches` saznaj trenutačni rezultat CSS medijskog upita, a događaj `change` slušaj kako bi reagirao samo na promjenu rezultata.
Verzija: 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) prima CSS medijski upit kao znakovni niz i vraća novi objekt MediaQueryList. Njegovo Booleovo svojstvo matches samo je za čitanje: iznosi true ako dokument trenutačno zadovoljava uvjet upita, a inače false. Upit (max-width: 600px) obuhvaća i širinu prikaznog područja od točno 600 CSS piksela.
Registriraj funkciju s pomoću mql.addEventListener("change", onChange). Preglednik na tom objektu MediaQueryList pokreće događaj change kad rezultat prijeđe iz false u true ili obrnuto, a ne pri svakoj promjeni veličine. Funkcija prima objekt MediaQueryListEvent: event.matches sadrži novi rezultat, a event.media tekst upita.
Sama registracija ne poziva funkciju odmah. Za početno stanje pročitaj mql.matches, a za kasnije promjene koristi event.matches. Kad ti obavijesti više nisu potrebne, pozovi mql.removeEventListener("change", onChange) na istom objektu i proslijedi istu funkciju.
To je API preglednika, a ne dio standarda ECMAScript 2024. Ne pretpostavljaj da je dostupan izvan preglednika. addListener() i removeListener() starije su metode zadržane radi kompatibilnosti; u novom kodu prednost daj metodama addEventListener() i removeEventListener().
Primjeri
(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
Otvori `about:blank` u pregledniku i pokreni kôd u konzoli. Kôd mijenja širinu prikaznog područja elementa `iframe` s 800 na 600, zatim na 500 i ponovno na 800 CSS piksela. Pri prelasku na 500 ne ispisuje se novi redak. Nakon uklanjanja slušatelja ni pri ponovnom prelasku na 600 ne ispisuje se novi redak.
Povezane lekcije
- JavaScript · Lekcija 29 · Napredno · Verzija: 4
- JavaScript · Lekcija 34 · Napredno · Verzija: 4
- JavaScript · Lekcija 35 · Napredno · Verzija: 4
- JavaScript · Lekcija 36 · Napredno · Verzija: 4
- JavaScript · Lekcija 37 · Napredno · Verzija: 4
- JavaScript · Lekcija 39 · Napredno · Verzija: 4
- JavaScript · Lekcija 45 · Napredno · Verzija: 4
- JavaScript · Lekcija 27 · Srednje · Verzija: 3
- JavaScript · Lekcija 28 · Srednje · Verzija: 3
- JavaScript · Lekcija 29 · Srednje · Verzija: 3