037 MultiSelect · 多选选择器

用途

从列表中选择多个值，弹层内可搜索、全选当前匹配项，可限制数量；已选值以标签显示，超出部分折叠为“+N”。

最小示例

tags := []int{1}
options := []input.SelectOption[int]{
	{Value: 1, Label: "Rose"},
	{Value: 2, Label: "Lily"},
	{Value: 3, Label: "Iris"},
}
view := func(c *ui.Context) {
	core.Use(c, core.Settings{})
	input.MultiSelect(c, &tags, options, input.MultiSelectOptions{Max: 2, Label: "Flowers"})
}
ui.Render(view, 400, 300, 1)

参数

func MultiSelect[T comparable](c *ui.Context, values *[]T, options []SelectOption[T], opts MultiSelectOptions) ChoiceResult。*values 按选择顺序保存；组件每次修改都会生成新切片。Max 或 MaxTags 为负数时 panic。

字段	类型	默认值	含义
`Placeholder`	`string`	内置“请选择…”	无选择时的提示。
`Max`	`int`	0	最多选择数，0 不限；达到上限后其余项禁用，并显示“已选 n / Max”。
`MaxTags`	`int`	0 → 3	字段中显示的标签数，其余折叠为“+N”。
`Disabled`	`bool`	false	禁用（标签不可移除）。
`Label`	`string`	""	无障碍名称。

状态

字段：占位、标签、折叠、展开、悬停、聚焦、禁用。弹层：搜索框、全选（全选/半选/未选）、选中项（酒红方框 + 白勾）、禁用项、达到上限、无结果。

事件

Changed() 在勾选、取消、全选或移除标签的那一帧返回 true。

键盘操作

Enter / Space / ↓：打开弹层，焦点在搜索框。
搜索框中 ↓：进入列表（“全选”）；列表内 ↑/↓、Home、End 移动；Space 勾选。
Escape：关闭，焦点回到字段。
字段上 Backspace：移除最后一个值。

限制

选项行基于 ui.CheckboxBase 自绘方框，选中状态由 MyGo 报告。全选的“半选”无法作为 mixed 状态报告：MyGo 没有为自定义元素设置它的公开接口（ui/element.go:282 的 checked 字段仅由内部设置）。组件改用 Description 读出“部分选中”，屏幕阅读器仍把复选框本身读作未选中。
标签上的移除按钮不占 Tab 位，键盘用 Backspace 移除。
列表未虚拟化，适合数百项以内。