CKTIS / JavaScript
DOMRect.width — Rechteckbreite
DOMRect.width ist eine beschreibbare Instanzeigenschaft, die die Breite eines Rechtecks beschreibt. Sie enthält eine Gleitkommazahl und lässt auch negative Werte zu. Nicht mit der schreibgeschützten Eigenschaft DOMRectReadOnly.width verwechseln.
Version: 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 beschreibt die Breite des Rechtecks, das ein DOMRect-Objekt darstellt. Es handelt sich um eine Instanzeigenschaft: Lies sie mit rect.width aus und ändere sie mit rect.width = value. Ihr Web-IDL-Typ ist unrestricted double, der in JavaScript als number dargestellt wird. Der Wert muss weder ganzzahlig noch positiv sein; der Typ lässt auch NaN, Infinity und -Infinity zu.
Der Konstruktor new DOMRect(x, y, width, height) nimmt die Breite als drittes Argument entgegen. Eine negative Breite wird nicht automatisch in einen positiven Wert umgewandelt. Wenn x und width endlich sind und width negativ ist, ist left gleich x + width und right gleich x. Bei unendlichen Eingabewerten gilt diese Kurzregel nicht immer: Für x = Infinity und width = -Infinity ergibt x + width den Wert NaN. Daher liefert die Maximumsberechnung für right den Wert NaN und nicht x.
In exakter Arithmetik wäre right - left bei endlichen Werten für x und width und negativem width gleich dem Absolutwert von width, doch Gleitkommarundungen in JavaScript können das Ergebnis verändern. Bei x = 1e20 und width = -8 wird x + width beispielsweise auf x gerundet, sodass right - left gleich 0 statt 8 ist.
DOMRect erbt von DOMRectReadOnly, ermöglicht aber das Schreiben in width. Was das Rechteck darstellt, hängt von der API ab, die es zurückgegeben hat; die Eigenschaft allein gibt nicht an, welche Art von Bereich gemessen wird.
Dies ist eine Web-API-Funktion, die im Geometry Interfaces Module Level 1 beschrieben ist, und keine Funktion einer bestimmten ECMAScript-Ausgabe. MDN kennzeichnet sie seit Januar 2020 als in Browsern breit verfügbar, auch in Web Workers. Das Beispiel verwendet explizite Koordinaten und ist daher nicht vom Seitenlayout abhängig.
Beispiele
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);Ergebnis
30.5 -8 2 10
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.