Перейти к основному содержанию

Class: MenuItem

Class: MenuItem

Добавляет элементы в основное меню и контекстное меню приложения.

Процесс: Главный

Просмотрите Menu для примеров использования.

new MenuItem(options)

  • options Object
    • click Function (optional) - Will be called with click(menuItem, browserWindow, event) when the menu item is clicked.
    • role String (optional) - Can be undo, redo, cut, copy, paste, pasteAndMatchStyle, delete, selectAll, reload, forceReload, toggleDevTools, resetZoom, zoomIn, zoomOut, toggleSpellChecker, togglefullscreen, window, minimize, close, help, about, services, hide, hideOthers, unhide, quit, startSpeaking, stopSpeaking, zoom, front, appMenu, fileMenu, editMenu, viewMenu, shareMenu, recentDocuments, toggleTabBar, selectNextTab, selectPreviousTab, mergeAllWindows, clearRecentDocuments, moveTabToNewWindow or windowMenu - Define the action of the menu item, when specified the click property will be ignored. Смотрите роли.
    • type String (опционально) - Может быть normal, separator, submenu, checkbox или radio.
    • label String (опционально)
    • sublabel String (опционально)
    • toolTip String (optional) macOS - Hover text for this menu item.
    • accelerator Accelerator (опционально)
    • icon (NativeImage | String) (опционально)
    • enabled Boolean (опционально) - Если false, пункт меню выделится серым цветом и не будет нажимться.
    • acceleratorWorksWhenHidden Boolean (optional) macOS - default is true, and when false will prevent the accelerator from triggering the item if the item is not visible`.
    • visible Boolean (опционально) - Если false, пункт меню будет полностью скрыт.
    • checked Boolean (опционально) - Должно быть указано только для checkbox или radio типов элементов меню.
    • registerAccelerator Boolean (optional) Linux Windows - If false, the accelerator won't be registered with the system, but it will still be displayed. Defaults to true.
    • sharingItem SharingItem (optional) macOS - The item to share when the role is shareMenu.
    • submenu (MenuItemConstructorOptions[] | Menu) (опционально) - Необходимо указать для submenu типы элементов меню. Если submenu указано, то type: 'submenu' может быть опущен. Если значение не является Menu то оно будет автоматически преобразовано в значение Menu.buildFromTemplate.
    • id String (optional) - Unique within a single menu. If defined then it can be used as a reference to this item by the position attribute.
    • before String[] (опционально) - Вставляет этот элемент перед элементом с указанным названием. Если указанный элемент не существует, то элемент будет вставлен в конец меню. Кроме того, подразумевается, что рассматриваемый элемент меню размещен в той же "группе", что и сам элемент.
    • after String[] (optional) - Inserts this item after the item with the specified label. Если ссылаемый элемент не существует, тогда элемент будет вставлен в конец меню.
    • beforeGroupContaining String[] (опционально) - Предоставляет возможность в одном контекстном меню объявить размещение группы, содержащей элемент, перед группой, содержащей элемент с указанной меткой.
    • afterGroupContaining String[] (опционально) - Предоставляет возможность в одном контекстном меню объявить размещение группы, содержащей элемент, после группы, содержащей элемент с указанной меткой.

Note: acceleratorWorksWhenHidden is specified as being macOS-only because accelerators always work when items are hidden on Windows and Linux. Эта опция доступна пользователям для того, чтобы дать им возможность отключить ее, так как это возможно в родной macOS разработке. Это свойство можно использовать только на macOS High Sierra 10.13 или новее.

Роли

Роли позволяют элементам класса menu иметь заранее определенные поведения.

Лучше всего указать role для любого элемента меню, который соответствует стандартной роли, а не пытаться вручную реализовать поведение в функции click. Встроенное поведение role даст наилучшую нативную возможность использования.

Значения label и accelerator необязательны при использовании role и по умолчанию будут присваиваться для каждой для каждой платформы.

Каждый элемент меню должен иметь role или label, или в случае разделителя type.

Свойство role может иметь следующие значения:

  • undo - Отменить
  • about - Trigger a native about panel (custom message box on Window, which does not provide its own).
  • redo - Восстановить
  • cut - Вырезать
  • copy - Копировать
  • paste - Вставить
  • pasteAndMatchStyle - Вставить и применить стиль
  • selectAll - Выделить все
  • delete - Удалить
  • minimize - Свернуть текущее окно.
  • close - Закрыть текущее окно.
  • quit - Выйти из приложения.
  • reload - Перезагрузить текущее окно.
  • forceReload - Перезагрузить текущее окно, игнорировать кэш.
  • toggleDevTools - Включить инструмент разработчика для текущего окна.
  • togglefullscreen -Включить полноэкранный режим для текущего окна.
  • resetZoom - Сброс измененного масштаба страницы до исходного размера.
  • zoomIn - Увеличение масштаба страницы на 10%.
  • zoomOut - Уменьшение масштаба страницы на 10%.
  • toggleSpellChecker - Enable/disable builtin spell checker.
  • fileMenu - Полное меню "Файл" по умолчанию (Закрыть/Выйти)
  • editMenu - Whole default "Edit" menu (Undo, Copy, etc.).
  • viewMenu - Полное меню "Вид" по умолчанию (перезагрузка, переключение инструментов разработчика и т. д.)
  • windowMenu - Полное меню "Окно" по умолчанию (Свернуть, масштаб и т. д.).

The following additional roles are available on macOS:

  • appMenu - Полное меню "App" по умолчанию (О программе, службах и т. д.)
  • hide - Map to the hide action.
  • hideOthers - Map to the hideOtherApplications action.
  • unhide - Map to the unhideAllApplications action.
  • startSpeaking - Map to the startSpeaking action.
  • stopSpeaking - Map to the stopSpeaking action.
  • front - Map to the arrangeInFront action.
  • zoom - Map to the performZoom action.
  • toggleTabBar - Map to the toggleTabBar action.
  • selectNextTab - Map to the selectNextTab action.
  • selectPreviousTab - Map to the selectPreviousTab action.
  • mergeAllWindows - Map to the mergeAllWindows action.
  • moveTabToNewWindow - Map to the moveTabToNewWindow action.
  • window - The submenu is a "Window" menu.
  • help - The submenu is a "Help" menu.
  • services - Подменю меню "Сервисы". This is only intended for use in the Application Menu and is not the same as the "Services" submenu used in context menus in macOS apps, which is not implemented in Electron.
  • recentDocuments - The submenu is an "Open Recent" menu.
  • clearRecentDocuments - Map to the clearRecentDocuments action.
  • shareMenu - The submenu is share menu. The sharingItem property must also be set to indicate the item to share.

При задании role на macOS, label и accelerator являются единственными параметрами, которые влияют на пункт меню. Все остальные параметры будут проигнорированы. Нижний регистр role, например toggledevtools, все еще поддерживается.

Nota Bene: The enabled and visibility properties are not available for top-level menu items in the tray on macOS.

Свойства экземпляра

Для экземпляров MenuItem доступны следующие свойства:

Строка с указанием уникального id элемента, это свойство может быть динамически изменено.

A String indicating the item's visible label.

A Function that is fired when the MenuItem receives a click event. It can be called with menuItem.click(event, focusedWindow, focusedWebContents).

Menu (опционально), содержащие подменю пункты, если таковые имеются.

Строка с указанием типа элемента. Can be normal, separator, submenu, checkbox or radio.

String (опционально) с указанием роли элемента, если установлено. Can be undo, redo, cut, copy, paste, pasteAndMatchStyle, delete, selectAll, reload, forceReload, toggleDevTools, resetZoom, zoomIn, zoomOut, toggleSpellChecker, togglefullscreen, window, minimize, close, help, about, services, hide, hideOthers, unhide, quit, startSpeaking, stopSpeaking, zoom, front, appMenu, fileMenu, editMenu, viewMenu, shareMenu, recentDocuments, toggleTabBar, selectNextTab, selectPreviousTab, mergeAllWindows, clearRecentDocuments, moveTabToNewWindow or windowMenu

An Accelerator (optional) indicating the item's accelerator, if set.

An Accelerator | null indicating the item's user-assigned accelerator for the menu item.

Note: This property is only initialized after the MenuItem has been added to a Menu. Either via Menu.buildFromTemplate or via Menu.append()/insert(). Accessing before initialization will just return null.

NativeImage | Строка (опционально) с указанием иконки элемента, если установлено.

A String indicating the item's sublabel.

String с указанием текста, который появляется при наведении курсора на элемент.

Boolean указывает, включен ли элемент, это свойство может быть динамически изменено.

Boolean указывает, видим ли элемент, это свойство может быть динамически изменено.

Boolean указывает, помечен ли элемент флажком, это свойство может быть динамически изменено.

Элемент меню checkbox будет включать и выключать свойство checked при его выборе.

Radio пункт меню включит его свойство checked при нажатии, и отключит это свойство для всех смежных пунктов в том же меню.

Вы можете добавить функцию click для дополнительного поведения.

A Boolean indicating if the accelerator should be registered with the system or just displayed.

This property can be dynamically changed.

A SharingItem indicating the item to share when the role is shareMenu.

This property can be dynamically changed.

Номер с указанием уникального последовательного идентификатора элемента.

Меню, частью которого является элемент.