CKTIS / JavaScript
Window.matchMedia y MediaQueryList.matches
Comprueba en JavaScript si se cumple una consulta de medios de CSS y reacciona solo cuando cambie el resultado.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
const mediaQueryList = window.matchMedia(mediaQueryString);
const matchesNow = mediaQueryList.matches;window.matchMedia(query) recibe una consulta de medios de CSS como cadena y devuelve un objeto MediaQueryList nuevo en cada llamada, no un booleano. Pasa solo la consulta, sin @media ni un bloque de reglas. Encierra entre paréntesis las condiciones sobre características del medio: (max-width: 600px) comprueba si el área de visualización mide como máximo 600 píxeles CSS de ancho, incluido el límite.
Lee list.matches sin paréntesis. Es una propiedad booleana de solo lectura: vale true si la lista de consultas de medios está vacía o si el documento cumple en ese momento al menos una consulta de la lista separada por comas, y false en caso contrario. false no indica un error de sintaxis. Volver a leer el mismo objeto da el resultado actual; un booleano guardado antes no se actualiza por sí solo.
Si necesitas el estado inicial, lee list.matches y luego usa list.addEventListener("change", handler) para seguir los cambios. El evento se dispara cuando el resultado pasa de true a false o al revés, no con cada cambio de tamaño. Lee el resultado nuevo en event.matches. Cuando ya no necesites avisos, llama a list.removeEventListener("change", handler) con la misma función.
Esta API es del navegador y no forma parte de ECMAScript 2024. No des por hecho que está disponible fuera de una ventana del navegador. Si solo quieres cambiar estilos, usa @media en CSS: matchMedia() no aplica estilos por sí solo.
Ejemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>matchMedia example</title>
</head>
<body>
<script>
console.log(window.matchMedia("all").matches);
console.log(window.matchMedia("not all").matches);
</script>
</body>
</html>Resultado
true false
Abre el archivo HTML en un navegador y consulta la consola. `all` coincide con todos los medios y `not all` con ninguno, así que verás `true` y luego `false`, independientemente del ancho del área de visualización.
Lecciones relacionadas
- JavaScript · Lección 3 · Avanzado · Versión: 4
- JavaScript · Lección 6 · Avanzado · Versión: 4
- JavaScript · Lección 7 · Avanzado · Versión: 4
- JavaScript · Lección 19 · Avanzado · Versión: 4
- JavaScript · Lección 41 · Intermedio · Versión: 3
- JavaScript · Lección 42 · Intermedio · Versión: 3
- JavaScript · Lección 43 · Intermedio · Versión: 3