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

2.0 KiB
Raw Blame History

小程序 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,页面不得按行业写死字段;
  • 提交按钮只在成功响应后结束提交状态;
  • 字段校验错误显示在对应字段附近,网络错误显示在表单级别;
  • 表单提交保存版本和字段快照,历史记录不受后续配置修改影响。

验收要求

组件必须在模拟器和真机验证,覆盖正常、禁用、加载、错误和空数据状态;新增组件必须通过格式检查和小程序类型检查。