WIP essentials 16

2026-10-05 14:39:12 -04:00
1 parent c851668eb8
commit 719a059113
@@ -0,0 +1,45 @@
+# 489 ChoiceChips 筛选芯片
+
+## 用途
+
+单选或多选的筛选芯片，自动换行。选中芯片用选中底色、强调边框和对勾表示。
+
+## 最小示例
+
+```go
+var status []string
+view := func(c *ui.Context) {
+	mujica.Use(c, mujica.Settings{})
+	mujica.ChoiceChips(c, &status, []mujica.ToggleItem[string]{
+		{Value: "open", Label: "Open"}, {Value: "closed", Label: "Closed"},
+	}, mujica.ChoiceChipsOptions{Multiple: true, Label: "Status"})
+}
+```
+
+签名：`func ChoiceChips[T comparable](c *ui.Context, value *[]T, items []ToggleItem[T], opts ChoiceChipsOptions) ChoiceResult`
+
+## 参数
+
+| 字段 | 类型 | 默认值 | 含义 |
+| --- | --- | --- | --- |
+| `value` | `*[]T` | 必填 | 选中的值；单选时多于一个 panic。 |
+| `items` | `[]ToggleItem[T]` | 必填 | 芯片（Value、Label、Icon、Name、Disabled）。 |
+| `Multiple` | `bool` | `false` | 允许多选；单选时可再次点击取消。 |
+| `Disabled` | `bool` | `false` | 整组禁用。 |
+| `Label` | `string` | `""` | 组名称。 |
+
+## 状态
+
+默认、悬停、按下、焦点、选中、禁用；颜色过渡 120 ms。
+
+## 事件
+
+`Changed()`：选择变化。
+
+## 键盘操作
+
+整组是一个 Tab 停靠点；左右方向键移动并跳过禁用芯片；Space/Enter 切换。
+
+## 限制
+
+无。