CKTIS / JavaScript
Čítanie a sledovanie pomeru pixelov pomocou `matchMedia()`
Zisti, koľko pixelov zariadenia pripadá na jeden pixel CSS, a sleduj zmeny tohto pomeru pomocou dotazu na rozlíšenie.
Verzia: 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 je vlastnosť len na čítanie. Udáva počet pixelov zariadenia na jeden pixel CSS; hodnota nemusí byť celé číslo. Pomer sa môže zmeniť pri zmene priblíženia stránky v prehliadači alebo pri presunutí okna na obrazovku s inou mierkou. Priblíženie gestom dvoma prstami ho nemení.
window.matchMedia() prijíma mediálny dotaz CSS ako reťazec a vracia nový objekt MediaQueryList. matches udáva aktuálny výsledok. Objekt vyvolá udalosť change, len keď sa táto logická hodnota zmení. (min-resolution: 2dppx) overuje, či na jeden pixel CSS pripadajú aspoň dva pixely zariadenia; pri prechode z 2 na 3 sa prahová hodnota neprekročí.
Ak chceš sledovať zmeny DPR, nahraď … aktuálnou hodnotou v presnom dotaze (resolution: …dppx). Pri udalosti change odstráň poslucháč zo starého objektu, načítaj novú hodnotu DPR a zaregistruj poslucháč pre nový dotaz. Ak presný dotaz spočiatku neplatí, nespoliehaj sa na to, že ďalšia zmena DPR vyvolá udalosť. Aktívny poslucháč odstráň, keď ho už nepotrebuješ.
Tieto API patria k rozhraniu Window prehliadača, nie k ECMAScriptu 2024 ani ku globálnemu rozsahu workera. Over podporu v cieľových prehliadačoch; addListener() a removeListener() sú zastarané metódy ponechané kvôli kompatibilite.
Prí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ýsledok
DPR: 1 DPR: 2
V konzole prehliadača sa prvý riadok vypíše hneď, ďalšie po zistených zmenách. Skutočné hodnoty v prehliadači sa môžu od ukážky líšiť. Sledovanie ukončíš volaním `stopDprWatch()`. V Node.js testovací objekt simuluje zmenu DPR z 1 na 2 a sledovanie sa skončí pred simulovanou zmenou na 3.
Súvisiace lekcie
- JavaScript · Lekcia 34 · Pokročilá · Verzia: 4