Selection: getRangeAt()-Methode
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
Die getRangeAt()-Methode der Selection-Schnittstelle gibt ein Range-Objekt zurück, das eine derzeit ausgewählte Range repräsentiert.
Wenn sich die Endpunkte der ausgewählten Range innerhalb eines Shadow-DOM-Baums befinden, hat JavaScript keinen Zugriff auf die Schattenknoten, und die Methode sollte die Range um den Host-Element erweitern, das den Endpunkt enthält. In der Praxis implementieren die meisten Browser dieses Verhalten bisher nicht, und die zurückgegebene Range ist unvorhersehbar.
Hinweis:
Beim Selektieren innerhalb von Knoten, die eine Shadow-Root enthalten könnten, kann Selection.getComposedRanges() (falls unterstützt) verwendet werden, um eine Auswahl-Range innerhalb eines Shadow-Baums zu erhalten oder um die Auswahl zuverlässig auf den Host-Knoten zu übertragen.
Syntax
getRangeAt(index)
Parameter
index-
Der nullbasierte Index der zurückzugebenden Range. Eine negative Zahl oder eine Zahl, die größer oder gleich
Selection.rangeCountist, führt zu einem Fehler.
Rückgabewert
Das spezifizierte Range-Objekt.
Beispiele
let ranges = [];
sel = window.getSelection();
for (let i = 0; i < sel.rangeCount; i++) {
ranges[i] = sel.getRangeAt(i);
}
/* Each item in the ranges array is now
* a range object representing one of the
* ranges in the current selection */
Spezifikationen
| Specification |
|---|
| Selection API # dom-selection-getrangeat |
Browser-Kompatibilität
Loading…
Siehe auch
Selection, die Schnittstelle, zu der sie gehört.