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 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
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
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
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 sistema
libnotify。
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 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
contextBridge.exposeInMainWorld('electronAPI', {
showDialog: () => ipcRenderer.invoke('show-dialog')
})
index.html (interfaz de frontend)
Ejemplo
<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 teclado
CmdOrCtrl+Shift+IAbrir las herramientas de desarrollo.