События и обработчики

Начнём с того, что уже знаешь. У widget.Button есть поле OnTapped — функция без аргументов, которую кнопка вызывает по клику; widget.NewButton(text, fn) — просто сахар над ним. Но кнопка не особенная: за кликами стоит интерфейс fyne.Tappable с двумя методами. Tapped(fyne.PointEvent) приходит по нажатию левой кнопки мыши, TappedSecondary(fyne.PointEvent) — правой. Реализовать интерфейс может любой CanvasObject: драйвер на каждом клике находит верхний объект под курсором и проверяет его через type assertion. Аргумент события — fyne.PointEvent с двумя координатами: AbsolutePosition указывает точку в системе окна, RelativePosition — внутри самого объекта. Для кнопки координаты не нужны, а для своей интерактивной плитки — самое то: клик в левую половину и клик в правую могут значить разное. Вот так работают все fyne события: интерфейс решает, кто слушает, твоя функция — что делать. Кнопка из третьего урока оказалась не особым случаем, а одним из многих слушателей, — и это правило ты используешь в восьмом уроке, когда соберёшь свой первый виджет.

Tappable — не единственный слушатель. У тулкита есть компактное семейство интерфейсов, и каждый виджет выбирает себе нужные. Перетаскивание — fyne.Draggable с методами Dragged(fyne.DragEvent) и DragEnd: событие тащит новые координаты, а DragEnd сообщает, что пользователь отпустил объект. Колесо мыши — fyne.Scrollable с единственным методом Scrolled(fyne.ScrollEvent), у которого есть DeltaX и DeltaY. Наведение и движение — fyne.Mouseable: MouseIn, MouseMoved и MouseOut дают сделать hover-эффекты и всплывающие подсказки. Клавиатура — fyne.Focusable, о нём отдельно ниже. Комбинации клавиш — fyne.Shortcutable с методом TypedShortcut. Все эти интерфейсы собраны в корневом пакете fyne, и драйвер проверяет их тем же type assertion, что и Tappable. Так работает вся система: никаких наследников и переопределений — только интерфейсы Go и честная утиная типизация. Проектировать такие контракты мы подробно разбирали в продвинутом курсе, а здесь достаточно уметь их читать: увидел в описании виджета интерфейс — значит, умеет такие-то события.

Клавиатура приходит двумя каналами, и перепутать их — классическая ошибка. Канал первый — TypedRune(r rune): печатный символ после раскладки и модификаторов. Пользователь нажал Ш с зажатым Shift на русской раскладке — в TypedRune придёт символ «Ш»; переключил раскладку — придёт другой символ. Всё, что превращается в текст, ловится здесь. Канал второй — TypedKey(*fyne.KeyEvent): физическая клавиша без привязки к раскладке. У события есть поле Name со значениями fyne.KeyUp, fyne.KeyDown, fyne.KeyEscape, fyne.KeyReturn, fyne.KeySpace и другими константами пакета. Стрелки, Escape, Enter и функциональные клавиши — территория TypedKey: текста они не производят, зато управляют навигацией. Правило запоминания простое: текст — TypedRune, навигация и системные клавиши — TypedKey. Перехватить нажатия для всего окна можно на canvas: window.Canvas().SetOnTypedRune(fn) и window.Canvas().SetOnTypedKey(fn). Так устроены обработчики fyne: интерфейс или canvas решает, кто слушает, твоя функция — что делать. Глобальный перехватчик окна получает нажатия независимо от того, стоит ли фокус в поле ввода, — поэтому аккорды вроде Escape работают из любого места.

Клавиатурные события адресные. Прежде чем буква попадёт в глобальный перехватчик, тулкит спрашивает: у кого фокус? Фокус — это ссылка на один объект, которому доставляются TypedRune и TypedKey; у объекта, реализующего fyne.Focusable, есть ещё FocusGained и FocusLost — моменты включения и выключения подсветки. Entry — фокусируемый виджет: клик по полю даёт ему фокус, дальше буквы идут в его TypedRune, а Tab ходит по полям формы из пятого урока — тулкит строит цепочку автоматически. Управлять фокусом из кода можно через canvas: canvas.Focus(obj), canvas.Unfocus() и canvas.Focused() — текущий владелец. Если делаешь свой объект, который должен принимать ввод, реализуй Focusable и получи фокус по клику через Tapped — так делают списки, которые слушают стрелки, и свои поля ввода. Разница между глобальным перехватчиком и фокусом принципиальна для проектирования: SetOnTypedKey на canvas — это аккорды уровня окна, Focusable — адресный ввод конкретному элементу. Восемнадцатый урок добавит фокусу ещё одну роль: ошибки валидации рисуются у поля, когда оно теряет фокус, поэтому реакция на FocusLost — половина UX любой формы. И ещё один практический совет: если поле должно пустить дальше только заполненный ввод, проверь его в OnSubmitted, а не в глобальном перехватчике — событие адресное, и код читается локально.

События клавиш — низкий уровень: сравнивать ev.Name с константами вручную удобно, пока комбинаций мало. Для настоящих аккордов у тулкита есть fyne.Shortcut — интерфейс, описывающий комбинацию, и готовые реализации: ShortcutCopy, ShortcutPaste, ShortcutCut, ShortcutSelectAll. Их Entry и текстовые виджеты обрабатывают сами — Ctrl+C и Ctrl+V работают из коробки, регистрировать их не нужно. Свои комбинации описываются литералом fyne.CustomShortcut: поле KeyName — клавиша, поле Modifier — модификаторы fyne.ControlModifier, fyne.AltModifier, fyne.ShiftModifier или fyne.SuperModifier. Регистрация — на canvas окна: window.Canvas().AddShortcut(shortcut, handler). Отсюда видно, как единообразно устроены fyne события: есть объект-событие, есть обработчик, есть место регистрации. Уровнем ниже живёт fyne.ShortcutHandler — маленький диспетчер, который хранит пары «шорткат — функция»; виджеты, реализующие Shortcutable, используют его внутри, а тебе обычно хватает AddShortcut на canvas. Комбинация сначала предлагается фокусированному виджету — так Entry успевает перехватить свои копирование и вставку, — а глобальные обработчики canvas срабатывают из любого места окна. Выбирая клавиши для своих аккордов, не наступай на стандартные: Ctrl+C и Ctrl+V уже заняты текстовыми полями, а Ctrl+Q многие пользователи ждут как выход. Пара модификаторов Shift и буква — хороший резерв для действий с выделением, Alt — для навигации, Ctrl — для главных действий окна.

Все события из этого урока — Tapped, TypedKey, OnChanged — приходят в твои функции из цикла событий, то есть из главного потока GUI. Пока обработчик работает, интерфейс не рисует и не принимает ввод: поставь внутрь Tapped цикл на три секунды — и окно замрёт до конца цикла. Правило простое: обработчик меняет состояние и зовёт Refresh, а долгую работу — чтение файла, сетевой запрос, тяжёлый расчёт — выноси в горутину. Но из чужой горутины трогать виджеты нельзя: тулкит требует возвращаться в главный поток, и с версии 2.6.0 для этого есть fyne.Do — функция, ставящая твой код в очередь главного потока. Полный разбор многопоточности с примерами и граблями — двадцатый урок курса, там же узнаешь, как это устроено внутри драйвера. Сейчас достаточно запомнить пропорцию: событие → быстрый обработчик → Refresh; всё, что дольше пары миллисекунд, — в горутину и обратно через fyne.Do. Проверить себя легко: если окно перестало отзываться на клики — где-то в обработчике живёт долгий цикл.

Событие получено, состояние изменено, Refresh позван — но что именно рисует рендерер? Внутри любого виджета лежат примитивы пакета canvas: прямоугольники, круги, линии и текст. Седьмой урок — Canvas: примитивы рисования — научит красить экран напрямую и станет фундаментом для собственного виджета из восьмого. Если нужно освежить, как ведут себя Label и Entry, — вернись к третьему уроку; раскладку контейнерами Box напомнит четвёртый, а формы с валидацией — пятый, они сегодня встречались в каждом примере. События — половина кастомного виджета, вторая половина — рисование: именно их соединение в восьмом уроке даст тебе контрол с нуля. Полный маршрут из двадцати пяти уроков — на странице курса. В домашнем задании ты прикрутишь клавиатуру и горячие клавиши к форме входа из прошлого урока.