aurora-admin
f1fbfc2ddb
Regression / regression (push) Canceled after 0s
## 品牌标识（本次会话） 起因：品牌此前没有任何图形标识 —— 唯一 favicon 是内联 data-URI 里的字母「A」， 那是 v2.0.0「Aurora Admin → Kole UI」改名漏掉的一处（PC 顶栏也是「A」， 移动端站已是「K」；移动端文档站则完全没有 favicon）。 - 几何：24 网格三个互不接触的笔画（竖 + 两斜），圆头描边； 描边 2.25 → 16px 标签页尺寸下正好 1.5px = 规范原文「描边1.5px」 - 取色分两套（刻意）：favicon 硬编码品牌蓝/白（渲染在浏览器标签栏，不继承 kole-dark）； 顶栏标记走 currentColor（实测暗色下自动转 rgb(20,22,28)） - 新增 theme-color 双条（light #FFFFFF / dark #1C1F26，取 --kole-color-card-bg） - 修 site/app.js hero 标语 KOLE ADMIN → KOLE UI（改名变形残留） - 移动端 7 个模板补 favicon（此前计数 0） 验收：门禁 9 条全 OK（site-routing/site-routes/mobile-docs/mobile-site/isolation/ theme/nav/i18n/icons）；PC 回归 1464/1464 · 移动端 807/807，各连跑 8 次一致； 两端 favicon 405 字节逐字节一致；PC 站控制台错误 1→0。 ## 并行会话成果（本次一并入库） - 图标系统：2576 图标（TDesign/Element Plus，MIT）+ 11 端注入 + 5 个构建门禁工具 + IconPreview 预览页 + ICON-SPEC.md 冻结规格 - 移动端平台：47 组件 × 6 端 + 文档站 53 页 + 隔离门禁 - PC 组件：103 个大后台组件 / 组件11 批次 - uni-app：PC 端试点 + 移动端端实现 + 真实编译验证 ## 工程 - .gitignore 补 .scratch/ 与 .zcode-preexisting-*.txt（会话中间产物，实测 9.1MB，不入库） - CHANGELOG 补品牌标识条目 - ROADMAP 登 S8-P4（品牌标识任务包 + og:image/apple-touch-icon 未做部分）
2.1 KiB
2.1 KiB
28 · 搜索框 Search
28.1 用途
用关键词从长列表里取回一小段结果；移动端的搜索框几乎总是页面顶部的独立一行，输入即过滤（不等回车），并且要给出一个明确的退出动作 —— 取消，因为触屏没有 Esc 键，用户清空关键词后仍需一键回到列表。
28.2 结构（anatomy）
search：根元素，一行里放进「搜索框 + 取消动作」icon：框内左侧放大镜，纯装饰（不承载语义，读屏由 label 承担）control：原生input type="search"，占满剩余宽度clear：可选清除按钮，有值且清除可用时出现在图标与取消之间cancel：可选取消动作，默认文案「取消」，由 showCancel 控制显隐
28.3 变体维度
round：true（胶囊形，页面顶部常用）/false（方角，嵌在卡片或工具栏里）showCancel：false（只有输入框）/true（右侧出现取消动作）
28.4 状态
- default：常态
- filled：有值（清除按钮出现）
- disabled：置灰且不可聚焦
28.5 交互与触控
- 搜索框高度不小于 44px，取消动作热区不小于 44px
- 输入即触发 input 事件（不等回车）；键盘「搜索」键触发 search 事件
- 清除按钮只在有值时出现，点击清空并把焦点留在输入框
- 清除与取消都是 44px 热区；两者同时出现时先清除、再取消（自右向左层级递进）
28.6 无障碍
- 输入框用原生
input type="search"（iOS 键盘右下角键位变成「搜索」） - 搜索图标是装饰性的，置
aria-hidden="true"，名称由aria-label给出 - 清除按钮是原生
button且带aria-label="清除"；取消动作是原生button - 取消按钮不用图标代替文字（触屏上文字比图标更好点）
28.7 doNotInvent
- 搜索的防抖时值与接口节流策略（由宿主决定）
- 搜索历史的存储与展示
- 搜索结果的高亮规则
28.8 unknowns
- 取消文案是否允许替换（如「返回」）
- 是否需要自动聚焦并拉起键盘
- 语音/扫码等扩展入口是否放进框内