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