CKTIS / JavaScript
Selection.getRangeAt — pridobivanje obsega izbora
Selection.getRangeAt(0) vrne objekt Range, povezan z izborom v dokumentu, ne pa njegove kopije.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
selection.getRangeAt(index)selection.getRangeAt(index) omogoča dostop do obsega izbora. To je spletni API brskalnika, ne funkcija ECMAScripta; Node 24 ne potrjuje njegove podpore.
Pred klicem z indeksom 0 preverite, ali veljata selection !== null in selection.rangeCount > 0. Po specifikaciji mora metoda sprožiti izjemo IndexSizeError, če indeks ni 0, če je izbor prazen ali če je katera od njegovih mejnih točk zunaj drevesa dokumenta. Brskalniki tega pravila ne upoštevajo vedno: Firefox lahko omogoča dostop do več obsegov izbora, zato lahko deluje tudi indeks, ki ni 0. Če je mejna točka v drevesu Shadow DOM, ne predpostavljajte, da bo brskalnik sprožil to izjemo. Tudi izbor, skrčen na položaj besedilne kazalke, ima lahko obseg.
Rezultat je referenca: sprememba obsega vpliva na izbor, dokler ostaneta povezana. Ponovni klici z istim indeksom vrnejo isti objekt, razen če je obseg zamenjan ali odstranjen. Specifikacija ima status Working Draft; ni tabela združljivosti brskalnikov.
Primeri
(() => {
const selection = window.getSelection();
if (!selection || !document.body) {
throw new Error("An active browser document is required.");
}
const element = document.createElement("p");
element.textContent = "Hello world";
document.body.append(element);
try {
selection.removeAllRanges();
const range = document.createRange();
range.setStart(element.firstChild, 0);
range.setEnd(element.firstChild, 5);
selection.addRange(range);
if (selection.rangeCount === 0) {
throw new Error("No selection range is available.");
}
const selectedRange = selection.getRangeAt(0);
console.log(selectedRange.toString());
console.log(selectedRange === selection.getRangeAt(0));
} finally {
selection.removeAllRanges();
element.remove();
}
})();Rezultat
Hello true
Koda in izpis sta bila preverjena v izoliranem okolju brskalnika Chromium. Primer pridobi edini obseg z indeksom `0` in preveri, ali drugi klic vrne isti objekt. Ne preverja indeksov, ki niso `0`, niti mejnih točk v drevesu Shadow DOM.