Auswahl: Eigenschaft `rangeCount`
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 eine frisch geladene Seite angeklickt hat, ist rangeCount
0
. Nachdem der Benutzer auf die Seite geklickt hat, ist rangeCount
1
, selbst wenn keine Auswahl sichtbar ist.
Ein Benutzer kann normalerweise nur einen Bereich gleichzeitig auswählen, daher wird rangeCount
in der Regel 1
sein. Scripting 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, mehrere Bereiche im Dokument auszuwählen, indem Ctrl+Klick verwendet wird (es sei denn, der Klick erfolgt innerhalb eines Elements, das die CSS-Eigenschaft display: table-cell
zugewiesen hat).
Wert
Eine Zahl.
Beispiele
Das folgende Beispiel zeigt jede Sekunde den rangeCount
. Wählen Sie Text im Browser aus, um die Verä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.