bubbles/table: таблицы данных

Таблица описывается двумя срезами. Колонка — тип table.Column с полями Title (заголовок) и Width (ширина колонки в символах). Строка — тип table.Row, под которым прячется просто []string: значения по порядку колонок. Ключевое правило: строки рисуются по числу колонок, и значение, не влезающее в свою Width, честно обрезается с многоточием — сетка не поедет никогда. Конструктор table.New принимает опции: WithColumns задаёт колонки, WithRows — данные, WithFocused — фокус при старте, WithHeight — высоту таблицы, WithWidth — ширину. Курсор — это не координаты на экране, а индекс выбранной строки: метод Cursor возвращает его, SetCursor ставит с зажимом в допустимые границы. Отсюда простая привычка: думать о таблице как о данных с индексом, а не как о разметке.

Первое, что ловит всех новичков: WithHeight задаёт высоту таблицы целиком, вместе со строкой заголовка. Попросили семь — увидите шесть строк данных. Логика внутри честная: из высоты вычитается высота headersView, остаток отдаётся встроенному viewport. Если строк больше, чем влезает, прокрутка появляется сама, и курсор, дойдя до края, увлекает её за собой. Ширина работает иначе: SetWidth задаёт ширину окна, в котором живёт таблица, но колонки от этого не растягиваются — их ширина та, что вы указали в Column. Что не влезло в окно, обрезается на краю терминала, поэтому сумма Width колонок должна вписываться в ваш экран. Клавиши движения предустановлены и совпадают со списком из девятого урока: стрелки и j/k по строке, страницы и половины страницы, прыжки в начало и конец. Полный набор — в таблице ниже, а помощь можно рисовать через HelpView — метод существует, но в View он не выводится сам.

Таблица — подмодель, и всё движение клавиш живёт в одной ветке Update. Нюанс, на котором спотыкаются: без фокуса Update у таблицы игнорирует любые клавиши молча, ни ошибки, ни движения. Поэтому в примерах вокруг таблицы всегда есть ветка esc: она снимает и возвращает фокус через Blur и Focus, оставляя таблицу на экране, но отдавая клавиши остальному приложению. Второй нюанс — тип возвращаемого значения. Метод Update у table.Model возвращает пару (table.Model, tea.Cmd), а не (tea.Model, tea.Cmd), как у progress в двенадцатом уроке: там результат приходилось доставать утверждением типа, здесь присваивание прямое. Это мелочь, но именно на таких мелочах держится ощущение однородности восьмого урока: каждая библиотечная подмодель чуть-чуть своя, и шаблон пересылки копируется не вслепую, а глазами.

Статичная таблица — редкость: обычно данные приезжают из команды — список задач из сети, результаты сканирования из воркера. Схема та же, что в двенадцатом уроке: команда возвращает сообщение, Update раскладывает его по модели. Для строк у таблицы есть пара SetRows и Rows: первый кладёт новый срез и сам обновляет внутренний viewport, второй отдаёт текущие данные, если их нужно доработать. Есть и мост из простого мира текстовых файлов — метод FromValues разбирает строку вида «a,b c,d» с указанным разделителем и превращает её в строки таблицы, удобно для CSV-выгрузок без внешних библиотек. И живая граблина: в текущей версии bubbles после SetRows курсор не поджимается под новый размер. Строк было сто, стало три, курсор остался на девяносто девятой — SelectedRow вернёт nil, и первый же выбор по enter уронит обращение по индексу. Поджимайте вручную: SetCursor(len(rows) - 1) сразу после SetRows, если строк стало меньше, чем был курсор.

Внешний вид таблицы собран в структуре table.Styles из трёх стилей Lip Gloss — она появится в пятнадцатом уроке во всей красе, а здесь достаточно имен. Header красит строку заголовков: по умолчанию жирный текст с отступом по одному пробелу. Cell — базовый вид ячейки, те же отступы. Selected — наложение на всю выбранную строку целиком: жирный текст цветом 212 по палитре ANSI. Меняется всё через SetStyles: возьмите DefaultStyles как базу, подправьте нужное поле и отдайте обратно — таблица сразу перерисует содержимое. Именно так официальный пример снимает жирность с заголовка и красит выделение фиолетовым фоном. Здесь же есть подвох: Selected работает поверх строки, поэтому его фон перекрывает фон ячеек — цветные статусы в колонках лучше выбирать так, чтобы они читались и под выделением.

Таблица не живёт одна. Выбранная строка просит подробного описания — заметки к задаче вводятся многострочным полем, и этим занимается урок про textarea: таблица и редактор вместе дают полноценную панель задач. Цвета заголовка и выделения здесь названы вскользь — урок про Lip Gloss разберёт стили терминала по-настоящему, от ANSI-кодов до рамок. В итоговом проекте таблица займёт центр экрана и будет кормиться данными из файлового воркера. Если вы знакомы с десктопным GUI по курсу Fyne, взгляните для сравнения на таблицы там — задача та же, а слов на настройку уходит заметно больше. Практика: соберите таблицу из урока, урежьте высоту до пяти, добавьте четвёртую колонку длительности и убедитесь, что при ширине терминала в восемьдесят символов она уже не влезает — почувствуйте, почему горизонтальной прокрутки просит каждый второй.