CKTIS / JavaScript
Čitanje i praćenje omjera piksela pomoću `matchMedia()`
Očitaj koliko piksela uređaja odgovara jednom CSS pikselu i prati promjene tog omjera medijskim upitom za razlučivost.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
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 svojstvo je samo za čitanje. Daje broj piksela uređaja po CSS pikselu; vrijednost ne mora biti cijeli broj. Promjena zumiranja stranice u pregledniku ili premještanje prozora na zaslon s drukčijim skaliranjem može promijeniti omjer. Zumiranje gestom dvama prstima ne mijenja ga.
window.matchMedia() prima CSS medijski upit kao znakovni niz i vraća novi objekt MediaQueryList. matches daje trenutačni rezultat. Objekt pokreće događaj change samo kad se ta logička vrijednost promijeni. (min-resolution: 2dppx) provjerava postoje li barem dva piksela uređaja po CSS pikselu; promjena s 2 na 3 ne prelazi taj prag.
Za praćenje promjena DPR-a u točnom upitu (resolution: …dppx) zamijeni … trenutačnom vrijednošću DPR-a. Kad stigne change, ukloni slušatelj sa starog objekta, očitaj novi DPR i registriraj slušatelj na novom upitu. Ako točan upit u početku nije zadovoljen, ne pretpostavljaj da će sljedeća promjena DPR-a pokrenuti događaj. Ukloni aktivni slušatelj kad više nije potreban.
Ti API-ji pripadaju sučelju Window u pregledniku, a ne ECMAScriptu 2024 ni globalnom dosegu workera. Provjeri podršku u ciljanim preglednicima; addListener() i removeListener() zastarjele su metode zadržane radi kompatibilnosti.
Primjeri
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;
})();Rezultat
DPR: 1 DPR: 2
U konzoli preglednika prvi se redak ispisuje odmah, a sljedeći nakon otkrivenih promjena. Stvarne vrijednosti u pregledniku mogu se razlikovati od prikazanih. Za prekid praćenja pozovi `stopDprWatch()`. U Node.js-u testni objekt simulira promjenu DPR-a s 1 na 2, a praćenje prestaje prije simulirane promjene na 3.
Povezane lekcije
- JavaScript · Lekcija 34 · Napredno · Verzija: 4