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 March 2017.
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.rangeCount
ist, 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
BCD tables only load in the browser
Siehe auch
Selection
, die Schnittstelle, zu der sie gehört.