CKTIS / JavaScript
DOMRect: die Eigenschaften width und height
Lies Breite und Höhe eines Rechtecks, deute gebrochene und negative Werte und unterscheide die gemessenen Abmessungen eines Elements von seinen CSS-Größenangaben.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
rect.width
rect.height
rect.width = newWidth
rect.height = newHeightrect.width und rect.height sind numerische Instanzeigenschaften: Sie geben die Breite beziehungsweise die Höhe an, keine Positionskoordinaten. Lies sie ohne Klammern aus. Bei DOMRect sind beide beschreibbar, bei DOMRectReadOnly nur lesbar.
Abmessungen können Nachkommastellen haben. Bei einem selbst erzeugten Rechteck sind auch negative Werte möglich. Ist width negativ, entspricht left dem Wert x + width, sonst x. Ist height negativ, entspricht top dem Wert y + height, sonst y. Ein negatives Vorzeichen ändert die Richtung vom Punkt (x, y) aus, nicht den Betrag der Abmessung.
element.getBoundingClientRect() liefert das umschließende Rechteck der nicht leeren Rahmenboxen des Elements einschließlich Innenabstand (padding) und Rahmen, aber ohne Außenabstände. Sind nicht leere Rahmenboxen vorhanden, werden leere ignoriert. Sind alle Rahmenboxen leer, gibt die Methode ein Rechteck mit Breite und Höhe null am Ursprung der ersten Rahmenbox zurück. Die Abmessungen sind in CSS-Pixeln angegeben und berücksichtigen CSS-Transformationen. Sie müssen daher nicht den CSS-Werten width und height des Elements entsprechen. Änderungen am zurückgegebenen Objekt ändern das Element nicht. Rufe die Methode erneut auf, um neu zu messen.
DOMRect ist eine Web-API und kein Bestandteil von ECMAScript 2024. Ob sie verfügbar ist, hängt von der Laufzeitumgebung ab.
Beispiele
{
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}`);
}Ergebnis
width=-30.5, height=12.25, left=-20.5 width=30.5, height=12.25, left=10
Führe den Code in einer Browserkonsole aus, um das native `DOMRect` zu verwenden. In Node.js ohne `DOMRect` nutzt das Beispiel ein vereinfachtes Geometriemodell. Der Vorzeichenwechsel von `width` verschiebt `left` von `-20.5` auf `10`; `height` bleibt gleich.
Zugehörige Lektionen
- JavaScript · Lektion 35 · Mittlere Stufe · Version: 3