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 des DOMRectList-Interfaces gibt die Anzahl der DOMRect-Objekte in der Liste zurück.

Wert

Ein positiver ganzzahliger Wert, der 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 mithilfe von Element.getClientRects() ab. Wir zeigen dann die Anzahl der Rechtecke in der Liste innerhalb eines anderen <div>-Elements auf der Seite an.

Zuerst das HTML:

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

Nun das JavaScript:

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

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

Das Ausgabeergebnis sieht so aus:

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser