Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Selection — výběr v dokumentu

Selection představuje výběr v dokumentu. Seznamte se s rangeCount a přidáním rozsahu pomocí addRange.

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

Syntaxe

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

Selection představuje výběr v dokumentu; Range určuje jeho hranice. Získejte jej pomocí window.getSelection() a ověřte, zda je výsledkem null. Jde o Web API, nikoli o funkci ECMAScriptu; Node 24 nedokládá podporu v prohlížečích.

Selection.rangeCount je pouze pro čtení: specifikace stanoví hodnotu 0, pokud je výběr prázdný nebo jeho hranice leží mimo strom dokumentu, a jinak 1. I u sbaleného rozsahu může být hodnota 1 — neznamená to, že je vybrán text.

Když Selection.addRange(range) přidá rozsah, uchovává odkaz, nikoli kopii. Podle specifikace metoda nic neudělá, pokud rozsah leží mimo strom dokumentu nebo pokud má Selection.rangeCount nenulovou hodnotu. Firefox však umožňuje přidat více rozsahů, takže v něm může být Selection.rangeCount větší než 1. Nespoléhejte na to, že více rozsahů podporují všechny prohlížeče. Chcete-li výběr nahradit, zavolejte removeAllRanges() před přidáním nového rozsahu.

Pří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ýsledek

1: Selection
1: true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje