DOMRectList: length-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Januar 2020 browserübergreifend verfügbar.
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:
<div id="box"></div>
<div id="output"></div>
#box {
width: 50px;
height: 20px;
border: 1px solid black;
}
Nun der JavaScript-Code:
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
| Spezifikation |
|---|
| Geometry Interfaces Module Level 1 # dom-domrectlist-length |