База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

window.matchMedia — проверка на медийни заявки

window.matchMedia проверява CSS медийна заявка от JavaScript. Връща MediaQueryList с текущия резултат в matches и позволява да се наблюдават промените в това дали заявката съвпада.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

const mql = window.matchMedia(query);
mql.matches;
mql.media;
mql.addEventListener("change", handler);
mql.removeEventListener("change", handler);

window.matchMedia(query) създава нова MediaQueryList, а не булева стойност. Прочетете matches, за да получите текущия резултат; media съдържа сериализираната заявка.

Подайте CSS заявка, например "(min-width: 768px)", без @media. Медийната характеристика width се отнася до ширината на областта за визуализация (viewport) при непрекъснати медии и до ширината на рамката на страницата (page box) при медии, разделени на страници, като например при печат. Единицата px означава CSS пиксели. Тази заявка не е ограничена до медийния тип screen. Методът проверява условие; сам по себе си не прилага стилове.

Това е API на браузъра от CSSOM View, а не функция на ECMAScript. Преди да извикате window.matchMedia(query), проверете дали е изпълнено условието typeof window !== "undefined" && typeof window.matchMedia === "function"; само Node 24 не доказва поддръжка. Тази проверка не установява дали върнатият обект разполага с методите за добавяне и премахване на слушатели за събития.

Прочетете началния резултат от mql.matches, където mql е върнатият обект MediaQueryList. Регистрирайте функцията за обработка на събитието чрез mql.addEventListener("change", handler) само ако typeof mql.addEventListener === "function" && typeof mql.removeEventListener === "function". Ако някой от методите липсва, пропуснете регистрацията; все още можете да четете matches. Събитието сигнализира за промяна в резултата, а не за всяка промяна на размера; event.matches предоставя новия резултат. Ако сте регистрирали функцията, при почистване извикайте mql.removeEventListener("change", handler) със същата функция.

Примерът използва all и неговото отрицание not all, така че резултатът не зависи от размера на прозореца.

Примери

const always = window.matchMedia("all");
const never = window.matchMedia("not all");
console.log(always.matches);
console.log(never.matches);

Резултат

true
false

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници