База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

HTMLTextAreaElement.selectionStart — начало на избора

HTMLTextAreaElement.selectionStart прочита или задава началото на избора в елемент 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.selectionStart
textarea.selectionStart = offset

HTMLTextAreaElement.selectionStart е свойство на контролата textarea, на което може да се задава стойност. Заедно с selectionEnd определя диапазон: началото е включено, а краят — изключен. Когато няма избран текст, и двете стойности указват позицията на курсора.

Отместванията броят UTF-16 кодови единици във value: 😀 заема две. При присвояване Web IDL първо преобразува стойността в 32-битово цяло число без знак. Позицията се ограничава до края на текста само ако преобразуваната стойност надвишава дължината на текста. Например присвояването на 2 ** 32 задава начало на позиция 0, защото преобразуването дава 0. Ако така полученото начало е след досегашния край, краят се премества на същата позиция и изборът се свива до една точка.

Това е API на браузъра от HTML Standard, а не функция на ECMAScript; само версията на Node.js не доказва, че се поддържа. Примерът използва контрола, която не е добавена към документа: състоянието ѝ на избор може да се прочете без визуализиране.

Примери

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);

Резултат

1 3
😀
4 4

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници