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.