Projet pratique React + Electron

Dans ce chapitre, nous allons utiliser React + Electron pour créer une application de prise de notes. Ce projet pratique est nommé ReactElectronNotes, et ses fonctionnalités incluent la prise en charge multi-fenêtres, la zone de notification, les opérations sur les fichiers et la communication IPC. C'est un projet très adapté aux débutants pour s'exercer.

Si vous n'êtes pas encore familiarisé avec React, vous pouvez consulter :Tutoriel React。

ReactElectronNotesLe projet vous apprendra à construire, à partir de zéro, uneapplication de prise de notes de bureau multiplateforme, incluant les fonctionnalités suivantes :

  • Rendu front-end React
  • Gestion du processus principal Electron
  • Communication IPC (processus principal ↔ processus de rendu)
  • Persistance locale des données de notes (electron-store)
  • Intégration de la zone de notification et des menus

Description de la structure du projet

ReactElectronNotes/
│
├── src/                  # React 源码目录
├── build/                # 打包后的 React 静态文件
├── electron-main.js      # Electron 主进程
├── preload.js            # 渲染与主进程通信桥
├── note.html             # 子窗口页面
├── note.js               # 子窗口脚本
├── package.json
└── assets/
    └── icon.png          # 托盘图标

I. Aperçu des fonctionnalités du projet

Module fonctionnel Description
fenêtre principale Afficher la liste de toutes les notes
fenêtre enfant Saisie de nouvelle note
Stockage local Utilisationelectron-storeEnregistrer les données
Zone de notification Réduire dans la zone de notification système, cliquer pour faire apparaître l'interface principale
Communication IPC Le processus de rendu interagit avec le processus principal pour lire et écrire des données.

2. Initialisation du projet

1. Créer un projet React

npx create-react-app ReactElectronNotes
cd ReactElectronNotes

2. Installer Electron et ses dépendances

npm install --save-dev electron electron-builder concurrently wait-on
npm install electron-store

3. Modifierpackage.json

Assurez-vous quescriptsAjouter la commande de démarrage d'Electron dans :

"main": "electron-main.js",
"scripts": {
  "react-start": "react-scripts start",
  "react-build": "react-scripts build",
  "electron-start": "concurrently \"npm run react-start\" \"wait-on http://localhost:3000 && electron .\"",
  "electron-build": "react-scripts build && electron-builder"
}

3. Créer le processus principal d'Electron

Nouveau fichierelectron-main.js:

Exemple

const { app, BrowserWindow, Tray, Menu, ipcMain } = require('electron')
const path = require('path')
const Store = require('electron-store')

let mainWindow, noteWindow, tray
const store = new Store()

function createMainWindow() {
  mainWindow = new BrowserWindow({
    width: 800,
    height: 600,
    webPreferences: {
      preload: path.join(__dirname, 'preload.js'),
      contextIsolation: true,
      nodeIntegration: false
    }
  })

  if (process.env.NODE_ENV === 'development') {
    mainWindow.loadURL('http://localhost:3000')
  } else {
    mainWindow.loadFile(path.join(__dirname, 'build/index.html'))
  }

  mainWindow.on('minimize', (e) => {
    e.preventDefault()
    mainWindow.hide()
  })

  createTray()
}

function createNoteWindow() {
  noteWindow = new BrowserWindow({
    width: 400,
    height: 300,
    parent: mainWindow,
    modal: true,
    webPreferences: {
      preload: path.join(__dirname, 'preload.js'),
      contextIsolation: true,
      nodeIntegration: false
    }
  })

  noteWindow.loadFile(path.join(__dirname, 'note.html'))
}

function createTray() {
  tray = new Tray(path.join(__dirname, 'assets/icon.png'))
  const menu = Menu.buildFromTemplate([
    { label: Afficher la fenêtre, click: () => mainWindow.show() },
    { label: 'Quitter', click: () => app.quit() }
  ])
  tray.setToolTip('ReactElectronNotes')
  tray.setContextMenu(menu)
}

app.whenReady().then(createMainWindow)

ipcMain.handle('get-notes', () => {
  return store.get('notes', [])
})

ipcMain.on('save-note', (event, note) => {
  const notes = store.get('notes', [])
  notes.push(note)
  store.set('notes', notes)
  mainWindow.webContents.send('update-notes', notes)
})

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

4. Créer le script de préchargement

Nouveaupreload.js:

Exemple

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

contextBridge.exposeInMainWorld('electronAPI', {
  getNotes: () => ipcRenderer.invoke('get-notes'),
  saveNote: (note) => ipcRenderer.send('save-note', note),
  onUpdateNotes: (callback) => ipcRenderer.on('update-notes', callback)
})

Description:
ViacontextBridgeExposer les API de manière sécurisée au processus de rendu.


V. Interface frontend React

src/App.js

Exemple

import React, { useState, useEffect } from 'react'

function App() {
  const [notes, setNotes] = useState([])

  useEffect(() => {
    window.electronAPI.getNotes().then(setNotes)
    window.electronAPI.onUpdateNotes((_event, newNotes) => setNotes(newNotes))
  }, [])

  const openNoteWindow = () => {
    window.open('note.html', Nouvelle note, 'width=400,height=300')
  }

  return (
    <div style={{ padding: 20 }}>
      <h1>Mes notes</h1>
      <button onClick={openNoteWindow}>Nouvelle note</button>
      <ul>
        {notes.map((n, i) => (
          <li key={i}>{n}</li>
        ))}
      </ul>
    </div>
  )
}

export default App

Nouveaunote.htmletnote.js

note.html

Exemple

<!DOCTYPE html>
<html lang="zh">
<head>
  <meta charset="UTF-8">
  <title>Nouvelle note</title>
</head>
<body>
  <h2>Nouvelle note</h2>
  <textarea id="note"></textarea><br>
  <button id="saveBtn">Enregistrer</button>
  <script src="note.js"></script>
</body>
</html>

note.js

Exemple

const saveBtn = document.getElementById('saveBtn')
saveBtn.addEventListener('click', () => {
  const note = document.getElementById('note').value
  if (note.trim()) {
    window.electronAPI.saveNote(note)
    window.close()
  }
})

6. Exécution et empaquetage

Démarrer l'environnement de développement

npm run electron-start

Après l'ouverture, la fenêtre principale React apparaîtra. Vous pouvez cliquer sur "Nouvelle note" pour faire apparaître une fenêtre de saisie.

Empaqueter et publier

npm run electron-build

Générera des fichiers exécutables multiplateformes (.exe、.app、.AppImageetc.).


7. Orientations des extensions

Fonctionnalités Approche
Prise en charge de Markdown Utilisationreact-markdownAfficher le contenu
Recherche de données Côté React viafilter()Implémenter la recherche locale
Sauvegarde automatique Écouter le champ de saisieonChangeSauvegarde automatique
synchronisation cloud Intégrer Firebase ou une API REST auto-construite
Raccourcis UtilisationglobalShortcutEnregistrer Ctrl+N pour créer une nouvelle note
autres extensions