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 = endHTMLTextAreaElement.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.