MujicaUI/docs/components/322-terminal-tabs.md

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 追加。