Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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

Fuentes