KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

HTMLTextAreaElement.selectionEnd — einde van de selectie

HTMLTextAreaElement.selectionEnd leest of stelt de eindgrens van een selectie in een textarea in. Het is een offset vanaf nul, gemeten in UTF-16-code-eenheden; de eindpositie hoort niet bij de selectie.

Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

textarea.selectionEnd
textarea.selectionEnd = end

HTMLTextAreaElement.selectionEnd is een leesbare en schrijfbare eigenschap. Deze geeft de positie direct na de geselecteerde tekst in textarea.value aan. selectionStart en selectionEnd beschrijven een inbegrepen begin en een uitgesloten einde. Als er geen selectie is, geven beide waarden de positie van de cursor aan.

Offsets tellen UTF-16-code-eenheden, niet zichtbare tekens: sommige emoji nemen twee eenheden in beslag. Voor textarea gebruikt de API de waarde met genormaliseerde regeleinden, niet de ruwe tekst met CR.

Een toewijzing verandert de selectiegrens, niet de tekst. Web IDL zet de toegewezen waarde eerst om naar het type unsigned long. Is de omgezette waarde groter dan de tekstlengte, dan wordt die waarde begrensd tot de tekstlengte. Zo wordt 2 ** 32 omgezet in 0. Als je die waarde toewijst, komt het einde dus op 0 te staan en niet op de tekstlengte van een niet-lege textarea. Als het nieuwe einde vóór selectionStart ligt, verschuift het begin ook naar het nieuwe einde en wordt de selectie opgeheven. Gebruik setSelectionRange(start, end) om beide grenzen tegelijk in te stellen.

De selectiestatus bestaat ook voor een element dat niet wordt weergegeven. Daarom voegt het voorbeeld het besturingselement niet aan het document toe. Dit is een browser-API die is vastgelegd in de HTML Standard, geen functie van de ECMAScript-taal; de aanwezigheid van Node 24 bewijst niet dat de API beschikbaar is.

Voorbeelden

const textarea = document.createElement('textarea');
textarea.value = 'Hello world';
textarea.setSelectionRange(0, 5);
console.log(textarea.selectionEnd);
console.log(textarea.value.slice(textarea.selectionStart, textarea.selectionEnd));
textarea.selectionEnd = 3;
console.log(textarea.value.slice(textarea.selectionStart, textarea.selectionEnd));

Resultaat

5
Hello
Hel

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen