# @akiflow/electron-panel-window 中文文档

规范地址：https://npmcn.com/package/%40akiflow/electron-panel-window/

版本：10\.3\.0
npm 元数据更新时间：2026-11-02T15:15:14.485Z
中文译文更新时间：2026-11-08T10:34:14.953Z
软件包许可：ISC

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40akiflow/electron-panel-window
原文对照：https://npmcn.com/package/%40akiflow/electron-panel-window/?lang=original
项目主页：https://github.com/akiflow/electron-panel-window#readme
源码仓库：https://github.com/akiflow/electron-panel-window

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：33.9 kB，15 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=22 \<25
- 运行依赖：1 个
- 首次发布：2021-03-08T17:45:56.037Z
- 最新版本发布：2026-11-02T15:15:14.264Z
- 近 30 天下载量：1799（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：20（近 12 个月 5 个）

## 中文简介

创建 Electron 浏览器 Window , 其动作类似面板

## 安装

```sh
npm install @akiflow/electron-panel-window
```

也可以使用：`pnpm add @akiflow/electron-panel-window`、`yarn add @akiflow/electron-panel-window`、`bun add @akiflow/electron-panel-window`

## README

# 电子平面窗

这个叉子 [电子平面窗](https://github.com/goabstract/electron-panel-window)。 。 。 . 有用吗 **macOS 文图拉** (测试). 和我们一起工作 **电能 45.2.1**... (测试).

**警告很少.**

### 1\. 联合国. `titleBarStyle` 应该有值 `'customButtonsOnHover'`

这将显示左上方的两个按钮( 关闭并最大化窗口) 。 您可以通过设置来隐藏它们 :

-   `closable: false`
-   `maximizable: false`

注意, 如果您真的需要关闭窗口, 您可能需要一些额外的逻辑, 如 `win.close()` 现在不行了 (你可以检查测试 看看我们是如何做到的)

这在第三版看来已经没有必要了.

### 2\. 联合国. `setVisibleOnAllWorkspaces(true)` 无法在这些窗口中使用

显然它导致一切崩溃.

### 3\. 退出时的崩溃

使用面板窗口退出应用程序时通常会出现电子崩溃. 通常可以通过:

1.  隐藏面板窗口
2.  将另一个窗口作为密钥( 使用) `makeKeyWindow` 在另一个窗口上)
3.  在普通窗口中转换面板( 使用) `makeWindow`(中文(简体) )
4.  关闭窗口
5.  退出应用程序

我们注意到,如果2 -5步骤在设定后执行,则坠机次数减少/没有:

```javascript
win.hide()
setTimeout(()=>{
    electronPanelWindow.makeKeyWindow(otherWin)
    electronPanelWindow.makeWindow(win)
    win.close()
    app.quit()
})
```

`destroy()` 在一个仍然面板化的窗口上不被视为安全. `close()` 在你第一次打电话之前 也不被认为是安全的 `makeWindow(win)`。 。 。 .

## 其它

删除了胜负和 Linux 支持, 因为它最初是空的 .

您可能想要动态地包含软件包 :

```
const electronPanelWindow = process.platform === 'darwin' ? require('electron-panel-window') : undefined
```

### 问题

随意打开一个问题, 并报告其他的"工作周旋" 保持这个工作.

# 方法

安装

```bash
npm install @akiflow/electron-panel-window
```

需求

```bash
const electronPanelWindow = process.platform === 'darwin' ? require('@akiflow/electron-panel-window') : undefined
```

1.  `makeKeyWindow(win)` 不激活应用程序而聚焦窗口
2.  `makePanel(win)` 在面板中转换给定窗口
3.  `makeWindow(win)` 在窗口中转换给定的面板( 以前需要) `close()` 或者说 `destroy()` 在macOS上)

# 贷项

-   [Akiflow 团队](https://akiflow.com/)
-   [克克莱里戈语name](https://github.com/rcclerigo)
-   [摘要](https://www.abstract.com/)

* * *

### 电子平面窗的旧 README

有些东西可能有用,有些东西可能过时了

你可以在这里找到它: [https://github.com/goabstract/electron-panel-window/ 互联网档案馆的存檔,存档日期2013-12-22](https://github.com/goabstract/electron-panel-window/)

## 常见问题

### @akiflow/electron-panel-window 是什么？

创建 Electron 浏览器 Window , 其动作类似面板

### 如何安装 @akiflow/electron-panel-window？

在项目目录运行 npm install @akiflow/electron-panel-window，或使用 pnpm add / yarn add / bun add。

### @akiflow/electron-panel-window 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/akiflow\_\_electron-panel-window 是否存在。

### @akiflow/electron-panel-window 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @akiflow/electron-panel-window 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22 \<25。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @akiflow/electron-panel-window 可以商用吗？

@akiflow/electron-panel-window 使用 ISC 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @akiflow/electron-panel-window 的下载量有多少？

根据 npm 官方下载统计，@akiflow/electron-panel-window 在 2026/10/06 – 2026/11/04 这 30 天内被下载 1,799 次，日均约 60 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @akiflow/electron-panel-window 还在维护吗？

最新版本 10\.3\.0 发布于 2026/11/02（5 天前）；至今共发布 20 个版本，其中过去 12 个月发布了 5 个；首次发布于 2021/03/09。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。