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

CKTIS / JavaScript

MediaQueryList: текущ резултат и събитието change

MediaQueryList позволява да проверите резултата от медийна заявка и да реагирате, когато той се промени. Свойството matches предоставя текущата булева стойност, а събитието change съобщава за преминаване между съвпадение и липса на съвпадение.

Версия: 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("(min-width: 600px)");
mql.matches;
mql.addEventListener("change", handler);
mql.removeEventListener("change", handler);

window.matchMedia(query) връща обект MediaQueryList, който описва резултата от медийна заявка за документа. MediaQueryList.matches е само за четене: true означава съвпадение, а false — липса на съвпадение. Това е свойство, а не метод: прочетете mql.matches, а не mql.matches().

MediaQueryList.change обозначава събитието, наблюдавано чрез mql.addEventListener("change", handler), а не метод с име mql.change(). То се задейства, когато резултатът от заявката се промени между true и false, а не при всяка промяна на размера. При (min-width: 600px) ширина на визуалната област точно 600 CSS пиксела отговаря на условието; промяна от 800 на 900 не променя резултата. Подаденият на обработчика обект MediaQueryListEvent предоставя новия резултат чрез event.matches.

Регистрирането на слушател не извършва първоначалната актуализация. Прочетете и mql.matches, както е показано в примера. При премахване на компонент спрете да слушате чрез removeEventListener("change", handler), като подадете същата препратка към функцията. В примера обработчикът на събитието change извиква директно query.removeEventListener('change', handleChange), ако event.matches има стойност true.

Това е браузърен API от CSSOM View, а не функция на конкретно издание на ECMAScript; версията на Node в хранилището не доказва поддръжката му. MDN посочва, че matches е широко достъпно от юли 2015 г., а change — от септември 2020 г. Проверявайте отделно съвместимостта с по-стари браузъри; остарелият addListener() не се препоръчва за нов код.

Примери

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>MediaQueryList matches and change</title>
</head>
<body>
  <script>
    const frame = document.createElement('iframe');
    frame.title = 'Media query test viewport';
    frame.style.cssText = 'display:block; width:320px; height:60px; border:0';
    frame.srcdoc = '<!doctype html><html lang="en"><head><meta charset="utf-8"><title>Test viewport</title></head><body></body></html>';

    frame.addEventListener('load', () => {
      const query = frame.contentWindow.matchMedia('(min-width: 250px)');
      const report = matches => console.log(matches ? 'wide' : 'narrow');

      function handleChange(event) {
        report(event.matches);
        if (event.matches) {
          query.removeEventListener('change', handleChange);
        } else {
          frame.style.width = '320px';
        }
      }

      query.addEventListener('change', handleChange);
      report(query.matches);
      frame.style.width = '120px';
    }, { once: true });

    document.body.append(frame);
  </script>
</body>
</html>

Резултат

wide
narrow
wide

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

Източници