docs: 固化小程序设计与模板渲染规范
This commit is contained in:
1 parent
17af0f6883
commit
e4adfc6b13
3 files changed
+163
No files matched your search
@@ -0,0 +1,56 @@
|
||||
# 小程序 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`,页面不得按行业写死字段;
|
||||
- 提交按钮只在成功响应后结束提交状态;
|
||||
- 字段校验错误显示在对应字段附近,网络错误显示在表单级别;
|
||||
- 表单提交保存版本和字段快照,历史记录不受后续配置修改影响。
|
||||
|
||||
## 验收要求
|
||||
|
||||
组件必须在模拟器和真机验证,覆盖正常、禁用、加载、错误和空数据状态;新增组件必须通过格式检查和小程序类型检查。
|
||||
Reference in new issue
Block a user