CKTIS / JavaScript
Branje in spremljanje razmerja slikovnih pik z `matchMedia()`
Preberi število slikovnih pik naprave na slikovno piko CSS in spremljaj spremembe razmerja s poizvedbo o ločljivosti.
Različica: 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 je lastnost samo za branje. Pove, koliko slikovnih pik naprave ustreza eni slikovni piki CSS; vrednost ni nujno celo število. Razmerje se lahko spremeni ob spremembi povečave strani v brskalniku ali premiku okna na zaslon z drugačno nastavitvijo merila. Povečava z gesto dveh prstov ga ne spremeni.
window.matchMedia() sprejme predstavnostno poizvedbo CSS kot niz in vrne nov objekt MediaQueryList. matches poda trenutni rezultat. Objekt sproži dogodek change samo ob spremembi te logične vrednosti. (min-resolution: 2dppx) preveri, ali sta na slikovno piko CSS vsaj dve slikovni piki naprave; pri prehodu z 2 na 3 se prag ne prestopi.
Za spremljanje sprememb DPR v natančni poizvedbi (resolution: …dppx) zamenjaj … s trenutnim DPR. Ob dogodku change odstrani poslušalca s starega objekta, preberi novi DPR in ga registriraj na novi poizvedbi. Če natančna poizvedba sprva ne velja, ne predvidevaj, da bo naslednja sprememba DPR sprožila dogodek. Odstrani aktivnega poslušalca, ko ga ne potrebuješ več.
Ta API-ja sta del brskalnikovega vmesnika Window, ne ECMAScripta 2024 ali globalnega dosega workerja. Preveri podporo v ciljnih brskalnikih; addListener() in removeListener() sta zastareli metodi za združljivost.
Primeri
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
V konzoli brskalnika se prva vrstica izpiše takoj, naslednje pa po zaznanih spremembah. Dejanske vrednosti v brskalniku se lahko razlikujejo od prikazanih. Za konec spremljanja pokliči `stopDprWatch()`. V Node.js testni objekt simulira spremembo DPR z 1 na 2, spremljanje pa se konča pred simulirano spremembo na 3.
Povezane lekcije
- JavaScript · Lekcija 34 · Napredna · Različica: 4