CKTIS / JavaScript
Selection: počítanie rozsahov pomocou rangeCount a pridávanie pomocou addRange()
`rangeCount` udáva počet rozsahov vo výbere dokumentu a `addRange()` pridáva rozsah DOM. Ak chcete v rôznych prehliadačoch nahradiť výber jediným rozsahom, najprv ho zrušte.
Verzia: Current web platform; runtime support varies
Syntax
// Web platform: Selection API (not part of ECMAScript).
const selection = window.getSelection(); // Selection | null
if (selection !== null) {
const count = selection.rangeCount; // read-only number
selection.addRange(range); // takes a Range; returns undefined
}Selection predstavuje výber v dokumente alebo polohu textového kurzora. Objekt získajte pomocou window.getSelection() a skontrolujte, či výsledok nie je null. Ide o API webovej platformy, nie o súčasť ECMAScriptu 2024. Na výber textu v textarea alebo v podporovanom type input použite metódu prvku setSelectionRange().
rangeCount je číselná vlastnosť iba na čítanie. Počíta objekty Range, nie znaky. 0 znamená, že výber neobsahuje žiadny rozsah. Podmienka rangeCount === 1 môže platiť aj bez zvýrazneného textu: rozsah zúžený na jeden bod sa tiež počíta. Pred volaním getRangeAt(0) overte, že rangeCount > 0, pretože index mimo platných hraníc vyvolá výnimku.
addRange(range) prijíma jeden objekt Range a vracia undefined, takže návratová hodnota nehovorí, či bol rozsah pridaný. Vytvorte rozsah pomocou document.createRange() a nastavte jeho hranice, napríklad volaním range.selectNodeContents(node) pre uzol pripojený k tomu istému dokumentu. Range je živý objekt: zmeny v DOM môžu upraviť jeho hranice.
Špecifikácia pripúšťa najviac jeden rozsah na výber, Firefox ich však podporuje viac. Prehliadač obmedzený na jeden rozsah môže ďalšie volanie addRange() ignorovať namiesto toho, aby existujúci rozsah nahradil. Ak chcete spoľahlivo nastaviť jeden nový rozsah, zavolajte najprv removeAllRanges(). Tým zrušíte predchádzajúci výber, nie obsah dokumentu.
Príklady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Selection API example</title>
</head>
<body>
<script>
(() => {
const selection = window.getSelection();
if (selection === null) throw new Error("No document selection available");
const paragraph = document.createElement("p");
paragraph.textContent = "CKTIS";
document.body.append(paragraph);
try {
const range = document.createRange();
range.selectNodeContents(paragraph);
selection.removeAllRanges();
console.log(selection.rangeCount);
selection.addRange(range);
console.log(selection.rangeCount);
console.log(selection.toString());
} finally {
selection.removeAllRanges();
paragraph.remove();
}
})();
</script>
</body>
</html>Výsledok
0 1 CKTIS
Uložte príklad ako súbor `.html`, otvorte ho na samostatnej karte prehliadača a skontrolujte vývojársku konzolu. Po zrušení výberu kód vypíše `0`, po pridaní rozsahu `1` a `CKTIS`. Na konci zruší výber a odstráni dočasný odsek; predchádzajúci výber neobnoví.
Súvisiace lekcie
- JavaScript · Lekcia 33 · Stredne pokročilá · Verzia: 3