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

CKTIS / JavaScript

Selection.removeAllRanges() — vymazání výběru

Selection.removeAllRanges() vyprázdní výběr dokumentu, aniž by odstranila text nebo uzly. Metoda nepřijímá žádné argumenty a vrací undefined.

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

selection.removeAllRanges()

Selection.removeAllRanges() odpojí rozsah od výběru. Po zavolání má rangeCount hodnotu 0 a anchorNode i focusNode mají hodnotu null. Opakované zavolání u prázdného výběru nic nezmění.

Neodstraní obsah ani uložený objekt Range. Na rozdíl od collapseToStart() nezanechá žádný rozsah sbalený na pozici kurzoru. empty() je alias této metody.

Jde o rozhraní prohlížečového Selection API, nikoli o funkci ECMAScriptu; Node 24 nepotvrzuje jeho dostupnost. Ověřte podporu v cílovém prohlížeči. Příklad porovnává prázdný výběr s nezměněným textem a zachovaným rozsahem.

Příklady

(() => {
  const selection = window.getSelection();
  if (!selection || typeof selection.removeAllRanges !== "function") {
    throw new Error("Selection API unavailable");
  }

  const text = document.createTextNode("Hello");
  document.body.append(text);
  const range = document.createRange();
  range.selectNodeContents(text);

  selection.removeAllRanges();
  selection.addRange(range);
  selection.removeAllRanges();

  console.log(JSON.stringify({
    rangeCount: selection.rangeCount,
    anchorNode: selection.anchorNode,
    focusNode: selection.focusNode,
    text: text.data,
    savedRange: range.toString()
  }));
  text.remove();
})();

Výsledek

{"rangeCount":0,"anchorNode":null,"focusNode":null,"text":"Hello","savedRange":"Hello"}

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