MujicaUI/docs/components/330-search-panel.md

330 SearchPanel · 多文件搜索

用途

展示多文件搜索结果：按文件分组、可折叠，匹配预览带高亮；提供包含与排除模式输入。

最小示例

results := []mujica.SearchFileResult{{Path: "court/seal.go", Matches: []mujica.SearchMatch{{Line: 12, Text: "func Seal() {", Start: 5, End: 9}}}}
state := mujica.SearchPanelState{Query: "seal"}
view := func(c *ui.Context) {
	mujica.Use(c, mujica.Settings{})
	r := mujica.SearchPanel(c, results, &state, mujica.SearchPanelOptions{})
	r.Element.Height(280)
	if r.Opened != nil {
		fmt.Println("open", r.Opened.Path, r.Opened.Line)
	}
}
ui.Render(view, 400, 300, 1)

参数

func SearchPanel(c *ui.Context, results []SearchFileResult, s *SearchPanelState, opts SearchPanelOptions) SearchPanelResult。搜索由调用方执行：查询或模式变化时 Changed 为 true，完成后传入新的 results。行列表虚拟化。

字段	类型	默认值	含义
SearchFileResult.Path	string	必填	文件路径，也是折叠键。
SearchMatch.Line, Text	int, string	—	行号与行文字。
SearchMatch.Start, End	int	—	匹配在 Text 中的字节范围；越界 panic。
SearchPanelState.Query, Include, Exclude	string	""	查询与包含、排除模式（格式由调用方解释）。
Status, Error	DataStatus, string	DataReady	搜索中或失败。
Disabled	bool	false	不能输入、折叠与打开。

状态

结果摘要、文件标题（折叠箭头与匹配数）、匹配行（Selection 背景与粗体下划线标出匹配）、选中行（Selection 与菱形）、搜索中、失败（可重试）、未输入、无结果、禁用。

事件

Changed：查询或模式变化，或点击重试；Opened：用户打开的匹配（路径与行号）。

键盘操作

• Tab 依次到达查询、包含、排除与结果列表。
• ↑/↓ 选择；Enter 或双击：打开匹配，或折叠/展开文件；文件行上 ← 折叠、→ 展开。

限制

• 长行只显示匹配前 40 个字节。