交互与用户体验 / 系统课时
向开发标注组件状态与交互规则
向开发标注组件状态与交互规则
同一张看板设计稿,开发可能做出不同的筛选范围、悬停提示和异常反馈。本课以订单分析页为例,把图表的字段口径、触发动作、状态切换和小屏规则写成可核对的组件规格,让设计交付不仅能看,还能按条件验收。
学习目标
- 编写包含数据字段、统计口径和显示规则的组件规格。
- 明确页面筛选、组件筛选、Tooltip 与钻取的触发及影响范围。
- 为加载、空数据、失败、断连和响应式布局制定可复现的验收用例。
给每个组件写清字段和口径
假设页面包含“已支付订单数”KPI、“每日支付趋势”折线图和“地区订单明细”表。交付表里的字段名是本案例约定,实际项目须与接口字典逐项对齐,不能让前端凭字段名猜含义。
| 标注项 | 组件规格 |
|---|---|
| 组件标识 | paid-orders-kpi、daily-paid-trend、region-order-table |
| 数据来源 | order_id、paid_at、region、channel、source_updated_at |
| 统一口径 | 已支付订单数按 order_id 去重;仅统计 paid_at 不为空的订单;已退款订单仍计入历史支付量 |
| 趋势坐标 | X 轴按 Asia/Shanghai 自然日分组,Y 轴为当天去重订单数,单位“单”,从 0 起 |
| 默认范围 | 2026-09-01 至 2026-09-30,包含首尾两天,地区为“全部” |
| 空值语义 | 当天确实没有订单记为 0;日期未采集或统计失败记为缺失,不把缺失补成 0 |
设计稿应把单位、字段映射、日期时区、统计口径贴在组件旁。对于 9 月 12 日“18 单”这样的标注,开发必须能追溯到筛选条件和去重规则,而非仅复刻曲线形状。
把筛选与交互写成触发规则
页面级筛选为日期范围和地区,提交后同时更新三个组件;趋势图内另设“渠道”筛选,只改变趋势图与从该图打开的详情,不改变 KPI 和地区表。趋势图标题旁持续显示“渠道:App(仅此图)”,避免读者误以为三处数据口径一致。
- 用户修改日期或地区时,仅更新“待应用条件”;点击“应用筛选”才提交请求,并显示当前“已应用条件”。
- 新请求开始后,标记加载中;若用户连续提交两次,只应用最后一次请求的结果,较早返回的数据不得覆盖当前筛选。
- 桌面端悬停在 9 月 12 日的数据点上,Tooltip 显示“9 月 12 日|18 单|较前一日 +2 单(+12.5%)”。该例以前一日 16 单计算;基期为 0 或缺失时显示“不可计算”,不显示无穷百分比。
- 点击趋势点打开订单详情抽屉,继承页面筛选、该点日期和图内渠道;关闭抽屉不改动页面筛选。键盘焦点进入数据点后按 Enter 同样打开,按 Esc 关闭。
用状态转换说明异常时怎么显示
首次加载显示骨架屏;二次刷新可保留上一次成功图表,但要标注“旧筛选结果·更新中”,不能把新条件贴到旧数据上。请求成功且有数据展示图表;成功但结果集为空展示“当前条件下无记录”,不能画一条误导性的零值线。失败时若存在旧数据,保留旧图并明确标记“更新失败”,提供“重试”;若没有旧数据,则展示错误态。

断连和过期需分开判断:断连描述连接状态;数据是否过期则比较当前时间与服务端 source_updated_at。本例超过 120 秒显示“数据可能过期”和服务端最后更新时间;即使刚刚点击“刷新”,也不能以页面刷新时间替代数据时间。
为不同屏宽规定具体行为
| 视口宽度 | 布局与交互 |
|---|---|
| ≥1024 px | 12 列布局;KPI 独占首行,趋势占 8 列,地区表占 4 列;鼠标悬停显示 Tooltip |
| 600~1023 px | KPI、趋势、地区表纵向排列;筛选控件允许换行 |
| <600 px | 按筛选、KPI、趋势、地区表依次单列;趋势绘图区最小宽度 640 px,容器内横向滚动;点击数据点在图下方固定详情区展示信息 |
筛选按钮的触控热区至少 44×44 px;密集数据点采用“就近日期”命中规则,避免热区重叠。选中态还须提供描边或文字标识,不能只改颜色。图表宽度变化不能改变统计结果,Tooltip、固定详情区也应使用同一份字段定义。
用可复现的测试条件验收
交付时附上组件状态、字段映射、示例数据、断点规则和测试表,并写明设计稿版本。以下示例使用约定的测试数据,不把演示值当成真实业务结果。
| 测试操作 | 应看到的结果 |
|---|---|
| 9 月 11 日 16 单、12 日 18 单;悬停 12 日 | 提示 18 单、+2 单、+12.5% |
| 页面地区改为“华东”并应用 | KPI、趋势、地区表同步更新;已应用条件变为“华东” |
| 趋势渠道改为“App” | 仅趋势及其钻取详情变化;KPI、地区表数值不变 |
| 连续提交 A、B,A 最后返回 | 画面仍为 B 的结果 |
| 返回成功但无订单 | 显示空状态,不以请求失败或“0 单折线”代替 |
| 断网且旧数据距今 180 秒 | 保留旧图,显示断连、数据过期和服务端更新时间 |
| 390 px 手机点击趋势点 | 固定详情区可读,图内可横向滚动,页面本身不横向溢出 |
实际评审时让开发逐条回填“已实现/待确认/不支持”,并给每个差异标注组件标识和复现步骤。无法用测试条件描述的交互,还不算完成交付。