Window matchMedia()Método

Window 对象参考手册Objeto Window


Definición y uso

matchMedia() devuelve un nuevo objeto MediaQueryList, que representa el resultado del análisis de la cadena de consulta de medios especificada.

El valor del método matchMedia() puede ser cualquieraReglas CSS @mediade las características, comomin-height, min-width, orientationetc.

El objeto MediaQueryList tiene las siguientes dos propiedades:

  • media: el contenido de la consulta.
  • matches: se usa para comprobar el resultado de la consulta; si el documento coincide con la lista de consultas de medios, el valor es true; de lo contrario, es false.

MediaQueryListEl objeto también puede escuchar eventos. Mediante la escucha, cuando el resultado de la consulta cambia, se llama a la función de devolución de llamada especificada.

Método Descripción
addListener(functionref) Agrega una nueva función de escucha, que se ejecuta cuando cambia el resultado de la consulta de medios.
removeListener(functionref) Elimina de la lista de consultas de medios el listener agregado anteriormente. Si el listener especificado no está en la lista, no realiza ninguna acción.

Sintaxis

window.matchMedia(mediaQueryString)

Descripción de parámetros:

  • mediaQueryString: obligatorio, una cadena que representa la consulta de medios para la cual se devolverá un nuevo objeto MediaQueryList.

Valor de retorno

Devuelve un objeto MediaQueryList.

Compatibilidad del navegador

Los números en la tabla indican el número de versión del primer navegador que admite este método.

Método
matchMedia() 9.0 10.0 6.0 5.1 12.1

Ejemplo

Ejemplo

Determinar el tamaño de la ventana de la pantalla (screen/viewport):

if (window.matchMedia("(max-width: 700px)").matches) { /*Ventana menor o igual a 700 píxeles*/ } else { /*Ventana mayor de 700 píxeles*/ }

Pruébalo »

Ejemplo

Determina el tamaño de la ventana de la pantalla (screen/viewport); si es menor o igual a 700 píxeles, cambia el color de fondo a amarillo; si es mayor de 700 píxeles, cambia el color de fondo a rosa:

function myFunction(x) { if (x.matches) { //Consulta de medios document.body.style.backgroundColor = "yellow"; } else { document.body.style.backgroundColor = "pink"; } } var x = window.matchMedia("(max-width: 700px)") myFunction(x) //Función de escucha llamada al ejecutarse x.addListener(myFunction) //Agregar un listener cuando cambia el estado

Pruébalo »

Window 对象参考手册Objeto Window

Otras extensiones