CKTIS / JavaScript
ResizeObserverEntry: opazovani element in pravokotnik vsebine
Z lastnostjo `target` ugotoviš, na kateri element se nanaša zapis, z `contentRect` pa prebereš sporočene mere, ki pri elementu HTML ne vključujejo notranjega odmika in obrobe.
Različica: Current web platform; runtime support varies
Sintaksa
entry.target
entry.contentRect
entry.contentRect.width
entry.contentRect.heightMed izrisovanjem brskalnik povratni funkciji ResizeObserver posreduje tabelo zapisov ResizeObserverEntry. Lastnost entry.target je samo za branje in se sklicuje na opazovani element, ne na njegovo kopijo. Če opazuješ več elementov, primerjaj target z znanim sklicem na element z operatorjem ===.
entry.contentRect je objekt DOMRectReadOnly z meritvijo ob obvestilu in se ne posodablja sproti. Pri elementu HTML width in height pomenita fizično širino in višino polja vsebine v slikovnih pikah CSS, brez notranjega odmika in obrobe. Pri grafičnem elementu SVG brez polja postavitve CSS meritev opisuje njegov omejevalni pravokotnik. Ne zamenjuj ga z rezultatom getBoundingClientRect(), ki pri HTML vrne pravokotnik, ki obdaja polja z obrobami, glede na vidno območje brskalnika.
contentRect je ohranjena zaradi združljivosti za nazaj. Za logične mere uporabi contentBoxSize, če je podprta: vrednosti inlineSize in blockSize sledita načinu pisanja. Možnost box metode observe() določa, spremembe katerega polja sprožijo obvestila; izbira border-box ne spremeni contentRect v meritev polja z obrobo. ECMAScript 2024 tu označuje samo izhodiščno različico jezika JavaScript. Obe lastnosti določa specifikacija Resize Observer, ne ECMAScript, njuna razpoložljivost pa je odvisna od izvajalnega okolja.
Primeri
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>ResizeObserverEntry example</title>
</head>
<body>
<script>
(() => {
const box = document.createElement('div');
Object.assign(box.style, {
boxSizing: 'content-box',
width: '120px',
height: '60px',
padding: '10px',
border: '2px solid black'
});
document.body.append(box);
const observer = new ResizeObserver(([entry]) => {
const { width, height } = entry.contentRect;
console.log(`${entry.target === box}: ${width} × ${height} CSS px`);
observer.disconnect();
box.remove();
});
observer.observe(box);
})();
</script>
</body>
</html>Rezultat
true: 120 × 60 CSS px
Shrani primer kot datoteko `.html` in jo odpri v brskalniku, ki podpira `ResizeObserver`. Odpri razvijalsko konzolo in znova naloži stran. Prvo obvestilo izpiše `true: 120 × 60 CSS px`: `true` potrdi, da gre za isti element, mere pa ne vključujejo notranjega odmika in obrobe. Koda nato ustavi opazovanje in odstrani element.
Povezane lekcije
- JavaScript · Lekcija 32 · Srednja · Različica: 3