CKTIS / JavaScript
MediaQueryList: de eigenschap matches en het change-event
Lees `matches` om te zien of een CSS-mediaquery nu van toepassing is en luister naar `change` om alleen op een ander resultaat te reageren.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
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) neemt een CSS-mediaquery als tekenreeks aan en geeft een nieuw MediaQueryList-object terug. De alleen-lezen-eigenschap matches is een booleaanse waarde: true als het document op dat moment aan de query voldoet, anders false. De query (max-width: 600px) geldt ook bij een viewportbreedte van precies 600 CSS-pixels.
Registreer de functie met mql.addEventListener("change", onChange). De browser vuurt change af op dat MediaQueryList-object wanneer het resultaat van false naar true omslaat of andersom, niet bij elke formaatwijziging. De functie krijgt een MediaQueryListEvent: event.matches bevat het nieuwe resultaat en event.media de tekst van de query.
Door de listener te registreren roep je de functie niet meteen aan. Lees mql.matches voor de begintoestand en gebruik event.matches bij latere wijzigingen. Heb je geen updates meer nodig, roep dan mql.removeEventListener("change", onChange) aan op hetzelfde object met dezelfde functie.
Dit is een browser-API, geen onderdeel van ECMAScript 2024. Ga er niet van uit dat de API buiten de browser beschikbaar is. addListener() en removeListener() zijn oudere methoden voor compatibiliteit; gebruik in nieuwe code bij voorkeur addEventListener() en removeEventListener().
Voorbeelden
(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();
})();Resultaat
initial: false change: true change: false
Open `about:blank` in de browser en voer de code uit in de browserconsole. De code stelt de viewportbreedte van het `iframe` in op achtereenvolgens 800, 600, 500 en weer 800 CSS-pixels. Bij 500 komt er geen logregel bij. Nadat de listener is verwijderd, levert de stap terug naar 600 ook geen logregel op.
Gerelateerde lessen
- JavaScript · Les 29 · Gevorderd · Versie: 4
- JavaScript · Les 34 · Gevorderd · Versie: 4
- JavaScript · Les 35 · Gevorderd · Versie: 4
- JavaScript · Les 36 · Gevorderd · Versie: 4
- JavaScript · Les 37 · Gevorderd · Versie: 4
- JavaScript · Les 39 · Gevorderd · Versie: 4
- JavaScript · Les 45 · Gevorderd · Versie: 4
- JavaScript · Les 27 · Gemiddeld · Versie: 3
- JavaScript · Les 28 · Gemiddeld · Versie: 3
- JavaScript · Les 29 · Gemiddeld · Versie: 3