Electron – Erstellen und Verwalten von Fenstern
In Electron sind Fenster (Window) das zentrale Medium für die Interaktion zwischen der Anwendung und dem Benutzer.
Alle sichtbaren Oberflächen laufen imRenderer Processund die Erstellung und Steuerung dieser Fenster wird vomMain Processverantwortet.
Fenster erstellen und verwalten
Electron überBrowserWindowKlasse zum Erstellen von Fenstern.
Im Hauptprozess wird ein neues Fenster auf folgende Weise definiert:
Beispiel
let mainWindow = new BrowserWindow({
width: 1200,
height: 800,
show: false, // Warten, bis die Seite bereit ist, bevor sie angezeigt wird
webPreferences: {
preload: path.join(__dirname, 'preload.js'),
},
})
BrowserWindow-Konfigurationsoptionen
width/height: Breite und Höhe des Fensters.minWidth/minHeight: Mindestgröße.resizable: Ob die Größenänderung erlaubt ist.fullscreen/fullscreenable: Ob der Vollbildmodus aktiviert werden soll.frame: Ob die native Titelleiste angezeigt werden soll (wird oft deaktiviert, wenn eine benutzerdefinierte Titelleiste verwendet wird).transparent: Transparentes Fenster (kann Effekte wie Milchglas, Schweben usw. erzielen).alwaysOnTop: Ob das Fenster immer im Vordergrund ist.
Fenstergröße, -position und -zustand
Der Fensterzustand kann über die API gesteuert werden:
mainWindow.maximize() // 最大化
mainWindow.minimize() // 最小化
mainWindow.restore() // 还原
mainWindow.setBounds({ x: 100, y: 100, width: 800, height: 600 }) // 调整位置和大小
Sie können auch auf Fensteränderungen lauschen:
mainWindow.on('resize', () => console.log('窗口尺寸变化'))
mainWindow.on('move', () => console.log('窗口移动'))
Rahmenlose Fenster und benutzerdefinierte Titelleiste
Einstellungenframe: falseAnschließend können Sie den Titelleistenbereich anpassen und das Ziehen mit CSS und JS simulieren:
.titlebar {
-webkit-app-region: drag;
}
Beachten Sie, dass nicht ziehbare Bereiche (wie Schaltflächen) mit Folgendem hinzugefügt werden sollten:
.titlebar {
-webkit-app-region: drag;
}
Fensterereignisse überwachen
mainWindow.on('close', (e) => {
e.preventDefault()
mainWindow.hide()
})
Zu den üblichen Ereignissen gehören:
ready-to-show: Die Seite wurde vollständig geladen und kann sicher angezeigt werden.focus/blur: Das Fenster erhält oder verliert den Fokus.closed: Das Fenster wurde zerstört.
Seiteninhalt wird geladen
Electron-Fenster können lokale HTML-Dateien oder entfernte Websites laden.
Lokale HTML-Dateien laden
mainWindow.loadFile('index.html')
Remote-URL laden
mainWindow.loadURL('https://example.com')
Verwendung von Frontend-Frameworks
Wenn Sie moderne Frameworks wie Vue, React oder Angular verwenden, können Sie die erstellten statischen Dateien in das Fenster laden:
mainWindow.loadFile(path.join(__dirname, 'dist/index.html'))
Oder laden Sie einen lokalen Dienst im Entwicklungsmodus:
mainWindow.loadURL('http://localhost:5173')
Kommunikation zwischen Fenstern
In Multi-Fenster-Anwendungen müssen Sie möglicherweise Daten zwischen Fenstern übergeben oder Verhalten steuern.
Eltern-Kind-Fenster-Beziehung
Kann beim Erstellen eines neuen Fensters angegeben werdenparent:
let child = new BrowserWindow({
parent: mainWindow,
modal: true, // 模态窗口
width: 400,
height: 300,
})
Wenn das übergeordnete Fenster geschlossen wird, werden untergeordnete Fenster ebenfalls automatisch geschlossen.
Multi-Fenster-Datenfreigabe
Sie können den Hauptprozess als Vermittler verwenden, um Daten zwischen verschiedenen Renderer-Prozessen auszutauschen, oder globale Objekte verwenden oderipcMain / ipcRenderer。
Fenster-Nachrichtenübermittlung
Der Hauptprozess kann direkt auf das Zielfenster zugreifen:
child.webContents.send('update-data', someData)
Im untergeordneten Fenster empfangen:
const { ipcRenderer } = require('electron')
ipcRenderer.on('update-data', (event, data) => {
console.log(data)
})
Optimierung der Benutzeroberfläche
Splash-Screen
Wenn das Hauptfenster langsam lädt, können Sie zuerst ein leichtgewichtiges Splash-Fenster anzeigen:
const splash = new BrowserWindow({ width: 400, height: 300, frame: false })
splash.loadFile('splash.html')
mainWindow.once('ready-to-show', () => {
splash.close()
mainWindow.show()
})
Optimierung der Fensteranzeige
Zu den gängigen Techniken zur Vermeidung von Weißbild-Flackern gehören:
- Nutzung
show: falseErstellen Sie ein Fenster, und nachdem das Laden abgeschlossen ist,show()。 - Legen Sie die Hintergrundfarbe auf der gerenderten Seite fest.
- Ressourcen vorladen (Icons, Schriftarten, Stile).
Techniken zur Vermeidung von Flackern
- Aktivieren Sie die GPU-Beschleunigung oder deaktivieren Sie die Hardwarebeschleunigung (je nach Situation).
- Vermeiden Sie komplexe Animationen oder Farbverläufe in CSS.
- Verwenden Sie doppelt gepuffertes Rendering, um Zeichen-Jitter zu reduzieren.
Multi-Fenster-Electron-Anwendung (einschließlich Splash-Seite, Hauptoberfläche und untergeordneten Fenstern)
Verzeichnisstruktur
my-electron-app/ ├── package.json ├── main.js # 主进程入口 ├── preload.js # 预加载脚本 ├── splash.html # 启动画面 ├── index.html # 主窗口页面 ├── child.html # 子窗口页面 └── renderer.js # 渲染进程逻辑
main.js (Hauptprozess)
Beispiel
const path = require('path')
let mainWindow, splash, childWindow
function createSplash() {
splash = new BrowserWindow({
width: 400,
height: 300,
frame: false,
transparent: true,
alwaysOnTop: true,
})
splash.loadFile('splash.html')
}
function createMainWindow() {
mainWindow = new BrowserWindow({
width: 1200,
height: 800,
show: false,
webPreferences: {
preload: path.join(__dirname, 'preload.js'),
},
})
mainWindow.loadFile('index.html')
// Nach Abschluss des Seitenladens anzeigen
mainWindow.once('ready-to-show', () => {
if (splash) splash.close()
mainWindow.show()
})
mainWindow.on('closed', () => (mainWindow = null))
}
function createChildWindow() {
childWindow = new BrowserWindow({
parent: mainWindow,
modal: true,
width: 400,
height: 300,
webPreferences: {
preload: path.join(__dirname, 'preload.js'),
},
})
childWindow.loadFile('child.html')
}
// Interprozesskommunikation
ipcMain.on('open-child', () => {
if (!childWindow) createChildWindow()
})
ipcMain.handle('get-app-info', () => {
return {
name: app.getName(),
version: app.getVersion(),
}
})
app.on('ready', () => {
createSplash()
setTimeout(() => createMainWindow(), 1500)
})
app.on('window-all-closed', () => {
if (process.platform !== 'darwin') app.quit()
})
preload.js(Preload-Skript)
const { contextBridge, ipcRenderer } = require('electron')
contextBridge.exposeInMainWorld('electronAPI', {
openChild: () => ipcRenderer.send('open-child'),
getAppInfo: () => ipcRenderer.invoke('get-app-info'),
})
index.html (Hauptfenster)
Beispiel
<html lang="zh">
<head>
<meta charset="UTF-8" />
<title>Hauptfenster</title>
<style>
body { font-family: sans-serif; text-align: center; margin-top: 100px; }
button { padding: 10px 20px; font-size: 16px; cursor: pointer; }
</style>
</head>
<body>
<h1>Willkommen bei Electron-Anwendungen</h1>
<p id="info"></p>
<button id="open">Unterfenster öffnen</button>
<script src="renderer.js"></script>
</body>
</html>
child.html (Kindfenster)
Beispiel
<html lang="zh">
<head>
<meta charset="UTF-8" />
<title>Kindfenster</title>
<style>
body { font-family: sans-serif; text-align: center; margin-top: 100px; }
</style>
</head>
<body>
<h2>Dies ist ein untergeordnetes Fenster</h2>
<p>Kann Befehle vom Hauptfenster empfangen</p>
</body>
</html>
splash.html (Splashscreen)
Beispiel
<html lang="zh">
<head>
<meta charset="UTF-8" />
<title>Wird geladen...</title>
<style>
body {
display: flex;
justify-content: center;
align-items: center;
height: 100vh;
background: linear-gradient(135deg, #8EC5FC, #E0C3FC);
font-family: sans-serif;
}
h1 {
font-size: 28px;
color: #333;
}
</style>
</head>
<body>
<h1>Die Anwendung wird gestartet, bitte warten...</h1>
</body>
</html>
renderer.js (Renderlogik)
Beispiel
const btn = document.getElementById('open')
// Anwendungsinformationen anzeigen
window.electronAPI.getAppInfo().then((appInfo) => {
info.textContent =`Anwendungsname:${appInfo.name}| Version: ${appInfo.version}`
})
// Untergeordnetes Fenster öffnen
btn.addEventListener('click', () => {
window.electronAPI.openChild()
})
Der Ablauf nach der Ausführung ist wie folgt:
- Beim Start anzeigenSplash-Screen(
splash.html)。 - Nach Abschluss des Ladevorgangs automatisch die Splash-Seite schließen undHauptfenster anzeigen。
- Das Hauptfenster kann über eine Schaltfläche geöffnet werdenuntergeordnetes Fenster, was die IPC-Kommunikationsfunktionalität demonstriert.
- Das Hauptfenster verwendetPreload, um APIs sicher bereitzustellen, wodurch der direkte Zugriff auf Node.js verhindert wird.
- Alle Fenster verwendenEreignisüberwachung、verzögerte Anzeigeund weitere Optimierungsstrategien, um weiße Bildschirme und Flackern zu vermeiden.