CKTIS / JavaScript
DOMRect: de eigenschappen width en height
Lees de breedte en hoogte van een rechthoek, interpreteer gebroken en negatieve waarden en onderscheid de gemeten afmetingen van een element van zijn CSS-afmetingen.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
rect.width
rect.height
rect.width = newWidth
rect.height = newHeightrect.width en rect.height zijn numerieke instantie-eigenschappen: ze geven respectievelijk de breedte en de hoogte aan, niet de positie. Lees ze uit zonder haakjes. Op DOMRect zijn beide beschrijfbaar; op DOMRectReadOnly zijn ze alleen-lezen.
Afmetingen kunnen cijfers achter de komma hebben. Bij een rechthoek die je zelf maakt, kunnen ze ook negatief zijn. Als width negatief is, is left gelijk aan x + width; anders is het x. Als height negatief is, is top gelijk aan y + height; anders is het y. Een minteken verandert de richting vanuit (x, y), niet de absolute grootte.
element.getBoundingClientRect() geeft de rechthoek terug die de niet-lege border-boxen van het element omsluit, inclusief binnenruimte (padding) en randen, maar zonder marges. Als er niet-lege boxen zijn, worden lege boxen genegeerd. Als alle boxen leeg zijn, geeft de methode een rechthoek met breedte en hoogte nul terug op het beginpunt van de eerste box. De afmetingen zijn in CSS-pixels en houden rekening met CSS-transformaties. Ze hoeven dus niet overeen te komen met de CSS-waarden width en height van het element. Het teruggegeven object wijzigen verandert het element niet. Roep de methode opnieuw aan voor een nieuwe meting.
DOMRect is een web-API en maakt geen deel uit van ECMAScript 2024. Of de API beschikbaar is, hangt af van de uitvoeromgeving.
Voorbeelden
{
const x = 10, y = 20, width = -30.5, height = 12.25;
// Without native DOMRect, model only the geometry used in this example.
const rect = typeof globalThis.DOMRect === "function"
? new globalThis.DOMRect(x, y, width, height)
: {
x, y, width, height,
get left() {
return this.width < 0 ? this.x + this.width : this.x;
},
};
console.log(`width=${rect.width}, height=${rect.height}, left=${rect.left}`);
rect.width = 30.5;
console.log(`width=${rect.width}, height=${rect.height}, left=${rect.left}`);
}Resultaat
width=-30.5, height=12.25, left=-20.5 width=30.5, height=12.25, left=10
Voer de code uit in een browserconsole om de ingebouwde `DOMRect` te gebruiken. In Node.js zonder `DOMRect` gebruikt het voorbeeld een vereenvoudigd meetkundig model. Als het teken van `width` verandert, gaat `left` van `-20.5` naar `10`; `height` blijft gelijk.
Gerelateerde lessen
- JavaScript · Les 35 · Gemiddeld · Versie: 3