KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Lees en volg de pixelverhouding met `matchMedia()`

Lees hoeveel apparaatpixels overeenkomen met één CSS-pixel en volg veranderingen in die verhouding met een mediaquery voor de resolutie.

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

Syntax

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 is een alleen-lezen eigenschap. Ze geeft het aantal apparaatpixels per CSS-pixel; dat hoeft geen geheel getal te zijn. Het zoomniveau van de pagina in de browser of het verplaatsen van het venster naar een scherm met een andere schaalfactor kan de verhouding veranderen. Zoomen met een knijpgebaar verandert haar niet.

window.matchMedia() krijgt een CSS-mediaquery als tekenreeks en geeft een nieuw MediaQueryList-object terug. matches geeft het huidige resultaat. Het object verstuurt change alleen als die booleaanse waarde verandert. (min-resolution: 2dppx) test op minstens twee apparaatpixels per CSS-pixel; een overgang van 2 naar 3 gaat niet over die drempel heen.

Vervang om DPR-wijzigingen te volgen … door de huidige DPR in de exacte query (resolution: …dppx). Verwijder bij change de listener van het oude object, lees de nieuwe DPR en registreer de listener bij een nieuwe query. Als de exacte query aanvankelijk niet matcht, ga er dan niet van uit dat de volgende DPR-wijziging het event activeert. Verwijder de actieve listener zodra je die niet meer nodig hebt.

Deze API’s horen bij Window in de browser, niet bij ECMAScript 2024 of het globale bereik van een worker. Controleer de ondersteuning in je doelbrowsers; addListener() en removeListener() zijn verouderde compatibiliteitsmethoden.

Voorbeelden

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

Resultaat

DPR: 1
DPR: 2

In de browserconsole verschijnt de eerste regel meteen; volgende regels verschijnen na gedetecteerde wijzigingen. De waarden in de browser kunnen afwijken van de getoonde waarden. Roep `stopDprWatch()` aan om te stoppen. In Node.js simuleert een testobject een DPR-wijziging van 1 naar 2 en stopt de watcher vóór de gesimuleerde wijziging naar 3.

Gerelateerde lessen

  • JavaScript · Les 34 · Gevorderd · Versie: 4

Bronnen