Integración de funciones nativas de Electron

Electron es potente porque no solo puede escribir frontend, sino que también puede acceder a las funciones nativas del sistema, como menús, diálogos, bandeja, notificaciones y atajos globales de teclado, etc.

En este capítulo veamos cómo invocar estas funciones mediante los módulos del proceso principal.


Sistema de menús

Electron proporcionaMenuun módulo para crear barras de menú, menús contextuales y menús de bandeja del sistema.

Menú de aplicación (Menu)

El menú de aplicación es una barra de menú que se muestra en la parte superior de la ventana (macOS) o en la ventana de la aplicación.

Ejemplo

const { app, Menu } = require('electron')

const template = [
  {
    label: 'Archivo',
    submenu: [
      { label: 'Nuevo archivo', accelerator: 'CmdOrCtrl+N', click: () => console.log('Nuevo archivo') },
      { label: 'Abrir...', accelerator: 'CmdOrCtrl+O' },
      { type: 'separator' },
      { label: 'Salir', role: 'quit' }
    ]
  },
  {
    label: 'Editar',
    submenu: [
      { role: 'undo' },
      { role: 'redo' },
      { type: 'separator' },
      { role: 'cut' },
      { role: 'copy' },
      { role: 'paste' }
    ]
  }
]

const menu = Menu.buildFromTemplate(template)
Menu.setApplicationMenu(menu)

Nota:

  • label: título del menú.
  • submenu: array de submenús.
  • accelerator: atajo de teclado (notación común para macOS y Windows)CmdOrCtrl+X)。
  • role: comportamiento predefinido del sistema, comoquit、copy、paste。
  • click: función callback del evento de clic.

Menú contextual (Context Menu)

El menú contextual se activa normalmente en el proceso de renderizado:

Ejemplo

// main.js
const { ipcMain, Menu } = require('electron')

ipcMain.on('show-context-menu', (event) => {
  const menu = Menu.buildFromTemplate([
    { label: 'Recargar', click: () => event.sender.reload() },
    { label: 'Copiar', role: 'copy' },
    { label: 'Pegar', role: 'paste' }
  ])
  menu.popup()
})

Ejemplo

// renderer.js
window.addEventListener('contextmenu', (e) => {
  e.preventDefault()
  window.electronAPI.showContextMenu()
})

Menú de la bandeja del sistema

Muestra un icono y un menú en el área de notificación del sistema.

Ejemplo

const { Tray, Menu, nativeImage } = require('electron')
let tray = null

function createTray() {
  const icon = nativeImage.createFromPath('icon.png')
  tray = new Tray(icon)
  const contextMenu = Menu.buildFromTemplate([
    { label: 'Abrir ventana principal', click: () => mainWindow.show() },
    { label: 'Salir', click: () => app.quit() }
  ])
  tray.setToolTip('Mi aplicación Electron')
  tray.setContextMenu(contextMenu)
}

Atajos de teclado del menú

Medianteacceleratorse define. Por ejemplo:

{ label: '保存', accelerator: 'CmdOrCtrl+S', click: saveFile }
  • CmdOrCtrl: se adapta automáticamente a macOS/Windows.
  • Alt+F4: cierra la ventana en Windows.
  • Cmd+Q: sale de la aplicación en macOS.

Diálogos del sistema

dialogEl módulo proporciona diálogos nativos del sistema para archivos, mensajes, errores, etc.

Selección de archivos/carpetas
const { dialog } = require('electron')
async function openFileDialog() {
  const result = await dialog.showOpenDialog({
    title: '选择文件',
    properties: ['openFile', 'multiSelections'],
    filters: [{ name: '文本文件', extensions: ['txt', 'md'] }]
  })
  console.log(result.filePaths)
}

Diálogo de guardar

async function saveFileDialog() {
  const result = await dialog.showSaveDialog({
    title: '保存文件',
    defaultPath: '新建文档.txt'
  })
  console.log(result.filePath)
}

Diálogo de mensaje/error

dialog.showMessageBox({
  type: 'info',
  title: '提示',
  message: '操作已完成!'
})

dialog.showErrorBox('错误', '文件保存失败,请重试。')

Bandeja del sistema

La bandeja (Tray) permite que la aplicación siga interactuando a través del icono del sistema mientras se ejecuta en segundo plano.

Crear icono de bandeja

const { Tray } = require('electron')
const path = require('path')

let tray = new Tray(path.join(__dirname, 'trayIcon.png'))

Menú y tooltip de la bandeja

const contextMenu = Menu.buildFromTemplate([
  { label: '显示窗口', click: () => mainWindow.show() },
  { label: '退出', click: () => app.quit() }
])
tray.setToolTip('Electron 应用运行中')
tray.setContextMenu(contextMenu)

Notificaciones de la bandeja

tray.displayBalloon({
  icon: path.join(__dirname, 'icon.png'),
  title: '新消息',
  content: '您有一条新通知'
})

Minimizar a la bandeja

Escuchar el evento de cierre para ocultar la ventana:

mainWindow.on('close', (event) => {
  event.preventDefault()
  mainWindow.hide()
})

Notificaciones (Notifications)

La claseNotificationde Electron puede mostrar notificaciones del sistema en varias plataformas.

Envío de notificaciones del sistema

new Notification({
  title: '任务完成',
  body: '您的文件已下载完成'
}).show()

Manejo de interacciones de notificaciones

const notif = new Notification({ title: '点击通知', body: '点击我触发事件' })
notif.on('click', () => {
  console.log('用户点击了通知')
})
notif.show()

Compatibilidad multiplataforma

  • macOS, Windows y Linux son compatibles;
  • En macOS, se debe habilitar el "permiso de notificaciones";
  • Linux generalmente requiere soporte del sistemalibnotify。

Atajos globales de teclado

A través deglobalShortcutse registran atajos de teclado a nivel del sistema.

Registro de atajos globales de teclado

const { globalShortcut } = require('electron')

app.whenReady().then(() => {
  globalShortcut.register('CmdOrCtrl+Shift+I', () => {
    console.log('快捷键触发:打开调试工具')
    mainWindow.webContents.openDevTools()
  })
})

Manejo de conflictos de atajos de teclado

Se puede comprobar antes de registrar:

if (globalShortcut.isRegistered('CmdOrCtrl+Shift+I')) {
  console.log('快捷键已被占用')
}

Manejo de diferencias de plataforma

Se puede usar una condición para determinar:

const shortcut = process.platform === 'darwin' ? 'Cmd+Shift+T' : 'Ctrl+Shift+T'
globalShortcut.register(shortcut, () => console.log('快捷键触发'))

Resumen

Función Módulo Uso típico
Menú Menu Menú de aplicación, menú contextual, menú de bandeja
Diálogo dialog Abrir archivos, guardar archivos, mostrar avisos o errores
Bandeja Tray Ejecución en segundo plano, visualización del estado del sistema
Notificación Notification Informar al usuario sobre el progreso de eventos, recordatorios del sistema
Atajos globales de teclado globalShortcut Registrar operaciones rápidas a nivel del sistema

Proyecto de demostración de funciones nativas de Electron

Estructura del proyecto

my-electron-native-demo/
├── package.json
├── main.js             # 主进程逻辑
├── preload.js          # 预加载脚本(安全通信)
└── index.html          # 主界面

package.json

Nota: no escriba comentarios en archivos JSON (de lo contrario, se producirá un error EJSONPARSE)

{
  "name": "my-electron-native-demo",
  "version": "1.0.0",
  "description": "Electron 原生功能演示项目",
  "main": "main.js",
  "scripts": {
    "start": "electron ."
  },
  "devDependencies": {
    "electron": "latest"
  }
}

Instalar dependencias:

npm install

Iniciar la aplicación:

npm start

main.js (proceso principal)

Ejemplo

const { app, BrowserWindow, Menu, Tray, dialog, Notification, globalShortcut, ipcMain } = require('electron')
const path = require('path')

let mainWindow, tray

function createWindow() {
  mainWindow = new BrowserWindow({
    width: 900,
    height: 600,
    webPreferences: {
      preload: path.join(__dirname, 'preload.js')
    }
  })

  mainWindow.loadFile('index.html')

  // Se muestra cuando la página ha terminado de cargar
  mainWindow.once('ready-to-show', () => mainWindow.show())

  // Escuchar el cierre de la ventana: minimizar a la bandeja
  mainWindow.on('close', (event) => {
    event.preventDefault()
    mainWindow.hide()
  })
}

function createMenu() {
  const template = [
    {
      label: 'Archivo',
      submenu: [
        { label: 'Abrir archivo', click: openFile },
        { label: 'Guardar archivo', click: saveFile },
        { type: 'separator' },
        { label: 'Salir', click: () => app.quit() }
      ]
    },
    {
      label: 'Herramientas',
      submenu: [
        { label: 'Mostrar notificación', click: showNotification },
        { label: 'Acerca de', click: showAbout }
      ]
    }
  ]

  const menu = Menu.buildFromTemplate(template)
  Menu.setApplicationMenu(menu)
}

function createTray() {
  const icon = path.join(__dirname, 'icon.png')  // Prepare un icono de 16x16 o 32x32
  tray = new Tray(icon)
  const contextMenu = Menu.buildFromTemplate([
    { label: 'Mostrar ventana', click: () => mainWindow.show() },
    { label: 'Salir', click: () => app.quit() }
  ])
  tray.setToolTip('Demostración de funciones nativas de Electron')
  tray.setContextMenu(contextMenu)
}

function registerShortcuts() {
  globalShortcut.register('CmdOrCtrl+Shift+I', () => {
    mainWindow.webContents.openDevTools()
  })
}

async function openFile() {
  const result = await dialog.showOpenDialog({
    properties: ['openFile'],
    filters: [{ name: 'Archivo de texto', extensions: ['txt', 'md'] }]
  })
  if (!result.canceled && result.filePaths.length > 0) {
    mainWindow.webContents.send('file-opened', result.filePaths[0])
  }
}

async function saveFile() {
  const result = await dialog.showSaveDialog({
    title: 'Guardar archivo',
    defaultPath: 'Nuevo documento.txt'
  })
  if (!result.canceled) {
    dialog.showMessageBox({ type: 'info', message:`El archivo se guardará en: ${result.filePath}` })
  }
}

function showNotification() {
  const notif = new Notification({
    title: 'Notificación de Electron',
    body: '¡Esto es una notificación del sistema!'
  })
  notif.on('click', () => {
    dialog.showMessageBox({ message: '¡Hiciste clic en la notificación!' })
  })
  notif.show()
}

function showAbout() {
  dialog.showMessageBox({
    type: 'info',
    title: 'Acerca de',
    message: 'Proyecto de demostración de funciones nativas de Electron\nVersión: 1.0.0'
  })
}

// Llamada desde el proceso de renderizado
ipcMain.handle('show-dialog', async () => {
  const result = await dialog.showMessageBox({
    type: 'info',
    title: 'Desde el proceso principal',
    message: '¡Este es un diálogo mostrado por el proceso principal!'
  })
  return result.response
})

// Ciclo de vida
app.whenReady().then(() => {
  createWindow()
  createMenu()
  createTray()
  registerShortcuts()
})

app.on('window-all-closed', () => {
  if (process.platform !== 'darwin') app.quit()
})

preload.js (puente de seguridad)

Ejemplo

const { contextBridge, ipcRenderer } = require('electron')

contextBridge.exposeInMainWorld('electronAPI', {
  showDialog: () => ipcRenderer.invoke('show-dialog')
})

index.html (interfaz de frontend)

Ejemplo

<!DOCTYPE html>
<html lang="zh">
<head>
  <meta charset="UTF-8">
  <title>Demostración de funciones nativas de Electron</title>
  <style>
    body { font-family: sans-serif; text-align: center; margin-top: 80px; }
    button { padding: 10px 20px; margin: 10px; font-size: 16px; cursor: pointer; }
    #filePath { color: #666; font-size: 14px; }
  </style>
</head>
<body>
  <h1>Demostración de funciones nativas de Electron</h1>
  <p><button id="dialogBtn">Mostrar diálogo</button></p>
  <p id="filePath"></p>

  <script>
    document.getElementById('dialogBtn').addEventListener('click', async () => {
      await window.electronAPI.showDialog()
    })

    const filePathEl = document.getElementById('filePath')
    window.electronAPI && window.electronAPI.fileOpened && window.electronAPI.fileOpened((path) => {
filePathEl.textContent = 'Ruta del archivo abierto: ' + path
   })
 </script>
</body>
</html>

Después de ejecutarnpm startlas funciones son las siguientes:

  • La barra de menú superior contiene los menús 'Archivo' y 'Herramientas'.
  • 'Archivo' → Abrir archivo / Guardar archivo invoca los diálogos del sistema.
  • 'Herramientas' → Mostrar notificación del sistema, mostrar la ventana 'Acerca de'.
  • Aparece un icono de la aplicación en el área de bandeja; se puede hacer clic derecho para mostrar el menú.
  • Después de cerrar la ventana, se minimiza a la bandeja.
  • Registro de atajos globales de tecladoCmdOrCtrl+Shift+IAbrir las herramientas de desarrollo.
Otras extensiones