MenuItem
Clase: MenuItem
Agregue elementos a los menús y menús de contexto de la aplicación nativa.
Proceso: principal
See Menu
for examples.
[!WARNING] Electron's built-in classes cannot be subclassed in user code. For more information, see the FAQ.
new MenuItem(options)
acceleratorWorksWhenHidden
is specified as being macOS-only because accelerators always work when items are hidden on Windows and Linux. La opción esta expuesta a los usuarios para darles a ellos la opción de apagarla, ya que esto es posible el el desarrollo nativo de macOS.
Propiedades de la instancia
Las siguientes propiedades están disponibles en instancias del menú de elementos
:
menuItem.id
A string
indicating the item's unique id. This property can be dynamically changed.
menuItem.label
Un string
indicando la etiqueta visible del elemento.
menuItem.click
Una función
que se desencadena cuando los elementos del menú reciben un evento click. Puede ser llamado con menuItem.click(event, focusedWindow, focusedWebContents)
.
event
KeyboardEventfocusedWindow
BaseWindowfocusedWebContents
WebContents
menuItem.submenu
Un Menú
(opcional) que contiene el submenú del menú elemento, si está presente.
menuItem.type
Un string
indicando el tipo del elemento. Can be normal
, separator
, submenu
, checkbox
, radio
, header
or palette
.
header
and palette
are only available on macOS 14 and up.
menuItem.role
Una string
(opcional) indicando el rol del elemento, si está establecido. 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
, showAllTabs
, mergeAllWindows
, clearRecentDocuments
, moveTabToNewWindow
or windowMenu
menuItem.accelerator
Un Accelerator
(opcional) indicando el acelerador del elemento, si está establecido.
menuItem.userAccelerator
Readonly macOS
Un Accelerator | null
indicando el user-assigned accelerator del elemento para el menú del elemento.
[!NOTE] This property is only initialized after the
MenuItem
has been added to aMenu
. Ya sea a través deMenu.buildFromTemplate
o a través deMenu.append()/insert()
. Accediendo antes de la inicialización solo devolveránull
.
menuItem.icon
A NativeImage | string
(optional) indicating the item's icon, if set.
menuItem.sublabel
A string
indicating the item's sublabel.
menuItem.toolTip
macOS
A string
indicating the item's hover text.
menuItem.enabled
A boolean
indicating whether the item is enabled. This property can be dynamically changed.
menuItem.visible
A boolean
indicating whether the item is visible. This property can be dynamically changed.
menuItem.checked
A boolean
indicating whether the item is checked. This property can be dynamically changed.
Un elemento del menú checkbox
que cambiará la propiedad verificado
en sí y no cuando se selecciona.
Un elemento del menú radio
que activará su propiedad verificado
cuando se haga click en él, y que desactivará su propiedad para todos los elementos adyacentes en el mismo menú.
Puede añadir la función click
para comportamientos adicionales.
menuItem.registerAccelerator
A boolean
indicating if the accelerator should be registered with the system or just displayed.
Esta propiedad puede ser cambiada dinámicamente.
menuItem.sharingItem
macOS
Un SharingItem
indicando el elemento a compartir cuando el role
es shareMenu
.
Esta propiedad puede ser cambiada dinámicamente.
menuItem.commandId
A number
indicating an item's sequential unique id.
menuItem.menu
Un Menu
del cual el elemento es parte.