MujicaUI/docs/components/243-conversation-search.md

243 ConversationSearch · 会话搜索

用途

按标题与内容搜索会话。查询交给调用方异步执行，结果回传后高亮匹配文字。

最小示例

query := "seat"
hits := []chat.ConversationSearchHit{{ID: "1", Title: "Ballroom seating plan"}}
view := func(c *ui.Context) {
	core.Use(c, core.Settings{})
	v := chat.ConversationSearch(c, &query, hits, chat.ConversationSearchOptions{})
	if v.QueryChanged {
		log.Println("search", query)
	}
}
ui.Render(view, 400, 300, 1)

参数

func ConversationSearch(c *ui.Context, query *string, hits []ConversationSearchHit, opts ConversationSearchOptions) ConversationSearchView。

ConversationSearchHit：ID、Title、Snippet（匹配的消息片段）。

字段	类型	默认值	含义
Loading	bool	false	调用方正在搜索。
Error	string	""	搜索失败的说明，附重试按钮。
Placeholder	string	内置“搜索”	输入框占位。
Label	string	""	无障碍名称。
Disabled	bool	false	禁用输入与选择。

状态

空查询、搜索中（旋转标记）、有结果（匹配处加粗、下划线、Selection 底）、无结果、失败（错误文字 + 重试）、禁用。

事件

QueryChanged：查询变化，调用方据此发起搜索，结果到达后传入新的 hits 并调用 c.Invalidate()。Chosen：点击或 Enter 打开的会话 ID。Retry：点击重试。

键盘操作

• 输入框中 ↓：进入结果列表。
• 列表中 ↑/↓ 移动，Enter 打开。
• Escape：清空查询（SearchInput 行为）。

限制

• 匹配高亮为不区分大小写的逐字符匹配，不做分词、拼音或模糊匹配；排序完全由调用方决定。
• 结果行固定高度（标题一行、片段一行），片段超长时截断。