CKTIS / JavaScript
DOMRect: obere Kante (`top`) und Höhe (`height`)
`top` gibt die Position der oberen Kante an, `height` die Höhe mit Vorzeichen. Die beiden Eigenschaften beantworten unterschiedliche Fragen, egal ob du ein Rechteck erstellst oder ein Element vermisst.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
rect.top
rect.height
new DOMRect(x, y, width, height)
element.getBoundingClientRect()rect.top und rect.height sind Instanzeigenschaften, keine Methoden. top ist die vertikale Koordinate der oberen Kante. height ist die Höhe mit Vorzeichen, keine Koordinate. Beide Werte sind Zahlen und können Nachkommastellen haben.
Für endliche Werte von y und height ist top gleich y + height, wenn height < 0 gilt, andernfalls gleich y. Eine negative Höhe bleibt in einem selbst erzeugten Rechteck negativ; sie wird nicht in ihren Absolutbetrag umgewandelt. Bei einem DOMRect kannst du height einen Wert zuweisen; beim Auslesen berücksichtigt top die Änderung. top ist in beiden Schnittstellen schreibgeschützt, height auch in DOMRectReadOnly.
Im Ergebnis von element.getBoundingClientRect() stehen beide Werte in CSS-Pixeln. top bezieht sich auf die Oberkante des Viewports und kann negativ sein, wenn die obere Rechteckkante darüber liegt. height ist die nichtnegative Höhe des umschließenden Rechtecks und berücksichtigt Innenabstand (padding) und Rahmen, nicht nur den Inhalt. Das Ergebnis aktualisiert sich nicht automatisch: Rufe die Methode nach dem Scrollen oder einer Layoutänderung erneut auf, um neu zu messen. Änderungen am zurückgegebenen Rechteck ändern das Element nicht.
DOMRect ist eine Web-API und kein Bestandteil von ECMAScript 2024. Setze nicht voraus, dass sie in jeder JavaScript-Laufzeit verfügbar ist.
Beispiele
{
const y = 20;
const height = 8;
// Without DOMRect, model only top and signed height for finite values.
const rect = typeof DOMRect === "function"
? new DOMRect(0, y, 10, height)
: {
y,
height,
get top() {
return this.height < 0 ? this.y + this.height : this.y;
},
};
console.log(`top=${rect.top}, height=${rect.height}`);
rect.height = -8;
console.log(`top=${rect.top}, height=${rect.height}`);
}Ergebnis
top=20, height=8 top=12, height=-8
Das Beispiel benötigt kein Seitenelement. `y` bleibt `20`, doch nach der Zuweisung `height = -8` liegt die obere Kante bei `12`.
Zugehörige Lektionen
- JavaScript · Lektion 34 · Mittlere Stufe · Version: 3