Виджеты: базовые

Вспомним анатомию из первого урока: виджет — это CanvasObject с поведением, а внешний вид вынесен в WidgetRenderer. Когда состояние виджета меняется, кто-то должен сказать рендереру «перерисуйся» — это делает Refresh(). Так вот, методы-сеттеры — SetText, SetChecked, SetValue, Disable — делают ровно две вещи: записывают новое значение в поле и вызывают Refresh. Поля у виджетов публичные, и компилятор не запретит тебе написать button.Text = "Готово" напрямую. Значение в поле запишется — а экран нет: рендерер о новом состоянии не узнал, Refresh никто не вызвал. Классический симптом: логика отработала, переменные верные, а интерфейс показывает старьё. Отсюда правило урока: меняешь виджет — вызывай сеттер, а не трогай поле. Прямое присваивание оправдано только в связке с ручным Refresh() — так делают внутри самих сеттеров и при массовом обновлении, но в обычном коде это лишний шанс забыть перерисовку. Читаемость тоже выигрывает: по вызову SetText видно намерение, по присваиванию поля — нет.

Кнопка — самый востребованный из fyne виджетов, и запросы вроде fyne button ведут на неё же. Внутри у неё четыре главных поля: Text — надпись, Icon — иконка fyne.Resource, Importance — «важность» внешнего вида и OnTapped — функция, которую цикл событий вызовет по клику. Фабрика NewButton(label, tapped) заполняет Text и OnTapped одним вызовом; есть и NewButtonWithIcon для кнопки с иконкой, полезной в тулбарах. Importance появился в версии 1.4 и управляет заметностью: HighImportance красит кнопку в primary-цвет темы — главное действие; LowImportance наоборот убирает часть оформления — второстепенное; DangerImportance — для разрушительных действий вроде удаления, у него красная заливка. Менять важно только сеттером SetImportance по тому же правилу. Вторая способность кнопки — временный запрет: Disable() делает её серой и нечувствительной к кликам, Enable() возвращает; состояние читает Enabled(). Типовой сценарий: форма невалидна — кнопка «Сохранить» заблокирована, поле заполнили корректно — Enable. Нажатие заблокированной кнопки не вызывает OnTapped — обработчик просто не сработает.

Label — метка, нередактируемый текст: статусы, подписи полей, результаты расчёта. Главный метод тебе уже знаком — SetText. Стилизация идёт через fyne.TextStyle: структура с флагами Bold, Italic, Monospace, BoldItalic — для моноширинных значений вроде ID и IP-адресов Monospace незаменим. Выравнивание задаётся fyne.TextAlign: Leading, Center, Trailing. Всё это одной фабрикой: widget.NewLabelWithStyle("Готово к работе", fyne.TextAlignCenter, fyne.TextStyle{Bold: true}) — и есть одноимённый метод SetTextStyle и SetTextAlignment, чтобы менять стиль по ходу работы. С версии 2.4 у Label появилось поле Importance — им помечают предупреждающий и приглушённый текст, например серым рисуют недоступные значения; и Truncation — что делать с длинной строкой: переносить или обрезать многоточием. Если текста в метке становится много и нужен цвет, абзацы и вставки — это территория RichText, разберём его в девятом уроке про текст и ввод. Пока правило простое: одна строка или абзац статуса — Label, всё сложнее — RichText.

Entry — рабочая лошадь ввода, и у неё несколько лиц. NewMultiLineEntry даёт многострочное поле для комментариев и заметок; у многострочного Enter вставляет перевод строки, а отправка срабатывает по Shift+Enter, если OnSubmitted задан. NewPasswordEntry прячет символы и добавляет кнопку «показать» — специально сочинять маску не нужно. Значение читается полем Text в любой момент, пишется сеттером SetText — и да, заполнить поле программно перед показом формы — нормальный приём. Подсказка PlaceHolder экономит подпись над коротким полем. Отдельная тема — контроль ввода: у Entry есть SetValidator, функция, которая получает текст и возвращает nil или ошибку; поле само покажет ошибку под строкой и заблокирует «сломанное» состояние. Полный разбор валидации — восемнадцатый урок, а сегодня достаточно знать, что место для проверки уже предусмотрено архитектурой. Ещё полезно: Disable делает поле недоступным (не редактируется), Enable возвращает — удобно для режимов «только просмотр».

Check — ответ на булев вопрос: включить уведомления, согласиться с условиями, добавить в избранное. Фабрика NewCheck(label, changed) принимает подпись и функцию func(bool); состояние читает поле Checked, програмно ставит сеттер SetChecked — например, чтобы восстановить сохранённые настройки при старте. Обработчик получает новое значение, поэтому внутри него не нужно читать Checked: аргумент и есть текущее состояние. Когда вариантов больше двух, а выбрать нужно один, берут RadioGroup — круги с точкой: NewRadioGroup([]string{"Email", "SMS"}, func(value string)) — обработчик получает выбранную строку. Нужен выбор нескольких из многих — есть CheckGroup, многовыборочный родственник RadioGroup с SetSelected для списка отмеченных. Вариантов становится много и хочется их редактировать на ходу — у RadioGroup и Select есть SetOptions, заменяющая список опций целиком. И помни каталог: чекбокс — про «да/нет», радиокруги — про «ровно один», и не выворачивай их местами, пользователи читают форму именно так.

Select — выпадающий список для выбора одного значения из известного набора: тема, город, приоритет задачи. Фабрика NewSelect(options, changed): первый аргумент — слайс строк, второй — обработчик func(string), который получит выбранное значение. Текущий выбор лежит в поле Selected, програмно ставится SetSelected — так восстанавливают сохранённую опцию при запуске, а ClearSelected сбрасывает выбор до плейсхолдера. Пока ничего не выбрано, Select показывает подсказку: по умолчанию это «(Select one)», а поле PlaceHolder позволяет поставить своё, например «выберите тему». Обработчик срабатывает и на выбор опции, и на сброс — получая пустую строку, учитывай это. Менять список опций на лету умеет SetOptions — удобно для зависимых списков: выбрали страну, подгрузили города. Когда список должен и подсказывать, и принимать произвольный ввод, есть гибрид SelectEntry — селект с редактируемым полем; разберём его вместе с остальным вводом в девятом уроке. Для «да/нет» Select не нужен — это работа Check.

ProgressBar показывает известную долю завершённости. По умолчанию диапазон от 0 до 1: SetValue(0.25) — четверть, SetValue(1) — всё; надпись процента рисует сам виджет. Диапазон настраивается полями Min и Max: загрузили файл на 20 мегабайт — поставь Max = 20 и вызывай SetValue с мегабайтами, виджет сам переведёт в проценты. Но помни правило сеттеров: Value тоже поле, однако присваивание напрямую не перерисует полосу — только SetValue. Подпись по умолчанию — проценты; свою форматирование даёт поле TextFormatter (с версии 1.4): функция, возвращающая строку, которая пересчитывается при каждом обновлении значения, — например «3 из 12 файлов». Полезная оговорка честности: если длительность неизвестна, не выдумывай проценты — возьми ProgressBarInfinite, бесконечно движущуюся полосу занятости: SetValue для неё не имеет смысла, остановить индикатор можно Hide или удалением из контейнера. Прогресс из горутины обновляй только через fyne.Do из двадцатого урока — SetValue из чужого потока небезопасен.

Пройдём по типовым ситуациям. Статус операции («Файл сохранён», «Ошибка сети») — Label, при необходимости с Monospace для значений. Единственное главное действие формы — Button с HighImportance; разрушительное вроде «Удалить всё» — DangerImportance; вторичные действия — обычные или LowImportance. Ввод любых данных от человека — Entry: однострочное для полей, многострочное для текстов, парольное для секретов; подсказку в пустое поле ставь PlaceHolder, а не первой строкой значения. Переключатель режима «вкл/выкл» — Check. Выбор одной опции из трёх-пяти известных — Select; если опции — режимы с видимой альтернативой, RadioGroup покажет все варианты сразу без клика. Отчёт о ходе долгой операции — ProgressBar с честным диапазоном, а если честного процента нет — ProgressBarInfinite. Проверка ввода на корректность — это не про виджеты выбора: у Entry есть валидатор, и это восемнадцатый урок. А собирают все эти элементы вместе не в окне напрямую, а в контейнерах — этим занимается следующий, четвёртый урок.

Шесть виджетов из каталога — это стройматериал, но в окне он должен стоять по местам: колонкой, строкой, с отступами. Этим займётся четвёртый урок про контейнеры и компоновку Box — NewVBox, NewHBox, спейсеры и правило минимальных размеров. Дальше — пятый урок 05-grid-form с сетками и Form, который соберёт поля и подписи в готовую форму с валидацией. Если что-то из словаря урока забыл — вернись к установке и первому окну за каркасом запуска или к дебютному уроку курса за анатомией Widget/Renderer. Полная программа из двадцати пяти уроков — на странице курса Fyne. Домашнее задание ниже собирает всё в один файл — мини-настройки приложения, которые мы ещё вернём и подключим к хранилищу preferences в девятнадцатом уроке.