Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Selection.removeAllRanges() — brisanje izbora

Selection.removeAllRanges() izprazni izbor dokumenta, ne da bi izbrisal besedilo ali vozlišča. Metoda ne sprejme argumentov in vrne undefined.

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

Sintaksa

selection.removeAllRanges()

Selection.removeAllRanges() odstrani obseg iz izbora. Po klicu je rangeCount enak 0, anchorNode in focusNode pa sta null. Ponovni klic pri praznem izboru ničesar ne spremeni.

Ne izbriše vsebine ali shranjenega objekta Range. Za razliko od collapseToStart() ne pusti obsega, skrčenega na mesto kazalke. empty() je vzdevek za to metodo.

To je vmesnik brskalniškega Selection API, ne funkcija ECMAScript; Node 24 ne potrjuje njegove razpoložljivosti. Preverite podporo v ciljnem brskalniku. Primer primerja prazen izbor z nespremenjenim besedilom in ohranjenim obsegom.

Primeri

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

Rezultat

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri