KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

DOMRect.width — breedte van de rechthoek

DOMRect.width is een beschrijfbare instantie-eigenschap die de breedte van een rechthoek aangeeft. De eigenschap bevat een getal met drijvende komma en staat negatieve waarden toe. Verwar deze niet met de alleen-lezen-eigenschap DOMRectReadOnly.width.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

rect.width
rect.width = value

DOMRect.width beschrijft de breedte van de rechthoek die door een DOMRect-object wordt weergegeven. Het is een instantie-eigenschap: lees de waarde met rect.width en wijzig deze met rect.width = value. Het Web IDL-type is unrestricted double, in JavaScript weergegeven als number. De waarde hoeft niet geheel of positief te zijn; dit type staat ook NaN, Infinity en -Infinity toe.

De constructor new DOMRect(x, y, width, height) neemt de breedte als derde argument. Een negatieve breedte wordt niet automatisch omgezet in een positieve waarde. Als x en width eindig zijn en width negatief is, is left gelijk aan x + width en right gelijk aan x. Deze vereenvoudigde regel geldt niet altijd voor oneindige waarden: bij x = Infinity en width = -Infinity is x + width gelijk aan NaN, zodat de maximumberekening voor right uitkomt op NaN en niet op x.

Als je exact rekent met eindige waarden voor x en width en een negatieve width, is right - left gelijk aan de absolute waarde van width. In JavaScript kan afronding bij het rekenen met drijvendekommagetallen de uitkomst veranderen. Bij bijvoorbeeld x = 1e20 en width = -8 wordt x + width afgerond op x, zodat right - left gelijk is aan 0 en niet aan 8.

DOMRect erft van DOMRectReadOnly, maar maakt het mogelijk om width te wijzigen. Wat de rechthoek voorstelt, hangt af van de API die deze heeft teruggegeven; de eigenschap alleen geeft niet aan welk soort gebied wordt gemeten.

Dit is een functie van de Web API die wordt beschreven in Geometry Interfaces Module Level 1, niet een functie van een bepaalde ECMAScript-editie. MDN vermeldt dat de functie sinds januari 2020 breed beschikbaar is in browsers, ook in Web Workers. Het voorbeeld gebruikt expliciete coördinaten en is dus niet afhankelijk van de paginalay-out.

Voorbeelden

const rect = new DOMRect(10, 20, 30.5, 40);
console.log(rect.width);

rect.width = -8;
console.log(rect.width);
console.log(rect.left, rect.right);

Resultaat

30.5
-8
2 10

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen