WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Element.getBoundingClientRect(): das Begrenzungsrechteck eines Elements

Element.getBoundingClientRect() gibt ein DOMRect zurück, das Position und Größe eines Elements relativ zum Ansichtsfenster beschreibt. Die Messung umfasst Innenabstand, Rahmen und CSS-Transformationen; das Ergebnis ist eine Momentaufnahme.

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

const rect = element.getBoundingClientRect();

Element.getBoundingClientRect ist eine Web-API-Methode, die ohne Argumente als element.getBoundingClientRect() aufgerufen wird. Sie gibt ein DOMRect zurück: x, y, width, height sowie die Kanten top, right, bottom, left. Die Koordinaten beziehen sich auf das Ansichtsfenster und werden in CSS-Pixeln angegeben; sie können Nachkommastellen haben.

Bei einem gewöhnlichen CSS-Element umfasst die Messung Innenabstand und Rahmen, nicht jedoch Außenabstände. Transformationen des Elements und seiner Vorfahren werden berücksichtigt. Durch eine Drehung entsteht ein achsenparalleles Begrenzungsrechteck, nicht die gedrehte Form selbst. getClientRects() gibt die Rechtecke der einzelnen Fragmente zurück. Ist die Liste nicht leer und hat jedes Rechteck die Breite null oder die Höhe null, gibt getBoundingClientRect() das erste Rechteck der Liste zurück. In allen anderen Fällen mit einer nicht leeren Liste gibt die Methode das kleinste Rechteck zurück, das alle Rechtecke der Liste umschließt, deren Breite und Höhe nicht beide null sind.

Das Ergebnis wird nicht automatisch aktualisiert: Führe nach Änderungen am Layout oder nach dem Scrollen eine neue Messung durch. Wenn kein Layoutfeld vorhanden ist, etwa bei display: none, sind Position und Abmessungen null. Es handelt sich um Geometrie, nicht um eine Prüfung der Sichtbarkeit oder Überdeckung.

Das Beispiel erstellt ein Element, liest seine Messwerte aus und entfernt es anschließend. width beträgt 124 und height beträgt 64, da Innenabstand und Rahmen zu den Inhaltsmaßen hinzukommen.

Beispiele

(() => {
  const box = document.createElement('div');
  box.style.cssText = 'all: initial; display: block; position: fixed; left: 20px; top: 30px; box-sizing: content-box; width: 100px; height: 40px; padding: 10px; border: 2px solid black; margin: 0;';
  document.body.append(box);
  try {
    const rect = box.getBoundingClientRect();
    console.log(JSON.stringify({
      x: rect.x,
      y: rect.y,
      width: rect.width,
      height: rect.height
    }));
  } finally {
    box.remove();
  }
})();

Ergebnis

{"x":20,"y":30,"width":124,"height":64}

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