CKTIS / JavaScript
MediaQueryList: la propiedad matches y el evento change
Lee `matches` para saber si se cumple una consulta de medios CSS y escucha `change` para reaccionar solo cuando cambie el resultado.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
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) recibe una consulta de medios CSS como cadena y devuelve un nuevo objeto MediaQueryList. Su propiedad booleana de solo lectura matches vale true si el documento cumple la consulta en ese momento y false en caso contrario. La consulta (max-width: 600px) incluye un área de visualización de exactamente 600 píxeles CSS de ancho.
Registra la función con mql.addEventListener("change", onChange). El navegador dispara change en ese objeto MediaQueryList cuando el resultado pasa de false a true o viceversa, no con cada cambio de tamaño. La función recibe un MediaQueryListEvent: event.matches contiene el nuevo resultado y event.media, el texto de la consulta.
Registrar la función no hace que se ejecute de inmediato. Lee mql.matches para inicializar el estado y usa event.matches para los cambios posteriores. Cuando ya no necesites recibir avisos, llama a mql.removeEventListener("change", onChange) en el mismo objeto y con la misma función.
Esta es una API del navegador, no forma parte de ECMAScript 2024. No des por hecho que existe fuera del navegador. addListener() y removeListener() son métodos antiguos que se conservan por compatibilidad; en código nuevo, usa preferentemente addEventListener() y removeEventListener().
Ejemplos
(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();
})();Resultado
initial: false change: true change: false
Abre `about:blank` en el navegador y ejecuta el código en su consola. El código cambia el ancho del área de visualización del `iframe` de 800 a 600, luego a 500 y de nuevo a 800 píxeles CSS. El paso a 500 no añade ninguna línea. Tras dejar de escuchar el evento, el código vuelve a cambiar el ancho a 600, también sin añadir ninguna línea.
Lecciones relacionadas
- JavaScript · Lección 29 · Avanzado · Versión: 4
- JavaScript · Lección 34 · Avanzado · Versión: 4
- JavaScript · Lección 35 · Avanzado · Versión: 4
- JavaScript · Lección 36 · Avanzado · Versión: 4
- JavaScript · Lección 37 · Avanzado · Versión: 4
- JavaScript · Lección 39 · Avanzado · Versión: 4
- JavaScript · Lección 45 · Avanzado · Versión: 4
- JavaScript · Lección 27 · Intermedio · Versión: 3
- JavaScript · Lección 28 · Intermedio · Versión: 3
- JavaScript · Lección 29 · Intermedio · Versión: 3