323 TerminalSearch · 终端搜索

用途

在终端的滚动缓冲与屏幕中查找文字，显示匹配数，上下跳转并把当前匹配滚动到可见处。

最小示例

var term code.TerminalState
term.Write("build ok\r\nerror: missing seal\r\n")
var search code.TerminalSearchState
view := func(c *ui.Context) {
	core.Use(c, core.Settings{})
	ui.Column(c).Gap(8).Children(func() {
		code.TerminalSearch(c, &term, &search, code.TerminalSearchOptions{})
		code.Terminal(c, &term, code.TerminalOptions{}).Height(160)
	})
}
ui.Render(view, 400, 300, 1)

参数

func TerminalSearch(c *ui.Context, term *TerminalState, s *TerminalSearchState, opts TerminalSearchOptions) ChoiceResult。匹配在查询或终端内容变化时重算一次，不逐帧计算；匹配结果写入 term，由同一 TerminalState 的 Terminal 绘制下划线，当前匹配加框。

字段	类型	默认值	含义
`TerminalSearchState.Query`	`string`	""	查找文字，不区分大小写。
`TerminalSearchState.Current`	`int`	0	当前匹配序号，从 0 开始。
`Disabled`	`bool`	false	不能输入与跳转。

状态

无查询、有匹配（“第 n 项，共 m 项”）、无匹配（“无匹配”）、禁用；终端中其余匹配为 AccentText 下划线，当前匹配加 AccentText 框。

事件

Changed()：查询变化或跳到另一匹配。

键盘操作

Enter / Shift+Enter：下一项 / 上一项；macOS 上 Cmd+G / Shift+Cmd+G，其他平台 F3 / Shift+F3。
上一项、下一项按钮可用 Tab 到达。

限制

只做纯文字匹配，不支持正则与整词；跨行文字不会匹配。