База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници