Record the dashed soft-card empty state as the global van-empty default, with a visual demo for review. Co-authored-by: Cursor <cursoragent@cursor.com>
2.7 KiB
2.7 KiB
mobile-h5 全局空态(Empty State)设计
日期: 2026-08-10
范围: mobile-h5 空态组件视觉统一
选定方案: B(虚线软卡)
参考 Demo: mobile-ui/zkxw-mobile-empty-state-demo.html(方案 B)
背景
主页功能菜单清空后,VanEmpty 当前以「∅ + 灰色文案」展示,视觉偏弱且与三墙 Demo / zkxw-mobile-vant-ui-demo 中的空态风格不一致。需统一全局空态样式。
目标
- 全局默认空态采用方案 B:薄荷绿渐变虚线框 + 圆形插画 + 主文案(+ 可选副文案)
- 所有使用
van-empty/VanEmpty的页面样式一致 - 仅改组件实现,业务文案由调用方传入
非目标
- 不引入方案 E(横向紧凑)变体(后续如需再开)
- 不改业务文案含义(如「暂无可用菜单权限」仍由页面传入)
- 不引入真实 Vant Weapp 依赖;继续使用 H5 shim 组件
视觉规格(方案 B)
| 项 | 值 |
|---|---|
| 容器背景 | linear-gradient(165deg, #eef9f3 0%, #ffffff 55%) |
| 边框 | 1.5px / 3rpx 虚线 #b7e5d0 |
| 圆角 | 约 14px / 28rpx(对齐卡片节奏) |
| 插画区 | 圆形,径向渐变 #fff → #d8f3e7,内嵌 inbox SVG,描边 #0a9f6d |
| 主文案 | 26rpx,颜色 #5d746a |
| 副文案(可选) | 22rpx,颜色 #8aa198,居中 |
| 内边距 | 约 44rpx 28rpx 40rpx |
| Token | 三墙绿链,禁止使用管理端 #10b981 |
组件 API
文件:mobile-h5/components/van-empty/van-empty.vue
| Prop | 类型 | 默认 | 说明 |
|---|---|---|---|
description |
String | ''(展示时回落「暂无数据」) |
主文案 |
tip |
String | '' |
副文案;空则不渲染 |
结构:
.v-empty
.v-empty__card
.v-empty__blob(inbox SVG)
.v-empty__desc
.v-empty__tip(v-if tip)
调用约定
| 页面 | 用法 |
|---|---|
pages/index/index.vue |
description="暂无可用菜单权限",可选 tip="请联系管理员开通功能入口" |
pages/demo/list.vue |
description="暂无数据" |
pages/demo/comps.vue |
description="暂无相关数据",可带 tip 演示副文案 |
样式只维护在 van-empty.vue(scoped);不在各页面覆盖空态视觉。
验收
- 主页无菜单时显示方案 B 样式,非 ∅ 符号
- demo 列表空数据、组件演示页空态与主页视觉一致
- 色值符合三墙 Token;无管理端薄荷绿混用
- 未传
tip时不出现空白副文案占位
参考
- Demo 对比页:
mobile-ui/zkxw-mobile-empty-state-demo.html - 既有 Demo 组件区:
mobile-ui/zkxw-mobile-vant-ui-demo.html(.comp-empty-box)