Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Selection — výber v dokumente

Selection predstavuje výber v dokumente. Zistite viac o rangeCount a pridávaní rozsahu pomocou addRange.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

const selection = window.getSelection();
selection.rangeCount;
selection.removeAllRanges();
selection.addRange(range);

Selection predstavuje výber v dokumente; Range určuje jeho hranice. Získajte ho pomocou window.getSelection() a skontrolujte, či je výsledkom null. Ide o Web API, nie o funkciu ECMAScriptu; Node 24 nedokazuje podporu v prehliadačoch.

Selection.rangeCount je iba na čítanie: špecifikácia stanovuje hodnotu 0, ak je výber prázdny alebo jeho hranice ležia mimo stromu dokumentu, a inak 1. Aj pri zbalenom rozsahu môže byť hodnota 1 — neznamená to, že je vybratý text.

Keď Selection.addRange(range) pridá rozsah, uchová odkaz, nie kópiu. Podľa špecifikácie metóda neurobí nič, ak rozsah leží mimo stromu dokumentu alebo ak má Selection.rangeCount nenulovú hodnotu. Firefox však umožňuje pridať viacero rozsahov, takže Selection.rangeCount v ňom môže byť väčšie ako 1. Nespoliehajte sa na to, že viacero rozsahov podporujú všetky prehliadače. Ak chcete výber nahradiť, zavolajte removeAllRanges() pred pridaním nového rozsahu.

Príklady

(() => {
  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();
  }
})();

Výsledok

1: Selection
1: true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje