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

CKTIS / JavaScript

Четене и проследяване на съотношението на пикселите с `matchMedia()`

Прочети броя пиксели на устройството за един CSS пиксел и проследи промените в това съотношение със заявка за резолюция.

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

Синтаксис

window.devicePixelRatio // read-only number
window.matchMedia(mediaQueryString) // returns a new MediaQueryList
window.matchMedia(`(resolution: ${window.devicePixelRatio}dppx)`)
window.matchMedia('(min-resolution: 2dppx)').matches // boolean
query.addEventListener('change', listener)
query.removeEventListener('change', listener)

window.devicePixelRatio е свойство само за четене. То показва колко пиксела на устройството се падат на един CSS пиксел; стойността може да е дробна. Промяна на мащаба на страницата в браузъра или преместване на прозореца върху екран с различно мащабиране може да промени съотношението. Жестът за увеличение с два пръста не го променя.

window.matchMedia() приема CSS медийна заявка като низ и връща нов обект MediaQueryList. matches дава текущия резултат. Обектът поражда събитието change само при промяна на тази булева стойност. (min-resolution: 2dppx) проверява за най-малко два пиксела на устройството на един CSS пиксел; промяна от 2 на 3 не преминава този праг.

За да проследяваш промените в DPR, замени … с текущата стойност в точната заявка (resolution: …dppx). При change премахни слушателя от стария обект, прочети новата стойност на DPR и регистрирай слушателя за нова заявка. Ако точната заявка не е изпълнена в началото, не разчитай, че следващата промяна на DPR ще породи събитието. Премахни активния слушател, когато вече не ти е нужен.

Тези API принадлежат към Window на браузъра, а не към ECMAScript 2024 или глобалния обхват на worker. Провери поддръжката в целевите браузъри; addListener() и removeListener() са остарели методи, запазени за съвместимост.

Примери

function watchDpr(viewport) {
  let query;

  function stop() {
    query?.removeEventListener('change', update);
    query = undefined;
  }

  function update() {
    stop();
    const dpr = viewport.devicePixelRatio;
    query = viewport.matchMedia(`(resolution: ${dpr}dppx)`);
    query.addEventListener('change', update);
    console.log(`DPR: ${dpr}`);
  }

  update();
  return stop;
}

// Node.js test fixture: models only exact-resolution media queries.
function createTestWindow(dpr) {
  const queries = [];

  return {
    get devicePixelRatio() { return dpr; },

    matchMedia(media) {
      const [, value] = /^\(resolution: (.+)dppx\)$/.exec(media);
      const resolution = Number(value);
      const query = new EventTarget();
      Object.defineProperty(query, 'matches', { get: () => dpr === resolution });
      queries.push(query);
      return query;
    },

    setDpr(nextDpr) {
      // Snapshot the queries before listeners can create new ones.
      const previous = queries.map(query => [query, query.matches]);
      dpr = nextDpr;
      for (const [query, matched] of previous) {
        if (query.matches !== matched) {
          query.dispatchEvent(new Event('change'));
        }
      }
    },
  };
}

const stopDprWatch = (() => {
  if (typeof window !== 'undefined') return watchDpr(window);

  const testWindow = createTestWindow(1);
  const stop = watchDpr(testWindow);
  testWindow.setDpr(2);
  stop();
  testWindow.setDpr(3); // The watcher should not log after cleanup.
  return stop;
})();

Резултат

DPR: 1
DPR: 2

В конзолата на браузъра първият ред се извежда веднага, а следващите — при засечени промени. Действителните стойности в браузъра може да се различават от показаните. Извикай `stopDprWatch()`, за да спреш проследяването. В Node.js тестов обект симулира промяна на DPR от 1 на 2, а проследяването спира преди симулираната промяна до 3.

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

  • JavaScript · Урок 34 · Напреднало · Версия: 4

Източници