CKTIS / JavaScript
Selection: počítání rozsahů pomocí rangeCount a přidávání pomocí addRange()
`rangeCount` udává počet rozsahů ve výběru dokumentu a `addRange()` přidává rozsah DOM. Chcete-li v různých prohlížečích nahradit výběr jediným rozsahem, nejprve ho zrušte.
Verze: Current web platform; runtime support varies
Syntaxe
// 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 představuje výběr v dokumentu nebo polohu textového kurzoru. Objekt získejte pomocí window.getSelection() a ověřte, zda výsledek není null. Jde o API webové platformy, nikoli o součást ECMAScriptu 2024. Pro výběr textu v textarea nebo v podporovaném typu input použijte metodu prvku setSelectionRange().
rangeCount je číselná vlastnost pouze pro čtení. Počítá objekty Range, nikoli znaky. 0 znamená, že výběr neobsahuje žádný rozsah. Podmínka rangeCount === 1 může platit i bez zvýrazněného textu: rozsah zúžený na jediný bod se také počítá. Před voláním getRangeAt(0) ověřte, že rangeCount > 0, protože index mimo platné meze vyvolá výjimku.
addRange(range) přijímá jeden objekt Range a vrací undefined, takže návratová hodnota neříká, zda byl rozsah přidán. Vytvořte rozsah pomocí document.createRange() a nastavte jeho hranice, například voláním range.selectNodeContents(node) pro uzel připojený ke stejnému dokumentu. Range je živý objekt: změny v DOM mohou upravit jeho hranice.
Specifikace připouští nejvýše jeden rozsah na výběr, Firefox jich ale podporuje více. Prohlížeč omezený na jeden rozsah může další volání addRange() ignorovat, místo aby stávající rozsah nahradil. Chcete-li spolehlivě nastavit jediný nový rozsah, zavolejte nejprve removeAllRanges(). Tím zrušíte předchozí výběr, nesmažete obsah dokumentu.
Pří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ýsledek
0 1 CKTIS
Uložte příklad jako soubor `.html`, otevřete ho na samostatné kartě prohlížeče a podívejte se do vývojářské konzole. Po zrušení výběru kód vypíše `0`, po přidání rozsahu `1` a `CKTIS`. Nakonec zruší výběr a odstraní dočasný odstavec; předchozí výběr neobnoví.
Související lekce
- JavaScript · Lekce 33 · Středně pokročilá · Verze: 3