【亲测免费】 自定义Electron标题栏：全面指南

---

自定义Electron标题栏 是一个为Electron应用设计的TypeScript库，它让你能够配置一个完全可定制的应用程序标题栏。这个强大的工具使开发者能够创建与应用程序品牌紧密结合且用户体验一致的界面。

安装指南

要将此库添加到你的Electron项目中，你可以通过以下命令之一进行安装：

• 使用npm:

  npm install custom-electron-titlebar
  

• 使用pnpm:

  pnpm add custom-electron-titlebar
  

• 或者使用yarn:

  yarn add custom-electron-titlebar
  

项目使用说明

在主进程中的设置

在你的主应用文件（通常是main.js或main.ts）中，首先导入必要的模块：

import { setupTitlebar, attachTitlebarToWindow } from "custom-electron-titlebar/main";

setupTitlebar(); // 设置标题栏主进程

function createWindow() {
  const mainWindow = new BrowserWindow({
    width: 800,
    height: 600,
    // 若Electron版本低于14，则需要 frame: false
    titleBarStyle: 'hidden', // 隐藏原生标题栏
    titleBarOverlay: true, // 可以选择启用Windows原生控件样式
    webPreferences: {
      sandbox: false,
      preload: path.join(__dirname, 'preload.js')
    },
  });

  // 添加标题栏事件监听等操作
  attachTitlebarToWindow(mainWindow);
}

预加载脚本中的实现

接着，在预加载脚本（如preload.js）中实例化标题栏：

import { Titlebar } from "custom-electron-titlebar";

window.addEventListener('DOMContentLoaded', () => {
  new Titlebar(); // 标题栏的具体实现逻辑应在此处扩展
});

高级使用与选项

对于标题栏的颜色、图标、菜单位置等高级定制选项，请参考项目的wiki页面，那里提供了详细的API说明和示例代码。

API使用文档

完整的API文档和详细用法请直接访问项目wiki，它涵盖了从初始化标题栏到利用各种方法调整外观和行为的各个方面，确保你能充分利用自定义标题栏的所有功能。

结论

自定义Electron标题栏是提升Electron应用程序用户体验的有力工具。遵循上述步骤，即可轻松集成并定制你的应用标题栏，打造出独一无二的用户界面。记得支持开源社区的努力，如果你发现此项目对你有所帮助，不妨考虑赞助作者。一起构建更美观、体验更佳的应用程序！

---

请注意，维护状态及可能的未来更新需求应参照项目仓库的最新信息，因为该项目已被归档，后续维护可能受限。