53 lines
2.1 KiB
Markdown
53 lines
2.1 KiB
Markdown
# 322 TerminalTabs · 终端标签
|
||
|
||
## 用途
|
||
|
||
管理多个终端的标签：切换、重命名、关闭；仍有进程运行（`Busy`）的终端关闭前弹出确认。
|
||
|
||
## 最小示例
|
||
|
||
```go
|
||
tabs := []mujica.TerminalTab{{ID: "a", Title: "zsh"}, {ID: "b", Title: "build", Busy: true}}
|
||
active := "a"
|
||
view := func(c *ui.Context) {
|
||
mujica.Use(c, mujica.Settings{})
|
||
r := mujica.TerminalTabs(c, &tabs, &active, mujica.TerminalTabsOptions{}, func(id string) {
|
||
ui.Text(c, "terminal "+id)
|
||
})
|
||
if r.Closed != "" {
|
||
fmt.Println("close pty", r.Closed)
|
||
}
|
||
}
|
||
ui.Render(view, 400, 300, 1)
|
||
```
|
||
|
||
## 参数
|
||
|
||
`func TerminalTabs(c *ui.Context, tabs *[]TerminalTab, active *string, opts TerminalTabsOptions, content func(id string)) TerminalTabsResult`。`*tabs` 与 `*active` 由调用方持有，组件直接修改：重命名改 `Title`，关闭删除元素并把 `active` 移到相邻标签。`active` 不是任何标签 ID 时 panic。
|
||
|
||
| 字段 | 类型 | 默认值 | 含义 |
|
||
| --- | --- | --- | --- |
|
||
| `TerminalTab.ID` | `string` | 必填 | 稳定标识，也是事件值。 |
|
||
| `TerminalTab.Title` | `string` | 必填 | 标签文字。 |
|
||
| `TerminalTab.Busy` | `bool` | false | 进程仍在运行：显示小圆点并在关闭前确认。 |
|
||
| `Disabled` | `bool` | false | 不响应切换、重命名与关闭。 |
|
||
| `content` | `func(id string)` | 必填 | 构建当前标签的内容。 |
|
||
|
||
## 状态
|
||
|
||
当前标签（Selection 背景、粗体与底部 AccentText 线）、悬停、键盘焦点环、正在运行（圆点与无障碍描述“进程运行中”）、重命名输入框、关闭确认对话框、无标签时的空状态、禁用。
|
||
|
||
## 事件
|
||
|
||
`Changed`：当前标签变化；`Renamed`：被重命名的标签 ID；`Closed`：被关闭的标签 ID（调用方应关闭对应 PTY）。
|
||
|
||
## 键盘操作
|
||
|
||
- ←/→、Home/End：在标签间移动并切换。
|
||
- F2 或双击：重命名；Enter 确认，Escape 取消。
|
||
- Delete：关闭焦点所在标签；运行中的标签先确认，确认框默认聚焦“取消”。
|
||
|
||
## 限制
|
||
|
||
- 不提供新建按钮与拖动排序；新建由调用方向 `*tabs` 追加。
|