WIP components (as built)

docs/components/462-settings-search.md

@@ -0,0 +1,48 @@
+# 462 SettingsSearch
+
+设置搜索。
+
+## 用途
+
+按标签、说明与关键词搜索设置项，高亮匹配片段；选中后切到对应分区并把该设置行滚入视野、聚焦其控件。
+
+## 最小示例
+
+```go
+query, page := "", "general"
+entries := []mujica.SettingEntry{{ID: "sound", Page: "general", Label: "Sound", Keywords: []string{"audio"}}}
+view := func(c *ui.Context) {
+	mujica.Use(c, mujica.Settings{})
+	if e, ok := mujica.SettingsSearch(c, &query, entries, mujica.SettingsSearchOptions{}).Chosen(); ok {
+		page = e.Page
+	}
+	fmt.Println("page", page)
+}
+ui.Render(view, 400, 300, 1)
+```
+
+## 参数
+
+| 字段 | 类型 | 默认值 | 含义 |
+| --- | --- | --- | --- |
+| `query` | `*string` | 必填 | 搜索文字。 |
+| `entries` | `[]SettingEntry` | 必填 | ID（对应 SettingsRow ID）、Page、Label、Description、Keywords。 |
+| `Limit` | `int` | 8 | 最多显示条数。 |
+
+## 状态
+
+无输入、有结果（当前项底色）、无结果。
+
+## 事件
+
+`SettingsSearchResult.Chosen()` 返回选中的条目；调用方据此设置分区。
+
+## 键盘操作
+
+在搜索框中 ↑/↓ 移动当前项，Enter 跳转；也可点击结果。
+
+## 限制
+
+大集合使用虚拟列表，构建当前可见行；搜索与分组在数据或查询变化时更新。
+
+- 匹配不区分大小写，按子串查找。