WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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 = value

DOMRect.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.

Quellen