Window.matchMedia()

Resumo

Retorna um novo objeto MediaQueryList (en-US) representando o resultado analisado da string media query (en-US) especificada.

Sintaxe

mql = window.matchMedia(mediaQueryString)

onde mediaQueryString é uma string representando a media query para o qual retorna um novo objeto MediaQueryList (en-US).

Exemplo

if (window.matchMedia("(min-width: 400px)").matches) {
  /* a viewport tem pelo menos 400 pixels de largura */
} else {
  /* a viewport menos que 400 pixels de largura */
}

Este código permite-lhe lidar com as coisas de forma diferente quando a janela é muito estreita.

Veja Usando media queries a partir do código (en-US) para mais exemplos.

Especificações

Especificações Status Comment
CSS Object Model (CSSOM) View Module
The definition of 'Window.matchMedia()' in that specification.
Rascunho atual Initial definition

Compatibilidade do navegador

BCD tables only load in the browser

Veja também