Selection: rangeCount-Eigenschaft
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.
Die schreibgeschützte Eigenschaft Selection.rangeCount
gibt die Anzahl der Bereiche in der Auswahl zurück.
Bevor der Benutzer auf eine neu geladene Seite geklickt hat, ist der rangeCount
gleich 0
. Nachdem der Benutzer auf die Seite geklickt hat, ist der rangeCount
gleich 1
, auch wenn keine sichtbare Auswahl vorhanden ist.
Ein Benutzer kann normalerweise nur einen Bereich gleichzeitig auswählen, daher wird der rangeCount
in der Regel 1
sein. Skripting kann verwendet werden, um die Auswahl mehr als einen Bereich enthalten zu lassen.
Gecko-Browser erlauben mehrere Auswahlen über Tabellenzellen hinweg. Firefox ermöglicht es, durch Ctrl+Klick mehrere Bereiche im Dokument auszuwählen (es sei denn, der Klick erfolgt innerhalb eines Elements, dem die CSS-Eigenschaft display: table-cell
zugewiesen ist).
Wert
Eine Zahl.
Beispiele
Das folgende Beispiel zeigt jede Sekunde den rangeCount
. Wählen Sie Text im Browser aus, um die Änderung zu sehen.
HTML
<table>
<tr>
<td>a.1</td>
<td>a.2</td>
</tr>
<tr>
<td>b.1</td>
<td>b.2</td>
</tr>
<tr>
<td>c.1</td>
<td>c.2</td>
</tr>
</table>
JavaScript
setInterval(() => {
console.log(window.getSelection().rangeCount);
}, 1000);
Ergebnis
Öffnen Sie Ihre Konsole, um zu sehen, wie viele Bereiche in der Auswahl sind. In Gecko-Browsern können Sie mehrere Bereiche über Tabellenzellen hinweg auswählen, indem Sie Ctrl (oder Cmd auf MacOS) gedrückt halten, während Sie mit der Maus ziehen.
Spezifikationen
Specification |
---|
Selection API # dom-selection-rangecount |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
Selection
, das Interface, zu dem es gehört.