Auswahl: 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 des Selection-Interfaces gibt ein Range-Objekt zurück, das einen aktuell ausgewählten Bereich darstellt.
Wenn die Endpunkte des ausgewählten Bereichs innerhalb eines Shadow-Baums liegen, hat JavaScript keine Sichtbarkeit auf die Shadow-Knoten, und die Methode sollte den Bereich neu ausrichten, um das Host-Element einzuschließen, das den Endpunkt enthält. In der Praxis implementieren die meisten Browser dieses Verhalten noch nicht, und der zurückgegebene Bereich ist unvorhersehbar.
Hinweis:
Wenn Sie innerhalb von Knoten auswählen, die möglicherweise eine Shadow-Root enthalten, können Sie Selection.getComposedRanges() (falls unterstützt) verwenden, um einen Auswahlbereich innerhalb eines Shadow-Baums zu erhalten oder die Auswahl verlässlich auf den Host-Knoten neu auszurichten.
Syntax
getRangeAt(index)
Parameter
index-
Der nullbasierte Index des zurückzugebenden Bereichs. Eine negative Zahl oder eine Zahl, die größer oder gleich
Selection.rangeCountist, führt zu einem Fehler.
Rückgabewert
Das angegebene Range-Objekt.
Beispiele
let ranges = [];
const 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
Siehe auch
Selection, das Interface, zu dem es gehört.