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

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

js
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.