Terminal & Code: components 321-340

docs/components/326-process-list.md

@@ -0,0 +1,50 @@
+# 326 ProcessList · 进程列表
+
+## 用途
+
+以表格列出进程，可按名称、PID、CPU、内存排序；结束进程前必须确认，确认后通过结果交给调用方执行。
+
+## 最小示例
+
+```go
+procs := []mujica.Process{{PID: 7, Name: "archivist", CPU: 42, Memory: 50 << 20}, {PID: 9, Name: "herald", CPU: 3, Memory: 8 << 20}}
+var state mujica.ProcessListState
+view := func(c *ui.Context) {
+	mujica.Use(c, mujica.Settings{})
+	r := mujica.ProcessList(c, procs, &state, mujica.ProcessListOptions{})
+	r.Element.Height(240)
+	if r.End != nil {
+		fmt.Println("kill", r.End.PID)
+	}
+}
+ui.Render(view, 400, 300, 1)
+```
+
+## 参数
+
+`func ProcessList(c *ui.Context, procs []Process, s *ProcessListState, opts ProcessListOptions) ProcessListResult`。排序只在切片或排序方式变化时进行；刷新数据请传入新切片。
+
+| 字段 | 类型 | 默认值 | 含义 |
+| --- | --- | --- | --- |
+| `Process.PID`, `Name` | `int`, `string` | — | 进程号与名称；PID 是行的稳定键。 |
+| `Process.CPU` | `float64` | 0 | 占用百分比。 |
+| `Process.Memory` | `uint64` | 0 | 常驻内存字节数，显示为 KB/MB/GB。 |
+| `ProcessListState.Sort` | `ui.SortOrder` | CPU 降序 | 列为 `name`、`pid`、`cpu`、`memory`，其他值 panic。 |
+| `Disabled` | `bool` | false | 不能排序与结束进程。 |
+
+## 状态
+
+选中行（Selection 背景与菱形）、排序列箭头、确认对话框（默认聚焦“取消”）、无进程、禁用。
+
+## 事件
+
+`End`：用户确认要结束的进程，没有则为 nil。
+
+## 键盘操作
+
+- Tab 到达表格；↑/↓、Home/End 选择；Delete 结束所选进程（先确认）。
+- 点击列头排序，再点反向；每行结束按钮可用 Tab 到达。
+
+## 限制
+
+- 组件不发送信号，只回报确认结果。