WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Umschließendes Rechteck und Abstände zum Clientbereich

Miss Position und Größe eines Elements relativ zum Viewport und unterscheide diese Werte von den linken und oberen Abständen zum Clientbereich.

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

Syntax

element.getBoundingClientRect() // DOMRect
 element.clientLeft // integer Number
 element.clientTop // integer Number

element.getBoundingClientRect() ist eine Methode von Element ohne Argumente. Sie liefert ein DOMRect auf Grundlage der Rechtecke, die getClientRects() für die Rahmenboxen nach Anwendung der Transformationen liefert. Ist die Liste leer, sind alle Werte null. Hat jedes Rechteck in der Liste die Breite oder die Höhe null, gibt die Methode das erste Rechteck der Liste zurück. Andernfalls liefert sie das kleinste achsenparallele Rechteck, das alle Rechtecke mit einer von null verschiedenen Breite oder Höhe umschließt. Innenabstände und Rahmen zählen mit, Außenabstände nicht. left und top sind Koordinaten relativ zur linken oberen Ecke des Viewports; width und height sind Maße. Die Werte sind in CSS-Pixeln angegeben und können Nachkommastellen haben.

element.clientLeft und element.clientTop sind schreibgeschützte Eigenschaften, keine Methoden. Sie liefern ganzzahlige Abstände in CSS-Pixeln ohne Einfluss von Transformationen: die Dicke des linken beziehungsweise oberen Rahmens plus den Platz, den eine Bildlaufleiste auf derselben Seite einnimmt. Eine vertikale Bildlaufleiste kann etwa in einem Rechts-nach-links-Layout links liegen. Innen- und Außenabstände zählen nicht mit. Bei einer Inline-Box oder ohne CSS-Box liefern beide Eigenschaften null.

Das DOMRect ist eine Momentaufnahme. Miss nach dem Scrollen oder nach Layoutänderungen erneut, wenn du aktuelle Koordinaten brauchst. Für Dokumentkoordinaten addierst du zu left den Wert window.scrollX und zu top den Wert window.scrollY. clientLeft und clientTop sind weder Viewportkoordinaten noch ein allgemeines Mittel zur Koordinatenumrechnung nach einer Transformation. Diese APIs gehören zur Webplattform (CSSOM View), nicht zu ECMAScript 2024; ihre Verfügbarkeit hängt von der Laufzeitumgebung ab.

Beispiele

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Element geometry</title>
</head>
<body>
<script>
(() => {
  // Use a 1:1 ratio so the borders need no device-pixel rounding.
  if (window.devicePixelRatio !== 1) {
    throw new Error('Run at 100% page zoom with devicePixelRatio set to 1.');
  }

  const box = document.createElement('div');
  box.style.cssText = `
    position: fixed; left: 20px; top: 30px;
    box-sizing: border-box; width: 80px; height: 40px;
    border: solid black; border-width: 5px 2px 2px 3px;
    overflow: hidden; transform-origin: top left; transform: scale(2);
  `;
  document.body.append(box);
  try {
    const { left, top, width, height } = box.getBoundingClientRect();
    console.log(`rect: ${left}, ${top}, ${width}, ${height}`);
    console.log(`client: ${box.clientLeft}, ${box.clientTop}`);
  } finally {
    box.remove();
  }
})();
</script>
</body>
</html>

Ergebnis

rect: 20, 30, 160, 80
client: 3, 5

Öffne das HTML-Dokument im Browser bei 100 % Seitenzoom und einem `devicePixelRatio` von `1`. Lies die Ausgabe in der Browserkonsole ab. Die Skalierung verdoppelt die Maße des Rechtecks, ohne seine linke obere Ecke zu verschieben; die Abstände bleiben `3` und `5`.

Zugehörige Lektionen

  • JavaScript · Lektion 35 · Fortgeschritten · Version: 4

Quellen