CKTIS / JavaScript
Selection: štetje obsegov z rangeCount in dodajanje z addRange()
`rangeCount` pove, koliko obsegov vsebuje izbor v dokumentu, `addRange()` pa doda obseg DOM. Če želite v različnih brskalnikih izbor zamenjati z enim obsegom, ga najprej počistite.
Različica: Current web platform; runtime support varies
Sintaksa
// Web platform: Selection API (not part of ECMAScript).
const selection = window.getSelection(); // Selection | null
if (selection !== null) {
const count = selection.rangeCount; // read-only number
selection.addRange(range); // takes a Range; returns undefined
}Selection predstavlja izbor v dokumentu ali položaj besedilne kazalke. Objekt pridobite z window.getSelection() in preverite, ali je rezultat null. To je API spletne platforme in ni del ECMAScripta 2024. Za besedilo v elementu textarea ali podprti vrsti elementa input uporabite metodo elementa setSelectionRange().
rangeCount je številska lastnost samo za branje. Šteje objekte Range, ne znakov. 0 pomeni, da ni nobenega obsega. Tudi brez označenega besedila lahko velja rangeCount === 1: obseg, skrčen na eno točko, še vedno šteje. Pred klicem getRangeAt(0) preverite, ali velja rangeCount > 0, saj indeks zunaj dovoljenih mej sproži izjemo.
addRange(range) sprejme en objekt Range in vrne undefined, zato vrnjena vrednost ne pove, ali je bil obseg dodan. Obseg ustvarite z document.createRange() in mu nastavite meje, na primer z range.selectNodeContents(node) za vozlišče, ki je vključeno v isti dokument. Range je dinamičen objekt: spremembe v DOM lahko prilagodijo njegove meje.
Specifikacija dovoljuje največ en obseg na izbor, Firefox pa jih podpira več. Brskalnik, omejen na en obseg, lahko prezre naslednji klic addRange(), namesto da bi zamenjal obstoječi obseg. Če želite zanesljivo nastaviti en nov obseg, najprej pokličite removeAllRanges(). S tem počistite prejšnji izbor, ne pa vsebine dokumenta.
Primeri
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Selection API example</title>
</head>
<body>
<script>
(() => {
const selection = window.getSelection();
if (selection === null) throw new Error("No document selection available");
const paragraph = document.createElement("p");
paragraph.textContent = "CKTIS";
document.body.append(paragraph);
try {
const range = document.createRange();
range.selectNodeContents(paragraph);
selection.removeAllRanges();
console.log(selection.rangeCount);
selection.addRange(range);
console.log(selection.rangeCount);
console.log(selection.toString());
} finally {
selection.removeAllRanges();
paragraph.remove();
}
})();
</script>
</body>
</html>Rezultat
0 1 CKTIS
Primer shranite kot datoteko `.html`, jo odprite v ločenem zavihku brskalnika in preverite konzolo za razvijalce. Koda po čiščenju izbora izpiše `0`, po dodajanju obsega pa `1` in `CKTIS`. Na koncu počisti izbor in odstrani začasni odstavek; prejšnjega izbora ne obnovi.
Povezane lekcije
- JavaScript · Lekcija 33 · Srednja · Različica: 3