CKTIS / JavaScript
Selection: brojanje raspona s rangeCount i dodavanje s addRange()
`rangeCount` pokazuje koliko raspona sadrži odabir u dokumentu, a `addRange()` dodaje raspon DOM-a. Da biste u različitim preglednicima zamijenili odabir jednim rasponom, najprije ga poništite.
Verzija: 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 odabir u dokumentu ili položaj tekstnog pokazivača. Dohvatite objekt metodom window.getSelection() i provjerite je li rezultat null. To je API web-platforme, a ne dio ECMAScripta 2024. Za tekst u elementu textarea ili podržanoj vrsti elementa input koristite metodu elementa setSelectionRange().
rangeCount je brojčano svojstvo samo za čitanje. Broji objekte Range, a ne znakove. 0 znači da nema nijednog raspona. Izraz rangeCount === 1 može vrijediti i kad tekst nije označen: računa se i raspon sažet na jednu točku. Prije poziva getRangeAt(0) provjerite vrijedi li rangeCount > 0, jer indeks izvan dopuštenih granica izaziva iznimku.
addRange(range) prima jedan objekt Range i vraća undefined, pa povratna vrijednost ne govori je li raspon dodan. Stvorite raspon metodom document.createRange() i postavite mu granice, primjerice pozivom range.selectNodeContents(node) za čvor priključen istom dokumentu. Range je dinamičan objekt: promjene u DOM-u mogu prilagoditi njegove granice.
Specifikacija dopušta najviše jedan raspon po odabiru, ali Firefox ih podržava više. Preglednik ograničen na jedan raspon može zanemariti sljedeći poziv addRange() umjesto da zamijeni postojeći raspon. Da biste pouzdano postavili jedan novi raspon, najprije pozovite removeAllRanges(). Time se poništava prethodni odabir, ne briše se sadržaj dokumenta.
Primjeri
<!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
Spremite primjer kao datoteku `.html`, otvorite je na zasebnoj kartici preglednika i provjerite konzolu za razvojne programere. Kôd nakon poništavanja odabira ispisuje `0`, a nakon dodavanja raspona `1` i `CKTIS`. Na kraju poništava odabir i uklanja privremeni odlomak; ne vraća prethodni odabir.
Povezane lekcije
- JavaScript · Lekcija 33 · Srednje · Verzija: 3