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

CKTIS / JavaScript

Selection.removeAllRanges() — vymazanie výberu

Selection.removeAllRanges() vyprázdni výber dokumentu bez odstránenia textu alebo uzlov. Metóda neprijíma žiadne argumenty a vracia undefined.

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

selection.removeAllRanges()

Selection.removeAllRanges() odpojí rozsah od výberu. Po zavolaní má rangeCount hodnotu 0 a anchorNode aj focusNode majú hodnotu null. Opätovné zavolanie pri prázdnom výbere nič nezmení.

Neodstráni obsah ani uložený objekt Range. Na rozdiel od collapseToStart() nezanechá žiadny rozsah zbalený na pozíciu kurzora. empty() je alias tejto metódy.

Ide o rozhranie prehliadačového Selection API, nie o funkciu ECMAScriptu; Node 24 nepotvrdzuje jeho dostupnosť. Overte podporu v cieľovom prehliadači. Príklad porovnáva prázdny výber s nezmeneným textom a zachovaným rozsahom.

Prí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ýsledok

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

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

Zdroje