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 = valueDOMRect.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.