CKTIS / JavaScript
MediaQueryList: vlastnost matches a událost change
Pomocí `matches` zjistíš aktuální výsledek dotazu CSS na média. Událost `change` ti umožní reagovat jen na změnu výsledku.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
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) přijímá dotaz CSS na média jako řetězec a vrací nový objekt MediaQueryList. Jeho booleovská vlastnost matches je jen pro čtení: má hodnotu true, pokud dokument právě splňuje podmínku dotazu, jinak false. Dotaz (max-width: 600px) zahrnuje i šířku zobrazovací oblasti přesně 600 CSS pixelů.
Zaregistruj funkci pomocí mql.addEventListener("change", onChange). Prohlížeč na tomto objektu MediaQueryList vyvolá událost change, když se výsledek změní z false na true nebo naopak, ne při každé změně velikosti. Funkce dostane objekt MediaQueryListEvent: event.matches obsahuje nový výsledek a event.media text dotazu.
Samotná registrace funkci hned nezavolá. Pro počáteční stav přečti mql.matches a pro pozdější změny používej event.matches. Jakmile už oznámení nepotřebuješ, zavolej mql.removeEventListener("change", onChange) na stejném objektu a předej stejnou funkci.
Jde o API prohlížeče, ne o součást ECMAScriptu 2024. Mimo prohlížeč jeho dostupnost nepředpokládej. addListener() a removeListener() jsou starší metody zachované kvůli kompatibilitě; v novém kódu dávej přednost addEventListener() a removeEventListener().
Příklady
(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();
})();Výsledek
initial: false change: true change: false
Otevři v prohlížeči `about:blank` a spusť kód v konzoli. Kód změní šířku zobrazovací oblasti prvku `iframe` z 800 na 600, potom na 500 a zpět na 800 CSS pixelů. Při přechodu na 500 se nový řádek nevypíše. Po odebrání posluchače se ani při dalším přechodu na 600 žádný řádek nevypíše.
Související lekce
- JavaScript · Lekce 29 · Pokročilá · Verze: 4
- JavaScript · Lekce 34 · Pokročilá · Verze: 4
- JavaScript · Lekce 35 · Pokročilá · Verze: 4
- JavaScript · Lekce 36 · Pokročilá · Verze: 4
- JavaScript · Lekce 37 · Pokročilá · Verze: 4
- JavaScript · Lekce 39 · Pokročilá · Verze: 4
- JavaScript · Lekce 45 · Pokročilá · Verze: 4
- JavaScript · Lekce 27 · Středně pokročilá · Verze: 3
- JavaScript · Lekce 28 · Středně pokročilá · Verze: 3
- JavaScript · Lekce 29 · Středně pokročilá · Verze: 3