MujicaUI/docs/components/462-settings-search.md

462 SettingsSearch

设置搜索。

用途

按标签、说明与关键词搜索设置项，高亮匹配片段；选中后切到对应分区并把该设置行滚入视野、聚焦其控件。

最小示例

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 跳转；也可点击结果。

限制

大集合使用虚拟列表，构建当前可见行；搜索与分组在数据或查询变化时更新。

• 匹配不区分大小写，按子串查找。