aurora-admin/.design_library/kole-ui-mobile/spec/parts/_merged/mobile-textarea.md at main

root/aurora-admin

Fork 0

Files

T

aurora-admin f1fbfc2ddb

Regression / regression (push) Canceled after 0s

Details

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.7 KiB

Raw Permalink Blame History

31 · 多行文本框 Textarea

31.1 用途

收集可能超过一行的自由文本（备注、收货说明、退换原因）；移动端与桌面端的关键差别是高度：文本框本身要够高（至少 3 行），因为触屏不能像桌面那样在输入过程中看到上下文；并且要给出实时字数反馈，超限时是「止写 + 报错」而不是静默截断。

31.2 结构（anatomy）

field：字段容器，包裹文本框、计数行与错误提示
control：原生 textarea，多行输入，行高不小于 1.5 倍字号
counter：右下角字数计数（已输入/上限），maxlength>0 时出现
errorText：字段下方的错误提示文字（与计数同行时计数不消失）
label：无障碍名称（aria-label），textarea 的初始高度由 rows 决定

31.3 变体维度

size：default（最小高度 3 行）/ large（最小高度 5 行，长文本场景）
showCounter：false（不显示计数）/ true（右下角显示「已输入/上限」）

31.4 状态

default：常态
focus：聚焦，边框变品牌色并带 2px 聚焦外发光
error：错误，边框变错误色且 aria-invalid="true"
disabled：置灰且不可聚焦
full：已达到 maxlength 上限（计数变错误色，继续输入不再增加）

31.5 交互与触控

文本框最小高度 3 行（约 96px：3 × 24px 行高 + 上下 12px 内边距）；只允许纵向伸缩（resize: vertical），不允许横向拉宽破坏 375 宽的布局
计数随输入实时更新；达到上限时计数置错误色并停止接收新字符（原生 maxlength 兜底，超限靠宿主提示）
文本框整体可点即聚焦（外层不出可点装饰）；错误提示与计数都在框外，不挤占输入区
聚焦反馈是边框色 + 2px 外发光，150ms 过渡；不改变高度
不使用自动增高（高度随内容跳动会让上下文错位），需要更长文本时用 size=large

31.6 无障碍

控件是原生 textarea，名称由 aria-label 给出（占位文字不算标签）
错误态用 aria-invalid="true" + aria-describedby 关联错误文案
计数是参考信息，用 aria-live="polite" 播报（不要每敲一个字都播报，只在接近上限时提示）
禁用态用原生 disabled，读屏会跳过

31.7 doNotInvent

自动增高（随内容撑高）的实现细节
富文本 / Markdown 的编辑与渲染
内容敏感词过滤与提交前的业务校验

31.8 unknowns

maxlength 缺省时上限取多少（本实现默认 200）
是否需要在接近上限时提前变色（本实现只在到达上限时变色）
计数是否包含空格与换行

2.7 KiB Raw Permalink Blame History Unescape Escape