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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
length

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support