69 lines
3.3 KiB
Markdown
69 lines
3.3 KiB
Markdown
# Popup
|
||
|
||
**控件功能**：弹出层控件，用于在页面上显示模态或非模态的浮动窗口，支持自动打开/关闭、点击外部关闭、拖拽移动、调整大小、定时关闭等功能。
|
||
**类型**：容器控件
|
||
**父类控件**：`bricks.VBox`
|
||
|
||
## 初始化参数
|
||
|
||
| 参数名 | 类型 | 默认值 | 说明 |
|
||
|--------|------|--------|------|
|
||
| `timeout` | number | `0` | 自动关闭延迟时间（毫秒），0 表示不自动关闭 |
|
||
| `archor` | string | `'cc'` | 弹窗定位锚点，取值为 `tl`, `tc`, `tr`, `cl`, `cc`, `cr`, `bl`, `bc`, `br` 中的一种，表示相对于屏幕的位置 |
|
||
| `widget` | string / Widget / null | `null` | 关联的目标控件（ID 或对象），用于定位或禁用 |
|
||
| `auto_open` | boolean | `true` | 是否在创建后自动打开弹窗 |
|
||
| `auto_dismiss` | boolean | `true` | 是否点击弹窗外区域时自动关闭 |
|
||
| `auto_destroy` | boolean | `true` | 关闭后是否自动销毁控件 |
|
||
| `movable` | boolean | `true` | 是否允许拖拽移动 |
|
||
| `resizable` | boolean | `false` | 是否允许调整大小 |
|
||
| `modal` | boolean | `true` | 是否为模态窗口（遮罩并禁用目标控件） |
|
||
| `content` | object | `undefined` | 弹窗内容配置对象，将在打开时异步加载 |
|
||
| `dismiss_events` | array | `undefined` | 指定事件名称数组，触发时自动关闭弹窗 |
|
||
|
||
> 注：移动端下默认宽高为 `100%`，桌面端为 `70%`。
|
||
|
||
## 主要事件
|
||
|
||
| 事件名 | 触发时机 | 说明 |
|
||
|--------|----------|------|
|
||
| `opened` | 弹窗显示并完成布局后触发 | 通常用于加载动态内容 |
|
||
| `dismissed` | 弹窗隐藏时触发 | 可用于清理资源 |
|
||
| `destroy` | 控件被销毁时触发 | 仅当 `auto_destroy` 为 true 时触发 |
|
||
|
||
---
|
||
|
||
# PopupWindow
|
||
|
||
**控件功能**：可拖动、可缩放、带标题栏的应用级窗口控件，常用于模拟桌面应用程序窗口，支持最小化、全屏、关闭等操作。
|
||
**类型**：容器控件
|
||
**父类控件**：`bricks.Popup`
|
||
|
||
## 初始化参数
|
||
|
||
| 参数名 | 类型 | 默认值 | 说明 |
|
||
|--------|------|--------|------|
|
||
| `title` | string | `"[Untitle window]"` | 窗口标题文本 |
|
||
| `icon` | string | 内置图标路径 | 窗口左上角显示的图标 URL |
|
||
| `rate` | number | `1.5` | 图标缩放比率 |
|
||
| `auto_open` | boolean | `true` | 创建后是否自动打开窗口 |
|
||
| 其他参数 | —— | 继承自 `Popup` | 包括 `width`, `height`, `modal`, `movable`, `resizable` 等，均继承并默认启用可移动和可调整大小 |
|
||
|
||
> 注意：`PopupWindow` 强制设置 `movable=true`, `resizable=true`，且默认 `auto_dismiss=false`, `auto_destroy=false`。
|
||
|
||
## 主要事件
|
||
|
||
| 事件名 | 触发时机 | 说明 |
|
||
|--------|----------|------|
|
||
| `opened` | 窗口打开并渲染完成后触发 | 继承自 `Popup` |
|
||
| `dismissed` | 窗口关闭（最小化也视为 dismiss）时触发 | 可用于状态同步 |
|
||
| `destroy` | 调用 `destroy()` 方法或点击关闭按钮时触发 | 实际销毁前执行清理逻辑 |
|
||
|
||
### 内置工具栏事件绑定
|
||
|
||
- `delete`：点击关闭按钮时触发，调用 `destroy()` 销毁窗口。
|
||
- `minimize`：点击最小化按钮时触发，调用 `win_minimize()` 隐藏窗口并加入 `app.mwins` 列表。
|
||
- `fullscreen`：点击全屏按钮时触发，进入全屏模式。
|
||
|
||
> 最小化的窗口可通过 `WindowsPanel` 重新打开。
|
||
|