用途:为搜索与筛选界面提供一套可落地的设计契约,适用于命令面板、分面目录、表格筛选栏、日志搜索、输入联想等场景。
主要能力:区分即时搜索与提交式搜索(按查询成本选择,网络查询防抖 300ms 并用序号或 AbortController 防止竞态);保证输入框始终保留焦点与光标;每个已应用筛选都以可移除的标签展示并提供“全部清除”;分面负责选择、标签负责确认;计数为零的分面选项禁用而非隐藏;同一分面内取 OR、跨分面取 AND;查询、分面与排序写入 URL 作为状态来源;区分空闲、零结果、失败三种空状态;零结果页回显查询、暴露筛选并提供最接近的非空替代;高亮匹配子串而不显示相关度分数;排序与相关度互斥并标注当前顺序;固定键盘契约(/ 或 ⌘K 聚焦、方向键高亮、Enter 打开、Escape 依次清除高亮/查询/关闭)。
使用方式:优先复用项目已有的查询与组合框组件,确认 URL 状态管理方式、服务端状态获取与取消方式以及已安装的组合框原语,避免手写与已有组件并存导致两套键盘契约。构建前先输出搜索契约(语料、模式、防抖、请求取消、URL 键、筛选、空闲/零结果/错误处理、键盘映射)并达成一致。
限制:资料未提供具体实现代码、依赖版本、平台或收费信息;与 dense-ui、ui-states、navigation、a11y、forms、motion、ui-copy、onboarding 等技能存在职责边界,需按资料所述分工协作。