Files
aurora-admin f1fbfc2ddb
Regression / regression (push) Canceled after 0s
feat(品牌标识): 几何 K 图标(favicon/顶栏标记/theme-color) + 并行会话成果入库
## 品牌标识(本次会话)

起因:品牌此前没有任何图形标识 —— 唯一 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 未做部分)
2026-09-21 10:05:48 +08:00

2.3 KiB
Raw Permalink Blame History

27 · 输入框 Input

27.1 用途

在一行内收集单行文本(姓名、手机号、金额、验证码等);移动端与桌面端的关键差别是热区与字号:输入框整行占满、高度不小于 44px,字号不小于 16px,否则 iOS 聚焦时会自动放大页面;清除动作也必须在框内完成,因为触屏没有悬停的鼠标可以移开。

27.2 结构(anatomy)

  • field:字段容器,包裹输入框与下方错误提示(错误提示在框外,不挤占输入区)
  • prefix:可选前缀,放单位或符号(如「¥」)
  • control:原生 input,占满剩余宽度,字号 16px
  • clear:可选清除按钮,有值且 clearable=true 时出现在右侧
  • suffix:可选后缀,由默认插槽给出的自定义内容(单位、显示密码等)
  • errorText:字段下方的错误提示文字

27.3 变体维度

  • size:default(高度 44px)/ large(高度 52px)
  • clearable:false(无清除按钮)/ true(有值时右侧出现清除按钮)

27.4 状态

  • default:常态
  • focus:聚焦,边框变品牌色并带 2px 聚焦外发光
  • error:错误,边框变错误色且 aria-invalid="true"
  • disabled:置灰且不可聚焦

27.5 交互与触控

  • 输入框高度不小于 44px;整行可点(把 kole-m-input 放在 label 里,点行即聚焦)
  • 清除按钮视觉是 16px 图标,热区外扩到 44px 最小触控边长
  • 聚焦反馈是边框色 + 2px 外发光,150ms 过渡;不改变布局(不撑开高度)
  • 有值时清除按钮才出现;清除后焦点留在输入框
  • 键盘「完成」键触发 confirm 事件,值随 input 事件实时回传

27.6 无障碍

  • 输入框用原生 input,名称由 aria-label 给出(占位文字不算标签)
  • 错误态用 aria-invalid="true",错误文案用 aria-describedby 关联
  • 清除按钮是原生 button 且带 aria-label="清除"
  • 禁用态用原生 disabled,读屏会跳过

27.7 doNotInvent

  • 输入内容的正则与业务校验(合法性判断在宿主)
  • inputmode 之外的自定义软键盘行为(键盘类型由宿主按场景指定)
  • 自动填充与验证码自动读取的策略

27.8 unknowns

  • 密码是否需要内置「显示/隐藏」开关
  • 数字输入的千分位格式化时机
  • 前缀里是否允许放图片/图标