DOMRectList: length-Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

Die schreibgeschützte length-Eigenschaft der DOMRectList-Schnittstelle gibt die Anzahl der DOMRect-Objekte in der Liste zurück.

Wert

Eine positive ganze Zahl, die die Anzahl der DOMRect-Objekte in der DOMRectList darstellt. Wenn keine Rechtecke in der Liste vorhanden sind, ist length 0.

Beispiele

Im folgenden Beispiel rufen wir die Liste der Rechtecke für ein <div>-Element mit Element.getClientRects() ab. Anschließend zeigen wir die Anzahl der Rechtecke in der Liste innerhalb eines anderen <div>-Elements auf der Seite an.

Zuerst das HTML:

html
<div id="box"></div>
<div id="output"></div>
css
#box {
  width: 50px;
  height: 20px;
  border: 1px solid black;
}

Nun der JavaScript-Code:

js
const box = document.getElementById("box");
const rects = box.getClientRects();
const output = document.getElementById("output");

output.textContent = `Number of rectangles: ${rects.length}`;

Die Ausgabe sieht so aus:

Spezifikationen

Specification
Geometry Interfaces Module Level 1
# dom-domrectlist-length

Browser-Kompatibilität