Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Odczyt i obserwowanie DPR za pomocą `matchMedia()`

Odczytaj liczbę pikseli urządzenia na piksel CSS i dowiedz się, jak obserwować zmiany tej wartości za pomocą zapytania o rozdzielczość.

Wersja: ECMAScript 2024 and the current web platform; runtime support varies

Składnia

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 to właściwość tylko do odczytu. Zwraca liczbę pikseli urządzenia przypadających na jeden piksel CSS; wynik nie musi być całkowity. Zmiana poziomu powiększenia strony w przeglądarce lub przeniesienie okna na ekran o innej skali może zmienić ten współczynnik. Powiększanie gestem dwóch palców go nie zmienia.

window.matchMedia() przyjmuje zapytanie medialne CSS jako tekst i zwraca nowy obiekt MediaQueryList. Właściwość matches informuje, czy dokument obecnie spełnia warunek. Zdarzenie change jest emitowane na tym obiekcie tylko wtedy, gdy wynik logiczny się zmienia. (min-resolution: 2dppx) sprawdza próg co najmniej dwóch pikseli urządzenia na piksel CSS; zmiana z 2 na 3 nie przekracza progu.

Aby śledzić zmiany DPR, utwórz zapytanie o dokładną wartość: (resolution: …dppx), gdzie … zastępujesz bieżącym DPR. Po zdarzeniu change usuń funkcję obsługującą ze starego obiektu, odczytaj nowy DPR i zarejestruj ją dla nowego zapytania. Jeśli dokładne zapytanie od początku nie pasuje, nie zakładaj, że następna zmiana DPR wywoła zdarzenie. Zakończ obserwację, gdy nie jest już potrzebna.

Obie funkcje platformy są dostępne przez Window przeglądarki; nie należą do ECMAScript 2024 ani do globalnego środowiska workera. Sprawdź obsługę w docelowych przeglądarkach; addListener() i removeListener() to przestarzałe odpowiedniki służące zgodności wstecznej.

Przykłady

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;
})();

Wynik

DPR: 1
DPR: 2

W konsoli przeglądarki pierwszy wiersz pojawia się od razu, a kolejne po wykrytych zmianach. Rzeczywiste wartości mogą się różnić od pokazanych. Wywołaj `stopDprWatch()`, aby zakończyć obserwację. W Node.js obiekt testowy symuluje zmianę DPR z 1 na 2, a obserwacja kończy się przed symulowaną zmianą na 3.

Powiązane lekcje

  • JavaScript · Lekcja 34 · Zaawansowany · Wersja: 4

Źródła