WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Die Höhe des Begrenzungsrechtecks eines Elements messen

`getBoundingClientRect()` misst die Geometrie eines Elements relativ zum Viewport. `DOMRect.height` liefert die Höhe des Rechtecks in CSS-Pixeln.

Version: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

const rect = element.getBoundingClientRect();
const height = rect.height;

Rufe element.getBoundingClientRect() ohne Argumente auf. Die Instanzmethode von Element liefert ein DOMRect auf Grundlage der Liste von getClientRects(). Ist die Liste leer, gibt die Methode ein Rechteck zurück, dessen x, y, width und height alle 0 sind. Hat jedes Rechteck in der Liste eine Breite oder Höhe von null, gibt die Methode das erste Rechteck zurück. Dessen Höhe kann trotzdem ungleich null sein. Andernfalls liefert die Methode das kleinste achsenparallele Rechteck, das alle Rechtecke mit einer Breite oder Höhe ungleich null umschließt, auch wenn nur eine der beiden Abmessungen ungleich null ist. Koordinaten wie top und left beziehen sich auf den Viewport und können sich beim Scrollen ändern. Die Höhe ist eine Abmessung, keine Koordinate.

Lies rect.height ohne Klammern aus. Der Wert ist eine Zahl in CSS-Pixeln und kann Nachkommastellen haben. Bei einem einfachen HTML-Element mit einer Box umfasst die Messung Inhalt, Innenabstand (padding) und Rahmen, aber keine Außenabstände. CSS-Transformationen fließen ein. Daher kann der Wert von der CSS-Eigenschaft height und der ganzzahligen Layouthöhe offsetHeight abweichen. Erzeugt das Element keine CSS-Box, etwa bei display: none, beträgt die Höhe 0.

Das Rechteck ist eine Momentaufnahme. Miss nach einer Layout- oder Transformationsänderung erneut. Eine Zuweisung an rect.height ändert nur das DOMRect-Objekt, nicht das Element. Bei DOMRectReadOnly ist die Eigenschaft schreibgeschützt.

Das ist eine Web-API und kein Bestandteil von ECMAScript 2024. Die Messung benötigt eine Umgebung mit DOM- und Layout-Unterstützung. Prüfe vor dem Aufruf das Ergebnis von querySelector(): Bei null führt der Aufruf zu einem TypeError statt zu einem Messwert von null.

Beispiele

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Bounding rectangle height</title>
</head>
<body>
  <script>
    const box = document.createElement('div');
    box.style.cssText = 'box-sizing: content-box; width: 100px; height: 44px; padding: 5px; border: 0;';
    document.body.append(box);

    const before = box.getBoundingClientRect();
    box.style.transform = 'scaleY(0.5)';

    console.log(before.height);
    console.log(box.getBoundingClientRect().height);
    box.remove();
  </script>
</body>
</html>

Ergebnis

54
27

Speichere das Beispiel als HTML-Datei, öffne sie im Browser und sieh in der Entwicklerkonsole nach. Das gespeicherte Rechteck liefert `54`, die neue Messung nach `scaleY(0.5)` liefert `27`.

Zugehörige Lektionen

  • JavaScript · Lektion 11 · Fortgeschritten · Version: 4

Quellen