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.