Terminal & Code: components 321-340

docs/components/322-terminal-tabs.md

@@ -0,0 +1,52 @@
+# 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` 追加。