Window matchMedia()Método
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):
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:
Pruébalo »
Otras extensiones
Objeto Window