Меню и тулбары

Пункт меню — обычная структура с говорящими полями, и полезно знать их все. Label — подпись; Action func() — действие по клику, которое вызывается в момент выбора пункта. Icon fyne.Resource добавляет иконку слева от подписи — откуда брать ресурсы, шестнадцатый урок. Disabled приглушает пункт и отключает реакцию на клик: команда неприменима, пока не открыт документ. Checked рисует галочку — так делают переключатели вроде «Автосохранение»; поле ты меняешь сам и сам зовёшь menu.Refresh(), чтобы галочка перерисовалась. IsSeparator превращает пункт в разделитель, и для него есть фабрика fyne.NewMenuItemSeparator. IsQuit помечает пункт, завершающий приложение. Shortcut (с версии 2.2) хранит fyne.Shortcut для горячей клавиши — подпись о ней покажет, но надёжный триггер ты вешаешь сам через AddShortcut на канвасе, как в шестом уроке; не рассчитывай на автоматическое срабатывание. Наконец, ChildMenu — вложенное меню, подменю: пункт становится папкой, по клику раскрывается список его детей. Все поля мутируемые — меню это данные, и их можно менять на ходу, о чём ниже.

Раз меню — структура, его можно менять в любой момент работы: добавить пункт после успешной загрузки плагина, включить «Сохранить», когда появился документ, поставить галочку у активного режима. Правило то же, что и с виджетами: после изменения поля пункта или списка Items вызови menu.Refresh() — и все места, где меню уже отрисовано, перечитают данные. У fyne.Menu и fyne.MainMenu есть свои методы Refresh с версии 2.2, а радикальный путь — снова позвать window.SetMainMenu с новой структурой. Практический приём: держи пункты как поля структуры приложения — openItem, saveItem, prefsItem — и управляй их флагами Disabled и Checked из бизнес-логики. Меню перестаёт быть статичной картинкой и становится проекцией состояния: недоступный документ — серый «Сохранить», включённый тёмный режим — галочка у соответствующего пункта «Вида». Данные первичны, экран догоняет — тот же договор, что у списка с updateItem из десятого урока.

Второй жанр команд — toolbar fyne-тулбар: горизонтальная полоса иконок-кнопок, которую обычно кладут в верхнюю ячейку Border-компоновки, сразу под заголовком окна. Собирается widget.NewToolbar из элементов-ToolbarItem; каждый реализует один метод ToolbarObject() fyne.CanvasObject — то, что показать в полосе. Готовых элементов три: widget.NewToolbarAction(иконка, функция) — кнопка, widget.NewToolbarSeparator() — тонкая линия-разделитель, widget.NewToolbarSeparator-близнец widget.NewToolbarSpacer() — пружина, прижимающая последующие элементы вправо, как layout.NewSpacer в четвёртом уроке. Кнопка внутри тулбара — обычный widget.Button с низкой важностью, поэтому у ToolbarAction с версии 2.2 есть SetIcon для смены иконки, а с 2.5 — Enable, Disable и Disabled для управления доступностью. Пополняется полоса на ходу: t.Append(item) добавляет в конец, t.Prepend(item) — в начало. И раз каждый элемент — просто объект с одним методом, в тулбар можно вписать что угодно, например подпись: объяви тип с встроенным *widget.Label и методом ToolbarObject — интерфейс будет доволен. Иконки для тулбара берутся из темы или из своих ресурсов — тема шестнадцатого урока перекрасит их сама.

Третий жанр — контекстное меню, всплывающее там, где кликнули. Событие правого клика в fyne — метод TappedSecondary из интерфейса fyne.SecondaryTappable: на десктопе это правая кнопка мыши, на мобильных — долгий тап; обычный левый клик живёт в парном Tapped из шестого урока. Клик ты ловишь на своём объекте — у примитивов интерфейса нет, поэтому берётся либо виджет, либо маленький кастомный контрол на BaseWidget, как учил восьмой урок. Показывает меню функция widget.ShowPopUpMenuAtPosition(menu, canvas, position): она создаёт всплывающее окно-оверлей поверх интерфейса, а закрывается оно само — по выбору пункта или клику мимо. Позицию бери из события: e.AbsolutePosition даёт координаты относительно всего канваса, и меню откроется точно под курсором. Есть и синоним widget.ShowPopUpMenuAtRelativePosition(menu, canvas, rel, to) — для позиций, посчитанных относительно конкретного объекта. Контекстные меню и диалоги-подтверждения из тринадцатого урока хорошо работают в паре: пункт «Удалить» в попапе открывает dialog.ShowConfirm.

Правило трёх путей гласит: важное действие дублируется кнопкой, пунктом меню и горячей клавишей — все три зовут одну и ту же функцию, а не три копии кода. Отсюда практика: вынеси команды в методы структуры приложения — app.Save(), app.Open() — и навешивай их откуда угодно. В меню не сваливай всё подряд: оно для команд уровня документа и приложения, а для частых операций существует тулбар и панель инструментов справа. Заголовки держи короткими и глагольными: «Открыть...» с многоточием обещает диалог, «О программе» — окно информации. Пункт с тяжёлым или необратимым действием — «Удалить всё» — сначала подтверждается диалогом из тринадцатого урока. Доступность тоже на меню: Disabled-пункты сообщают пользователю, что команда существует, но сейчас неприменима, а Checked-переключатели не дублируют настройку в трёх местах. И помни про тон нативности: на macOS не перехватывай Ctrl в горячих клавишах — fyne.Shortcut из шестого урока различает модификаторы, а системное меню добавит свои стандартные пункты само.

Меню и тулбар выкрашиваются активной темой — как её настроить и сделать свою, расскажет следующий, пятнадцатый урок; там же поймёшь, почему пункты меню перекрашиваются сами, а твои примитивы — нет. Иконки для тулбара и пунктов — это ресурсы: встроенный набор темы, свои PNG через embed и утилита fyne bundle — территория шестнадцатого урока. Подтверждения для опасных команд берутся из тринадцатого урока про диалоги, события правого клика и горячие клавиши — из шестого, Border-компоновка под тулбар — из четвёртого, а виджеты-кнопки с иконками — из третьего. Каркас приложения с app.New и ShowAndRun — во втором; полный маршрут курса — на странице Fyne. Дальше по программе — привязка данных в семнадцатом уроке: пункты меню с Checked — отличные кандидаты на живую связь с настройками, но пока ты управляешь ими руками.