322 TerminalTabs · 终端标签
用途
管理多个终端的标签:切换、重命名、关闭;仍有进程运行(Busy)的终端关闭前弹出确认。
最小示例
tabs := []code.TerminalTab{{ID: "a", Title: "zsh"}, {ID: "b", Title: "build", Busy: true}}
active := "a"
view := func(c *ui.Context) {
core.Use(c, core.Settings{})
r := code.TerminalTabs(c, &tabs, &active, code.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追加。

