Метод Window matchMedia()Method

Window 对象参考手册Объект Window


Определение и использование

matchMedia() возвращает новый объект MediaQueryList, представляющий результат разбора указанной строки медиазапроса.

Значением метода matchMedia() может быть любая изфункций правил CSS @media, таких какmin-height, min-width, orientationи т. д.

Объект MediaQueryList имеет следующие два свойства:

  • media: содержимое запроса.
  • matches: используется для проверки результата запроса. Если документ соответствует списку медиазапросов, значение равно true; в противном случае — false.

MediaQueryListОбъект также может прослушивать события. При прослушивании, когда результат запроса изменяется, вызывается указанная функция обратного вызова.

Метод Описание
addListener(functionref) Добавляет новую функцию прослушивателя, которая выполняется при изменении результата медиазапроса.
removeListener(functionref) Удаляет ранее добавленный прослушиватель из списка медиазапросов. Если указанного прослушивателя нет в списке, никаких действий не выполняется.

Синтаксис

window.matchMedia(mediaQueryString)

Описание параметра:

  • mediaQueryString: Обязательный. Строка, представляющая медиазапрос, для которого будет возвращен новый объект MediaQueryList.

Возвращаемое значение

Возвращает объект MediaQueryList.

Поддержка браузеров

Числа в таблице указывают первую версию браузера, которая поддерживает этот метод.

Метод
matchMedia() 9.0 10.0 6.0 5.1 12.1

Примеры

Примеры

Определите размер окна экрана (экран/область просмотра):

if (window.matchMedia("(max-width: 700px)").matches) { /*Окно меньше или равно 700 пикселям*/ } else { /*Окно больше 700 пикселей*/ }

Попробуйте сами »

Примеры

Определите размер окна экрана (экран/область просмотра). Когда он меньше или равен 700 пикселям, измените цвет фона на желтый; когда он больше 700 пикселей, измените цвет фона на розовый:

function myFunction(x) { if (x.matches) { //Медиазапрос document.body.style.backgroundColor = "yellow"; } else { document.body.style.backgroundColor = "pink"; } } var x = window.matchMedia("(max-width: 700px)") myFunction(x) //Функция-слушатель, вызываемая при выполнении x.addListener(myFunction) //Добавить слушателя при изменении состояния

Попробуйте сами »

Window 对象参考手册Объект Window

Другие расширения