CKTIS / JavaScript
DOMRect: bovenrand (`top`) en hoogte (`height`)
`top` geeft aan waar de bovenrand van de rechthoek ligt; `height` geeft de hoogte met teken aan. Dat zijn twee verschillende gegevens, of je nu zelf een rechthoek maakt of een element meet.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
rect.top
rect.height
new DOMRect(x, y, width, height)
element.getBoundingClientRect()rect.top en rect.height zijn eigenschappen van de instantie, geen methoden. top is de verticale coördinaat van de bovenrand. height is de hoogte met teken, geen coördinaat. Beide waarden zijn getallen en kunnen een breukdeel hebben.
Bij eindige waarden voor y en height is top gelijk aan y + height als height < 0, en anders aan y. Bij een zelf gemaakte rechthoek blijft een negatieve hoogte negatief; die wordt niet omgezet in een absolute waarde. Bij een DOMRect kun je een waarde aan height toewijzen; als je daarna top uitleest, zie je het effect van de wijziging. top is in beide interfaces alleen-lezen; height is dat ook in DOMRectReadOnly.
In het resultaat van element.getBoundingClientRect() worden beide waarden uitgedrukt in CSS-pixels. top is relatief aan de bovenkant van de viewport en kan negatief zijn als de bovenrand van de rechthoek daarboven ligt. height is de niet-negatieve hoogte van de omsluitende rechthoek en houdt rekening met de binnenruimte (padding) en de randen, niet alleen met de inhoud. Het resultaat wordt niet automatisch bijgewerkt: roep de methode na het scrollen of een lay-outwijziging opnieuw aan om opnieuw te meten. Als je de teruggegeven rechthoek aanpast, verandert het element niet.
DOMRect is een web-API en maakt geen deel uit van ECMAScript 2024. Ga er niet van uit dat de API in elke JavaScript-runtime beschikbaar is.
Voorbeelden
{
const y = 20;
const height = 8;
// Without DOMRect, model only top and signed height for finite values.
const rect = typeof DOMRect === "function"
? new DOMRect(0, y, 10, height)
: {
y,
height,
get top() {
return this.height < 0 ? this.y + this.height : this.y;
},
};
console.log(`top=${rect.top}, height=${rect.height}`);
rect.height = -8;
console.log(`top=${rect.top}, height=${rect.height}`);
}Resultaat
top=20, height=8 top=12, height=-8
Voor het voorbeeld is geen pagina-element nodig. `y` blijft `20`, maar na de toewijzing `height = -8` ligt de bovenrand op `12`.
Gerelateerde lessen
- JavaScript · Les 34 · Gemiddeld · Versie: 3