本教程详细介绍了如何在 electronjs 无边框窗口中实现自定义的关闭、最小化和最大化按钮。我们将利用 electron 的 `ipcmain` 和 `ipcrenderer` 模块进行进程间通信，实现渲染进程触发 ui 事件，主进程执行窗口操作的机制，并探讨使用 preload 脚本提升安全性和代码组织性。
在 Electron 应用中，无边框窗口（Frameless Window）因其高度可定制的外观和用户体验而广受欢迎。然而，移除原生窗口边框的同时，也意味着失去了操作系统提供的标准窗口控制按钮（关闭、最小化、最大化）。为了在无边框窗口中实现这些基本功能，我们需要创建自定义的 UI 按钮，并通过 Electron 的进程间通信（IPC）机制，将渲染进程（UI 界面）的用户操作传递给主进程（负责窗口管理），从而实现对窗口的控制。
核心机制：Electron IPC 通信
Electron 应用程序由一个主进程和多个渲染进程组成。主进程负责创建和管理 BrowserWindow 实例，并拥有完整的 Node.js API 访问权限，可以执行系统级操作。渲染进程则负责显示网页内容，通常不直接访问 Node.js API（出于安全考虑）。
为了让渲染进程能够请求主进程执行窗口操作，我们需要使用 Electron 的 IPC 模块：
- ipcMain：在主进程中使用，用于监听来自渲染进程的消息。
- ipcRenderer：在渲染进程中使用，用于向主进程发送消息。
通过这种方式，渲染进程可以发送一个“意图”（例如“关闭应用”），而主进程则根据这个意图执行实际的窗口操作。
主进程 (Main Process) 实现
在主进程（通常是 main.js 文件）中，我们需要：
- 创建一个 BrowserWindow 实例，并将其配置为无边框。
- 声明一个变量来持有 BrowserWindow 实例的引用，以便在 IPC 事件处理器中访问它。
- 使用 ipcMain.on() 方法监听渲染进程发送的自定义消息。
- 在收到消息时，调用 BrowserWindow 实例相应的窗口控制方法。
以下是 main.js 的示例代码：
// main.js
const { app, BrowserWindow, ipcMain } = require('electron');
const path = require('path');
let mainWindow; // 声明一个全局变量来持有窗口实例
function createWindow() {
mainWindow = new BrowserWindow({
width: 1000,
height: 700,
frame: false, // 关键：设置为无边框
webPreferences: {
preload: path.join(__dirname, 'preload.js'), // 引入 preload 脚本
nodeIntegration: false, // 禁用 Node.js 集成，提升安全性
contextIsolation: true // 启用上下文隔离，提升安全性
}
});
mainWindow.loadFile('index.html'); // 加载你的 HTML 文件
// 监听窗口关闭事件，确保窗口实例被垃圾回收
mainWindow.on('closed', () => {
mainWindow = null;
});
// IPC 事件监听
ipcMain.on('CLOSE_APP', () => {
mainWindow.close();
});
ipcMain.on('MINIMIZE_APP', () => {
mainWindow.minimize();
});
ipcMain.on('MAXIMIZE_TOGGLE_APP', () => {
if (mainWindow.isMaximized()) {
mainWindow.unmaximize(); // 如果已最大化，则恢复
} else {
mainWindow.maximize(); // 否则最大化
}
});
}
// 当 Electron 应用准备就绪时创建窗口
app.whenReady().then(createWindow);
// 所有窗口关闭时退出应用 (macOS 除外)
app.on('window-all-closed', () => {
if (process.platform !== 'darwin') {
app.quit();
}
});
// 在 macOS 上，当 dock 图标被点击时重新创建窗口
app.on('activate', () => {
if (BrowserWindow.getAllWindows().length === 0) {
createWindow();
}
});渲染进程 (Renderer Process) 实现
在渲染进程中，你需要创建实际的 UI 按钮，并为它们添加点击事件监听器。当按钮被点击时，使用 ipcRenderer.send() 方法向主进程发送相应的消息。
为了遵循安全最佳实践，我们不建议直接在渲染进程中启用 nodeIntegration 来访问 ipcRenderer。更推荐的做法是使用 Preload 脚本。
优化与最佳实践：使用 Preload 脚本
Preload 脚本在渲染进程加载任何内容之前运行，并且拥有 Node.js 环境的访问权限。通过 contextBridge 模块，我们可以安全地将主进程功能（或其代理）暴露给渲染进程的 window 对象，而无需暴露整个 Node.js API。
1. 创建 Preload 脚本 创建一个 preload.js 文件（路径与 main.js 中的 webPreferences.preload 配置一致）：
// preload.js
const { contextBridge, ipcRenderer } = require('electron');
// 通过 contextBridge 将 ipcRenderer 功能暴露给渲染进程
contextBridge.exposeInMainWorld('electronAPI', {
closeApp: () => ipcRenderer.send('CLOSE_APP'),
minimizeApp: () => ipcRenderer.send('MINIMIZE_APP'),
maximizeToggleApp: () => ipcRenderer.send('MAXIMIZE_TOGGLE_APP')
});2. 在 HTML 中创建自定义按钮 在你的 index.html 文件中，添加用于控制窗口的按钮：
Electron 无边框窗口
欢迎来到自定义窗口！
这里是你的应用内容。
3. 在渲染进程中调用暴露的 API 在 renderer.js 文件中，你可以通过 window.electronAPI 访问在 Preload 脚本中暴露的方法：
// renderer.js
document.addEventListener('DOMContentLoaded', () => {
const closeBtn = document.getElementById('close-btn');
const minimizeBtn = document.getElementById('minimize-btn');
const maximizeBtn = document.getElementById('maximize-btn');
if (closeBtn) {
closeBtn.addEventListener('click', () => {
window.electronAPI.closeApp(); // 调用 Preload 脚本暴露的 API
});
}
if (minimizeBtn) {
minimizeBtn.addEventListener('click', () => {
window.electronAPI.minimizeApp();
});
}
if (maximizeBtn) {
maximizeBtn.addEventListener('click', () => {
window.electronAPI.maximizeToggleApp();
});
}
});注意事项
- 安全性: 始终将 nodeIntegration 设置为 false 并启用 contextIsolation。通过 contextBridge 安全地暴露特定 API 是最佳实践，可以有效防止恶意代码注入。
- 窗口拖拽: 在无边框窗口中，你需要手动指定一个区域作为窗口的拖拽区域。通常，这通过 CSS 属性 -webkit-app-region: drag; 实现。同时，在按钮等交互元素上使用 -webkit-app-region: no-drag; 以确保它们可以被点击。
- 用户体验: 考虑最大化/恢复按钮的图标状态切换，以清晰指示当前窗口状态。
- 错误处理: 在主进程中，可以为 IPC 事件添加更健壮的错误处理和日志记录机制。
- 多窗口应用: 如果你的应用有多个窗口，确保 ipcMain 事件处理程序能够正确地引用或识别是哪个 BrowserWindow 实例发出的请求，并对其进行操作。
总结
通过 Electron 的 ipcMain 和 ipcRenderer 模块，结合 Preload 脚本，我们可以安全且高效地在无边框 Electron 窗口中实现自定义的关闭、最小化和最大化功能。这种模式不仅实现了渲染进程与主进程之间的职责分离，也遵循了 Electron 应用开发的安全最佳实践，为构建高度定制化的桌面应用奠定了基础。
