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

CKTIS / JavaScript

MediaQueryList: свойството matches и събитието change

Прочети `matches`, за да разбереш текущия резултат от CSS медийна заявка, и слушай за `change`, за да реагираш само при промяна на резултата.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

const mql = window.matchMedia(mediaQueryString);

function onChange(event) {
  update(event.matches);
}

mql.addEventListener("change", onChange);
update(mql.matches);

// When observation is no longer needed:
mql.removeEventListener("change", onChange);

window.matchMedia(mediaQueryString) приема CSS медийна заявка като низ и връща нов обект MediaQueryList. Булевото му свойство matches е само за четене: то е true, ако документът в момента отговаря на заявката, и false в противен случай. Заявката (max-width: 600px) включва и ширина на видимата област от точно 600 CSS пиксела.

Регистрирай функцията с mql.addEventListener("change", onChange). Браузърът задейства change върху този обект MediaQueryList, когато резултатът се смени от false на true или обратно, а не при всяка промяна на размера. Функцията получава обект MediaQueryListEvent: event.matches съдържа новия резултат, а event.media — текста на заявката.

Регистрирането на функцията не я извиква веднага. За началното състояние прочети mql.matches, а при следващите промени използвай event.matches. Когато известията вече не са нужни, извикай mql.removeEventListener("change", onChange) върху същия обект и подай същата функция.

Това е API на браузъра, а не част от ECMAScript 2024. Не приемай, че е наличен извън браузъра. addListener() и removeListener() са по-стари методи, запазени за съвместимост; в нов код предпочитай addEventListener() и removeEventListener().

Примери

(async () => {
  const frame = document.createElement("iframe");
  frame.style.cssText = "display: block; width: 800px; height: 80px; border: 0";
  frame.srcdoc = "<!doctype html><title>Media query demo</title>";

  const loaded = new Promise((resolve) => {
    frame.addEventListener("load", resolve, { once: true });
  });
  document.body.append(frame);
  await loaded;

  const view = frame.contentWindow;
  // Give the browser time to render and report media query changes.
  const afterRendering = () => new Promise((resolve) => {
    view.requestAnimationFrame(() => view.requestAnimationFrame(resolve));
  });
  await afterRendering();

  const mql = view.matchMedia("(max-width: 600px)");
  const onChange = (event) => console.log(`change: ${event.matches}`);

  mql.addEventListener("change", onChange);
  console.log(`initial: ${mql.matches}`);

  for (const width of [600, 500, 800]) {
    frame.style.width = `${width}px`;
    await afterRendering();
  }

  mql.removeEventListener("change", onChange);
  frame.style.width = "600px";
  await afterRendering();
  frame.remove();
})();

Резултат

initial: false
change: true
change: false

Отвори `about:blank` в браузъра и изпълни кода в конзолата. Кодът променя ширината на видимата област на `iframe` от 800 на 600, после на 500 и обратно на 800 CSS пиксела. При преминаване към 500 не се извежда нов ред. След премахването на слушателя повторното преминаване към 600 също не извежда нов ред.

Свързани уроци

  • JavaScript · Урок 29 · Напреднало · Версия: 4
  • JavaScript · Урок 34 · Напреднало · Версия: 4
  • JavaScript · Урок 35 · Напреднало · Версия: 4
  • JavaScript · Урок 36 · Напреднало · Версия: 4
  • JavaScript · Урок 37 · Напреднало · Версия: 4
  • JavaScript · Урок 39 · Напреднало · Версия: 4
  • JavaScript · Урок 45 · Напреднало · Версия: 4
  • JavaScript · Урок 27 · Средно · Версия: 3
  • JavaScript · Урок 28 · Средно · Версия: 3
  • JavaScript · Урок 29 · Средно · Версия: 3

Източници