Files
persionalBrand/docs/miniapp-design-system.md

57 lines
2.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 小程序 Design System
## 目标
小程序通过个人品牌表达建立信任,并将信任转化为咨询、合作或预约。组件库只提供稳定交互能力,最终视觉由品牌层统一控制。
## 视觉 Token
基础 Token 统一维护在 `apps/miniapp/styles/tokens.wxss`:
- 背景:暖白 `#FBF7F1`、米黄 `#F4EBD9`;
- 主色:砖红 `#B54A2C`,交互按下态使用更深砖红;
- 文字:深炭黑 `#2B2B2B`,辅助文字使用深棕 `#7A4A2B`;
- 强调色:浅橙 `#E8A75F`;
- 页面左右安全边距:`32rpx`;
- 卡片圆角:`16rpx`;控件圆角:`12rpx`。
行业模板不得覆盖基础 Token。未来如需品牌换肤,应通过版本化 Token 配置实现,不在页面中写死行业颜色。
## 组件分层
### 基础能力层
`tdesign-miniprogram` 负责输入、选择、弹层、Loading 和无障碍行为。
### 品牌组件层
页面只能依赖以下项目组件:
- `BrandButton`
- `BrandField`
- `BrandSelect`
- `BrandDatePicker`
- `BrandDialog`
- `BrandCard`
- `BrandLoading`
- `BrandEmpty`
- `BrandError`
品牌组件必须封装 TDesign 的视觉变量,禁止页面直接使用 `t-*` 组件完成业务布局。
## 状态规范
所有远程数据页面必须显式处理:加载中、空数据、请求失败、提交中、提交成功和提交失败。失败状态必须保留用户输入,并提供可操作的重试或返回路径。
## 表单规范
- 标签、必填标记、帮助文本和错误文本由 `BrandField` 统一渲染;
- 表单字段来自后端 `InquiryForm`,页面不得按行业写死字段;
- 提交按钮只在成功响应后结束提交状态;
- 字段校验错误显示在对应字段附近,网络错误显示在表单级别;
- 表单提交保存版本和字段快照,历史记录不受后续配置修改影响。
## 验收要求
组件必须在模拟器和真机验证,覆盖正常、禁用、加载、错误和空数据状态;新增组件必须通过格式检查和小程序类型检查。