CKTIS / JavaScript
Selection — избор в документа
Selection представя избора в документа. Научете за rangeCount и как да добавите диапазон чрез addRange.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
const selection = window.getSelection();
selection.rangeCount;
selection.removeAllRanges();
selection.addRange(range);Selection представя избора в документа; Range определя неговите граници. Получете го чрез window.getSelection() и проверете дали резултатът е null. Това е Web API, а не функция на ECMAScript; Node 24 не доказва поддръжка в браузърите.
Selection.rangeCount е само за четене: според спецификацията стойността е 0, ако изборът е празен или границите му са извън дървото на документа, а в останалите случаи е 1. И при свит диапазон стойността може да е 1 — това не означава, че има избран текст.
Когато Selection.addRange(range) добави диапазон, методът запазва препратка към него, а не копие. Според спецификацията методът не прави нищо, ако диапазонът е извън дървото на документа или ако Selection.rangeCount има стойност, различна от 0. Firefox обаче позволява добавянето на няколко диапазона, затова в този браузър Selection.rangeCount може да надхвърли 1. Не разчитайте, че всички браузъри поддържат няколко диапазона. За да замените избора, извикайте removeAllRanges(), преди да добавите новия диапазон.
Примери
(() => {
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();
}
})();Резултат
1: Selection 1: true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.