textarea: многострочный ввод

Конструктор textarea.New не принимает аргументов — в отличие от таблицы и списка с их опциями-функциями, конфигурация идёт по полям и сеттерам. Placeholder ставится присваиванием, фокус включается методом Focus, размеры — SetWidth и SetHeight. Value возвращает весь текст вместе с переносами, SetValue ставит его целиком, InsertString вставляет строку под курсором, Reset чистит поле. Фокус возвращает tea.Cmd — команду мигания курсора, и в Init уходит готовый textarea.Blink, как у textinput. Схема хранения та же, что во всех bubbles: поле ta textarea.Model в корневой модели, пересылка сообщений в Update, вызов ta.View() в общей раскладке. Отдельная приятность: поле знает свои строки и символы — LineCount возвращает число строк, Length — число символов, и эти два числа закрывают половину вопросов к заметкам.

Placeholder — подсказка, которую поле рисует, пока значение пустое: серым, без курсора, до первого нажатия. CharLimit — жёсткий потолок символов на весь текст: вставка и ввод просто перестают принимать лишнее, а не падают. По умолчанию лимит равен нулю, то есть отключён, — в примерах его ставят явно, и это правильная привычка для заметок с сохранением на диск. По умолчанию поле имеет ширину сорок и высоту шесть строк; размеры меняются SetWidth и SetHeight, а MaxHeight ограничивает высоту сверху и важен, когда вы растягиваете поле под окно: больше ста строк редактор в любом случае не отдаст. Важно понимать, что высота фиксирована, а не растёт по содержимому: лишний текст скроллится внутри поля, как в viewport, курсор сам увлекает прокрутку за собой. Счётчик оставшихся символов собирается из Length и CharLimit одной строкой в статус-баре.

Главная ловушка компонента — Enter. У textarea по умолчанию Enter и ctrl+m вставляют перенос строки: переслали нажатие полю — получили вторую строку, а не отправку формы. Для однострочных форм решение есть в самой модели: отключить привязку m.KeyMap.InsertNewline.SetEnabled(false), тогда Enter до поля дойдёт и умрёт, а приложение обработает его как отправку. Для заметок всё наоборот: перенос нужен, и форма отправляется другой клавишей — ctrl+s в официальном примере. Вставка из буфера прилетает в Update пачкой символов и вставляется целиком: если в буфере лежит десять строк, все десять появятся в поле, а CharLimit честно обрежет хвост, который перестал влезать. С этим связано второе живое правило парсинга: пользователь вставит что угодно, включая пробелы и пустые строки, — и заметка на диске должна это пережить.

Заметка, сохранённая целиком одной строкой в файл, обратно превращается в данные простым разбором. Value отдаёт текст с переносами; strings.Split по переводу строки режет его на строки, TrimSpace чистит крайние пробелы, фильтр по пустоте выбрасывает случайные дыры. Дальше начинается семантика вашего формата: строка, начинающаяся с дефиса и пробела, — пункт чек-листа, строка с датой — комментарий с меткой времени. Сравните LineCount и длину среза после разбиения: они почти всегда равны, но хвостовые пустые строки в разборе стоит игнорировать явно, а не надеяться на поле. Для валидации длины годится Length: заметка длиннее лимита уходит в ошибку ещё до записи на диск. Этот же разбор — мост к хранению: в итоговом проекте заметки к задачам лягут в файл рядом с самими задачами.

ShowLineNumbers включает столбец номеров слева — по умолчанию он включён, и под него резервируется четыре колонки: три цифры и отступ. Слева от каждой строки рисуется промпт — по умолчанию толстая вертикальная черта и пробел, как у редакторов из набора Charm. Цвет текущей строки, номеров и промпта собран в структуре стилей с парой FocusedStyle и BlurredStyle: поле само перекрашивается при потере фокуса, и в стилях уже спрятаны адаптивные цвета, о которых честно поговорит пятнадцатый урок. Здесь же — правило, записанное прямо в исходниках: SetWidth обязан вызываться после установки Prompt и ShowLineNumbers, потому что ширина поля считается как запрошенная минус промпт и номера строк. Поменяли внешность после SetWidth — позовите SetWidth ещё раз, иначе текст будет упираться в невидимый резерв.

Заметка не бывает без владельца: в уроке про таблицу выбранная строка задачи — ровно та сущность, к которой редактор прикручивается боковой панелью. Два поля рядом — уже форма, и тонкости переключения фокуса по Tab, экранных форм и кнопок разбирает урок про фокус и формы. Оба компонента — таблица и редактор — составляют ядро итогового проекта курса, где заметки сохраняются в файл и парсятся по правилам этого урока. План всей программы — на странице курса Bubble Tea. Практика: добавьте к полю счётчик оставшихся символов, отключите номера строк и следите за шириной, затем соберите разбор заметки на пункты чек-листа и выведите их списком под редактором.