Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Čtení a sledování poměru pixelů pomocí `matchMedia()`

Zjisti, kolik pixelů zařízení připadá na jeden pixel CSS, a sleduj změny tohoto poměru pomocí dotazu na rozlišení.

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

Syntaxe

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 je vlastnost pouze pro čtení. Udává počet pixelů zařízení na jeden pixel CSS; hodnota nemusí být celá. Poměr se může změnit při změně přiblížení stránky v prohlížeči nebo při přesunu okna na obrazovku s jiným měřítkem. Přiblížení gestem dvěma prsty ho nemění.

window.matchMedia() přijímá CSS mediální dotaz jako řetězec a vrací nový objekt MediaQueryList. matches udává aktuální výsledek. Objekt vyvolá událost change, jen když se tato logická hodnota změní. (min-resolution: 2dppx) ověřuje, zda na jeden pixel CSS připadají alespoň dva pixely zařízení; při přechodu z 2 na 3 se prahová hodnota nepřekročí.

Chceš-li sledovat změny DPR, nahraď … aktuální hodnotou v přesném dotazu (resolution: …dppx). Při události change odeber posluchač ze starého objektu, načti nové DPR a zaregistruj posluchač pro nový dotaz. Pokud přesný dotaz zpočátku neplatí, nespoléhej na to, že další změna DPR vyvolá událost. Jakmile posluchač nepotřebuješ, odeber ho.

Tato API patří k rozhraní Window prohlížeče, nikoli k ECMAScriptu 2024 ani ke globálnímu rozsahu workeru. Ověř podporu v cílových prohlížečích; addListener() a removeListener() jsou zastaralé metody ponechané kvůli kompatibilitě.

Příklady

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

Výsledek

DPR: 1
DPR: 2

V konzoli prohlížeče se první řádek vypíše ihned, další po zjištěných změnách. Skutečné hodnoty v prohlížeči se mohou od ukázky lišit. Sledování ukončíš voláním `stopDprWatch()`. V Node.js testovací objekt simuluje změnu DPR z 1 na 2 a sledování skončí před simulovanou změnou na 3.

Související lekce

  • JavaScript · Lekce 34 · Pokročilá · Verze: 4

Zdroje