CKTIS / JavaScript
Selection — odabir u dokumentu
Selection predstavlja odabir u dokumentu. Saznajte više o rangeCount i dodavanju raspona pomoću addRange.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
const selection = window.getSelection();
selection.rangeCount;
selection.removeAllRanges();
selection.addRange(range);Selection predstavlja odabir u dokumentu; Range određuje njegove granice. Dohvatite ga pomoću window.getSelection() i provjerite je li rezultat null. To je Web API, a ne značajka ECMAScripta; Node 24 ne dokazuje podršku u preglednicima.
Selection.rangeCount je samo za čitanje: specifikacija propisuje vrijednost 0 ako je odabir prazan ili su njegove granice izvan stabla dokumenta, a inače 1. Vrijednost može biti 1 čak i kad se početna i završna granica raspona podudaraju — to ne znači da je tekst odabran.
Kad Selection.addRange(range) doda raspon, zadržava referencu na njega, a ne kopiju. Prema specifikaciji metoda ne radi ništa ako je raspon izvan stabla dokumenta ili ako Selection.rangeCount nije jednak 0. Firefox ipak omogućuje dodavanje više raspona, pa Selection.rangeCount u njemu može biti veći od 1. Nemojte se oslanjati na to da svi preglednici podržavaju više raspona. Da biste zamijenili odabir, pozovite removeAllRanges() prije dodavanja novog raspona.
Primjeri
(() => {
const selection = window.getSelection();
if (!selection || !document.body) {
throw new Error('An active browser document with a body is required.');
}
const paragraph = document.createElement('p');
paragraph.textContent = 'Hello Selection';
document.body.append(paragraph);
const range = document.createRange();
range.setStart(paragraph.firstChild, 6);
range.setEnd(paragraph.firstChild, 15);
try {
selection.removeAllRanges();
selection.addRange(range);
console.log(selection.rangeCount + ': ' + selection.toString());
range.collapse(true);
console.log(selection.rangeCount + ': ' + selection.isCollapsed);
} finally {
selection.removeAllRanges();
paragraph.remove();
}
})();Rezultat
1: Selection 1: true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.