CKTIS / JavaScript
Leggere e monitorare il rapporto tra pixel con `matchMedia()`
Leggi quanti pixel del dispositivo corrispondono a un pixel CSS e usa una media query sulla risoluzione per rilevare le variazioni.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
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 è una proprietà di sola lettura. Indica il numero di pixel del dispositivo per pixel CSS, che può essere frazionario. Lo zoom della pagina nel browser o lo spostamento della finestra su uno schermo con una scala diversa può cambiare il rapporto. Lo zoom con il gesto a due dita non lo cambia.
window.matchMedia() riceve una media query CSS come stringa e restituisce un nuovo oggetto MediaQueryList. matches indica il risultato corrente. L’oggetto emette change soltanto se quel valore booleano cambia. (min-resolution: 2dppx) verifica se ci sono almeno due pixel del dispositivo per pixel CSS; il passaggio da 2 a 3 non attraversa la soglia.
Per monitorare le variazioni del DPR, sostituisci … con il DPR corrente nella query esatta (resolution: …dppx). Quando arriva change, rimuovi il listener dal vecchio oggetto, leggi il nuovo DPR e registra il listener su una nuova query. Se la query esatta non corrisponde fin dall’inizio, non dare per scontato che la prossima variazione del DPR generi l’evento. Rimuovi il listener attivo quando non serve più.
Queste API appartengono al Window del browser, non a ECMAScript 2024 né all’ambito globale di un worker. Verifica il supporto nei browser di destinazione; addListener() e removeListener() sono metodi deprecati mantenuti per compatibilità.
Esempi
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;
})();Risultato
DPR: 1 DPR: 2
Nella console del browser la prima riga appare subito; le altre seguono le variazioni rilevate. I valori effettivi nel browser possono differire da quelli mostrati. Chiama `stopDprWatch()` per interrompere il monitoraggio. In Node.js, un oggetto di test simula il passaggio del DPR da 1 a 2 e il monitoraggio termina prima del passaggio simulato a 3.
Lezioni correlate
- JavaScript · Lezione 34 · Avanzato · Versione: 4