CKTIS / JavaScript
Selection: bereiken tellen met rangeCount en toevoegen met addRange()
`rangeCount` geeft aan hoeveel bereiken de documentselectie bevat en `addRange()` voegt een DOM-bereik toe. Wis de selectie eerst als je die in verschillende browsers door één bereik wilt vervangen.
Versie: 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 vertegenwoordigt de selectie in het document of de positie van de tekstcursor. Haal het object op met window.getSelection() en controleer of het resultaat null is. Deze API hoort bij het webplatform, niet bij ECMAScript 2024. Gebruik voor tekst in een textarea of een ondersteund input-type de methode setSelectionRange() van het element.
rangeCount is een numerieke eigenschap die je alleen kunt lezen. Ze telt Range-objecten, geen tekens. 0 betekent dat er geen bereik is. Ook zonder gemarkeerde tekst kan rangeCount === 1 gelden: een tot één punt ingeklapt bereik telt mee. Controleer vóór getRangeAt(0) of rangeCount > 0, want een index buiten het geldige bereik veroorzaakt een uitzondering.
addRange(range) krijgt één Range-object en retourneert undefined. De retourwaarde vertelt je dus niet of het bereik is toegevoegd. Maak een bereik met document.createRange() en stel de grenzen in, bijvoorbeeld met range.selectNodeContents(node) voor een knooppunt dat aan hetzelfde document is gekoppeld. Een Range is dynamisch: wijzigingen in het DOM kunnen de grenzen aanpassen.
De specificatie staat maximaal één bereik per selectie toe, maar Firefox ondersteunt er meerdere. Een browser die maar één bereik ondersteunt, kan een volgende aanroep van addRange() negeren in plaats van het bestaande bereik te vervangen. Roep daarom eerst removeAllRanges() aan als je op een betrouwbare manier één nieuw bereik wilt instellen. Daarmee wis je de vorige selectie, niet de inhoud van het document.
Voorbeelden
<!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>Resultaat
0 1 CKTIS
Sla het voorbeeld op als `.html`-bestand, open het in een apart browsertabblad en bekijk de ontwikkelaarsconsole. Na het wissen van de selectie verschijnt `0`; na het toevoegen van het bereik verschijnen `1` en `CKTIS`. Aan het einde wist de code de selectie en verwijdert ze de tijdelijke alinea. De vorige selectie wordt niet hersteld.
Gerelateerde lessen
- JavaScript · Les 33 · Gemiddeld · Versie: 3