CKTIS / JavaScript
Selection — izbor v dokumentu
Selection predstavlja izbor v dokumentu. Spoznajte rangeCount in dodajanje obsega z addRange.
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
const selection = window.getSelection();
selection.rangeCount;
selection.removeAllRanges();
selection.addRange(range);Selection predstavlja izbor v dokumentu; Range določa njegove meje. Pridobite ga z window.getSelection() in preverite, ali je rezultat null. To je spletni API, ne funkcija ECMAScripta; Node 24 ne dokazuje podpore v brskalnikih.
Selection.rangeCount je samo za branje: specifikacija določa vrednost 0, če je izbor prazen ali so njegove meje zunaj drevesa dokumenta, sicer pa 1. Tudi pri strnjenem obsegu je vrednost lahko 1 — to ne pomeni, da je izbrano besedilo.
Ko Selection.addRange(range) doda obseg, ohrani sklic nanj, ne njegove kopije. Po specifikaciji metoda ne naredi ničesar, če je obseg zunaj drevesa dokumenta ali če Selection.rangeCount ni enak 0. Firefox pa omogoča dodajanje več obsegov, zato je lahko Selection.rangeCount v njem večji od 1. Ne zanašajte se na to, da vsi brskalniki podpirajo več obsegov. Če želite zamenjati izbor, pred dodajanjem novega obsega pokličite removeAllRanges().
Primeri
(() => {
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.