54 lines
1.9 KiB
Markdown
54 lines
1.9 KiB
Markdown
# 243 ConversationSearch · 会话搜索
|
||
|
||
## 用途
|
||
|
||
按标题与内容搜索会话。查询交给调用方异步执行，结果回传后高亮匹配文字。
|
||
|
||
## 最小示例
|
||
|
||
```go
|
||
query := "seat"
|
||
hits := []mujica.ConversationSearchHit{{ID: "1", Title: "Ballroom seating plan"}}
|
||
view := func(c *ui.Context) {
|
||
mujica.Use(c, mujica.Settings{})
|
||
v := mujica.ConversationSearch(c, &query, hits, mujica.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 行为）。
|
||
|
||
## 限制
|
||
|
||
- 匹配高亮为不区分大小写的逐字符匹配，不做分词、拼音或模糊匹配；排序完全由调用方决定。
|
||
- 结果行固定高度（标题一行、片段一行），片段超长时截断。
|