Intégration des fonctionnalités natives d'Electron

Electron est puissant car il permet non seulement d'écrire du code frontend, mais aussi d'accéder aux fonctionnalités natives du système, telles que les menus, les boîtes de dialogue, la barre d'état système, les notifications et les raccourcis globaux.

Dans cette section, nous verrons comment appeler ces fonctionnalités via les modules du processus principal.


Système de menus

Electron fournitMenuLe module est utilisé pour créer des barres de menus, des menus contextuels et des menus de la barre d’état système.

Menu de l’application (Menu)

Le menu de l’application est une barre de menus affichée en haut de la fenêtre (macOS) ou dans la fenêtre de l’application.

Exemple

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

const template = [
  {
    label: 'Fichier',
    submenu: [
      { label: 'Nouveau fichier', accelerator: 'CmdOrCtrl+N', click: () => console.log('Nouveau fichier') },
      { label: 'Ouvrir...', accelerator: 'CmdOrCtrl+O' },
      { type: 'separator' },
      { label: 'Quitter', role: 'quit' }
    ]
  },
  {
    label: 'Édition',
    submenu: [
      { role: 'undo' },
      { role: 'redo' },
      { type: 'separator' },
      { role: 'cut' },
      { role: 'copy' },
      { role: 'paste' }
    ]
  }
]

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

Description:

  • label: Titre du menu.
  • submenu: Tableau de sous-menus.
  • acceleratorRaccourcis clavier (notation courante pour macOS, WindowsCmdOrCtrl+X)。
  • role: Comportements prédéfinis par le système, tels quequit、copy、paste。
  • click: Fonction de rappel de l'événement de clic.

Menu contextuel

Les menus contextuels sont généralement déclenchés dans le processus de rendu :

Exemple

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

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

Exemple

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

Menu de la zone de notification

Afficher une icône et un menu dans la zone de notification du système.

Exemple

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: 'Ouvrir la fenêtre principale', click: () => mainWindow.show() },
    { label: 'Quitter', click: () => app.quit() }
  ])
  tray.setToolTip('Mon application Electron')
  tray.setContextMenu(contextMenu)
}

Raccourcis de menu

ViaacceleratorDéfinition. Par exemple :

{ label: '保存', accelerator: 'CmdOrCtrl+S', click: saveFile }
  • CmdOrCtrl: S'adapte automatiquement à macOS/Windows.
  • Alt+F4: Windows ferme la fenêtre.
  • Cmd+Q: macOS quitte l'application.

Boîtes de dialogue système

dialogLe module fournit des boîtes de dialogue système natives pour les fichiers, les messages, les erreurs, etc.

Sélection de fichier/dossier
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)
}

Boîte de dialogue d'enregistrement

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

Boîte de dialogue de message/erreur

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

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

Zone de notification

La zone de notification (Tray) permet à l'application d'interagir via l'icône système lorsqu'elle s'exécute en arrière-plan.

Créer une icône de zone de notification

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

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

Menu et infobulle de la zone de notification

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

Notification de la zone de notification

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

Réduire dans la zone de notification

Écouter les événements de fermeture pour masquer la fenêtre :

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

Notifications

D'ElectronNotificationLa classe peut afficher des notifications système sur toutes les plateformes.

Envoi de notifications système

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

通知交互处理

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

跨平台兼容性

  • 支持 macOS、Windows 和 Linux;
  • macOS 需要启用 "通知权限";
  • Linux 通常需要系统支持libnotify。

全局快捷键

ViaglobalShortcut注册系统级热键.

注册全局快捷键

const { globalShortcut } = require('electron')

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

快捷键冲突处理

可在注册前检测:

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

平台差异处理

可用性检查:

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

Résumé

Fonctionnalités Module Utilisation typique
Menu Menu Menu d'application, menu contextuel, menu de la zone de notification
boîte de dialogue dialog Ouvrir des fichiers, enregistrer des fichiers, afficher des alertes ou des erreurs
Zone de notification Tray Exécution en arrière-plan, affichage de l'état du système
Notification Notification Notifier les utilisateurs de la progression des événements, rappels système
全局快捷键 globalShortcut Enregistrer des opérations de raccourci au niveau système

Projet de démonstration des fonctionnalités natives d'Electron

Structure du projet

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

package.json

Remarque : n'écrivez pas de commentaires dans les fichiers JSON (sinon une erreur EJSONPARSE sera signalée).

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

Installer les dépendances :

npm install

Démarrer l'application :

npm start

main.js (processus principal)

Exemple

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')

  // Afficher après le chargement complet de la page
  mainWindow.once('ready-to-show', () => mainWindow.show())

  // Écouter la fermeture de la fenêtre : réduire dans la barre d'état
  mainWindow.on('close', (event) => {
    event.preventDefault()
    mainWindow.hide()
  })
}

function createMenu() {
  const template = [
    {
      label: 'Fichier',
      submenu: [
        { label: 'Ouvrir un fichier', click: openFile },
        { label: Enregistrer le fichier, click: saveFile },
        { type: 'separator' },
        { label: 'Quitter', click: () => app.quit() }
      ]
    },
    {
      label: 'Outils',
      submenu: [
        { label: Afficher la notification, click: showNotification },
        { label: 'À propos', click: showAbout }
      ]
    }
  ]

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

function createTray() {
  const icon = path.join(__dirname, 'icon.png')  // Veuillez préparer une icône de 16x16 ou 32x32
  tray = new Tray(icon)
  const contextMenu = Menu.buildFromTemplate([
    { label: Afficher la fenêtre, click: () => mainWindow.show() },
    { label: 'Quitter', click: () => app.quit() }
  ])
  tray.setToolTip('Démo des fonctionnalités natives d’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: 'Fichier texte', 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: Enregistrer le fichier,
    defaultPath: 'Nouveau document.txt'
  })
  if (!result.canceled) {
    dialog.showMessageBox({ type: 'info', message:`Le fichier sera enregistré dans : ${result.filePath}` })
  }
}

function showNotification() {
  const notif = new Notification({
    title: 'Notification Electron',
    body: 'Ceci est une notification système !'
  })
  notif.on('click', () => {
    dialog.showMessageBox({ message: 'Vous avez cliqué sur la notification !' })
  })
  notif.show()
}

function showAbout() {
  dialog.showMessageBox({
    type: 'info',
    title: 'À propos',
    message: 'Projet de démonstration des fonctionnalités natives d’Electron\n'Version: 1.0.0'
  })
}

// Appel du processus de rendu
ipcMain.handle('show-dialog', async () => {
  const result = await dialog.showMessageBox({
    type: 'info',
    title: 'Du processus principal',
    message: 'Ceci est une boîte de dialogue affichée par le processus principal !'
  })
  return result.response
})

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

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

preload.js (pont sécurisé)

Exemple

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

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

index.html (interface front-end)

Exemple

<!DOCTYPE html>
<html lang="zh">
<head>
  <meta charset="UTF-8">
  <title>Démonstration des fonctionnalités natives d'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>Démo des fonctionnalités natives d'Electron</h1>
  <p><button id="dialogBtn">Afficher la boîte de dialogue</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 = 'Chemin du fichier ouvert : ' + path
   })
 </script>
</body>
</html>

Exécuteznpm startEnsuite, les fonctions sont les suivantes :

  • La barre de menus supérieure contient les menus "Fichier" et "Outils".
  • "Fichier" → Ouvrir un fichier / Enregistrer un fichier ouvre la boîte de dialogue système.
  • "Outils" → Afficher une notification système, afficher la fenêtre "À propos".
  • Une icône d'application apparaît dans la zone de notification, et vous pouvez faire un clic droit pour afficher un menu.
  • Réduire dans la zone de notification après la fermeture de la fenêtre.
  • 注册全局快捷键CmdOrCtrl+Shift+IOuvrir les outils de développement.
autres extensions