CKTIS / JavaScript
HTMLTextAreaElement.selectionEnd — край на избора
HTMLTextAreaElement.selectionEnd позволява да прочетете или зададете крайната граница на избора в textarea. Това е отместване, броено от нула в UTF-16 кодови единици; крайната позиция не е включена в избора.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
textarea.selectionEnd
textarea.selectionEnd = endHTMLTextAreaElement.selectionEnd е свойство за четене и запис. То указва позицията непосредствено след избрания текст в textarea.value. selectionStart и selectionEnd задават включено начало и изключен край. Когато няма избран текст, и двете стойности обозначават позицията на курсора.
Отместванията броят UTF-16 кодови единици, а не видими символи: някои емоджита заемат две единици. При textarea API използва стойността с нормализирани завършеци на редове, а не необработен текст, съдържащ CR.
Присвояването променя границата на избора, а не текста. Web IDL първо преобразува присвоената стойност към типа unsigned long. Ако получената стойност надхвърля дължината на текста, тя се ограничава до тази дължина. Например 2 ** 32 се преобразува в 0, така че присвояването на тази стойност задава края на 0, а не на дължината на текста в непразен елемент textarea. Ако новият край е преди selectionStart, началото също се премества до новия край и изборът се свива. Използвайте setSelectionRange(start, end), за да зададете двете граници едновременно.
Състоянието на избора съществува и за елемент, който не се визуализира, затова примерът не добавя контролата към документа. Това е API на браузъра, определено в HTML Standard, а не функция на езика ECMAScript; наличието на Node 24 не доказва, че API е достъпно.
Примери
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));Резултат
5 Hello Hel
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.