CKTIS / JavaScript
HTMLTextAreaElement.selectionStart — begin van de selectie
HTMLTextAreaElement.selectionStart leest of stelt het begin van de selectie in een textarea-element in. De offset begint bij nul en telt UTF-16-code-eenheden in plaats van zichtbare tekens.
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.selectionStart
textarea.selectionStart = offsetHTMLTextAreaElement.selectionStart is een schrijfbare eigenschap van een textarea-besturingselement. Samen met selectionEnd bepaalt deze een bereik: het begin is inbegrepen en het einde uitgesloten. Zonder selectie geven beide waarden de cursorpositie aan.
De offsets tellen UTF-16-code-eenheden in value: 😀 neemt er twee in. Bij een toewijzing zet Web IDL de waarde eerst om in een 32-bits geheel getal zonder teken. De positie wordt alleen begrensd tot het einde van de tekst als de omgezette waarde groter is dan de tekstlengte. Als je bijvoorbeeld 2 ** 32 toewijst, komt het begin op 0 te staan, omdat de omzetting 0 oplevert. Ligt het zo bepaalde begin voorbij het huidige einde, dan verschuift het einde naar dezelfde positie en wordt de selectie opgeheven.
Dit is een browser-API uit de HTML Standard, geen ECMAScript-functie; alleen de Node.js-versie bewijst niet dat de API wordt ondersteund. Het voorbeeld gebruikt een niet aan het document toegevoegd besturingselement: de selectiestatus kan worden gelezen zonder het weer te geven.
Voorbeelden
const textarea = document.createElement('textarea');
textarea.value = 'A😀BC';
textarea.setSelectionRange(1, 3);
console.log(textarea.selectionStart, textarea.selectionEnd);
console.log(textarea.value.slice(textarea.selectionStart, textarea.selectionEnd));
textarea.selectionStart = 4;
console.log(textarea.selectionStart, textarea.selectionEnd);Resultaat
1 3 😀 4 4
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.