CKTIS / JavaScript
HTMLTextAreaElement.selectionStart — início da seleção
HTMLTextAreaElement.selectionStart lê ou define o início da seleção num elemento textarea. O deslocamento, contado a partir de zero, corresponde a unidades de código UTF-16 e não a caracteres visíveis.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
textarea.selectionStart
textarea.selectionStart = offsetHTMLTextAreaElement.selectionStart é uma propriedade modificável de um controlo textarea. Em conjunto com selectionEnd, define um intervalo: o início é incluído e o fim é excluído. Quando não existe seleção, ambos os valores indicam a posição do cursor.
Os deslocamentos contam unidades de código UTF-16 em value: 😀 ocupa duas. Na atribuição, a Web IDL converte primeiro o valor num inteiro de 32 bits sem sinal. A posição só é limitada ao fim do texto se o valor convertido exceder o comprimento do texto. Por exemplo, atribuir 2 ** 32 coloca o início na posição 0, porque a conversão dá 0. Se o início assim obtido ficar depois do fim atual, o fim é movido para a mesma posição e a seleção reduz-se a um ponto.
Esta é uma API do navegador definida pelo HTML Standard, não uma funcionalidade ECMAScript; a versão do Node.js, por si só, não comprova que exista suporte. O exemplo utiliza um controlo desligado do documento: é possível ler o respetivo estado de seleção sem o renderizar.
Exemplos
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);Resultado
1 3 😀 4 4
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.