搜索框
Search Box
UI 组件也叫:搜索栏、搜索输入框、查询框、Search Bar、SearchInput
一句话:带放大镜图标的输入框,输入关键词后按回车或点搜索按钮,在页面、列表或全站中查找内容。
详细解释
搜索框是专门用来「找东西」的 输入框:左侧或右侧有放大镜图标,框里提示可以搜什么,比如「搜索订单号、客户名」,输入后按回车或点搜索按钮触发,有内容时右侧出现清空的 ×。常见位置有两种:顶部导航栏里的全站搜索,以及列表、表格上方只搜当前数据的搜索框。
它和普通输入框的区别在用途:普通输入框填的内容会被提交保存,搜索框的内容只是查询条件。搜索框可以边输边搜,这时要加 防抖,避免每敲一个字就请求一次;也可以展开搜索建议和历史记录,这就是 自动补全。搜索结果为空时要给出明确提示,而不是一片空白。
示例
灰度线框示意,只表达结构,不代表具体视觉风格。
怎么跟 AI 说
可以直接贴给 Cursor、Claude Code 等工具,把里面的业务内容换成你自己的。
在订单列表上方左侧放一个宽 280px 的搜索框,左边放大镜图标,占位提示「搜索订单号或客户名」。输入后停顿 300ms 自动搜索,按回车立即搜索;有内容时右侧显示清空按钮,点击后恢复完整列表;没有结果时显示「没有找到相关订单」。
结构与适用场景
结构描述
由放大镜图标、关键词输入区和清空按钮组成,有时右侧带独立的搜索按钮,下方可以展开搜索建议列表。
适用场景
- 数据较多的列表或表格,需要按关键词快速找到某几条记录
- 网站或应用顶部的全站搜索,用来查找文章、商品、文档
- 可选内容成百上千、需要先输入关键词再挑选的场景
不适用场景
- 用户填写后要提交保存的内容,比如姓名、地址,应该用普通输入框
- 列表只有十几条、一屏就能看完时,没必要放搜索框
- 需要按状态、日期、类别等多个条件组合筛选时,应该用筛选栏,搜索框只作为其中一项
常见坏用法
- 每输入一个字就立即发请求,没有防抖,接口压力大且结果来回闪烁
- 不说明能搜哪些字段,用户输了客户名,系统却只支持搜订单号
- 搜索没有结果时显示一片空白,用户以为页面坏了
识别特征
- 带放大镜图标的输入框,常为圆角或胶囊形
- 占位提示以「搜索」开头
- 位于顶部导航栏中间,或列表、表格的左上方
DOM 线索
插件本地识别时匹配的 CSS 选择器(标签、ARIA role、常见组件库 class)。
input[type="search"][role="search"][role="searchbox"].ant-input-search.arco-input-searchinput[placeholder*="搜索"]input[placeholder*="search" i]