图表不只是画线:Chart.js、Victory 与可核对的数据展示
本文目录
一张曲线图即使没有报错,也可能在展示错误的口径。PV、UV、在线人数、来源和点击数应能追溯到采集与聚合规则;图表负责表达,不能用随机数或模拟数据掩盖没有采到事件。
先写数据契约
在接口返回日期范围、时区、指标定义和样本状态。缺少某天记录是 0、未知还是采集故障,必须区分。在线人数还涉及心跳窗口、后台标签页和去重标识;把窗口说明放在指标旁边,别让读者猜。
| 场景 | 工具方向 | 核心成本 |
|---|---|---|
| 常规折线、柱状、饼图 | Chart.js | Canvas 的文本替代、插件和实例生命周期 |
| React 声明式组合 | Victory | 组件组合、数据规模与渲染开销 |
| 自定义坐标和视觉编码 | D3 | 自己组织交互、布局与可访问性 |
| 丰富的业务图表 | ECharts / G2 | 配置体积、主题和联动 |
这些是实现方向,不代表某一工具永远更快。对同一份真实规模数据测量加载、首次渲染、筛选和 resize。
Chart.js 最小生命周期
在已有 canvas 的工程安装 chart.js:
import Chart from 'chart.js/auto';
export function mountVisits(canvas, rows) {
const chart = new Chart(canvas, {
type: 'line',
data: {
labels: rows.map(row => row.day),
datasets: [{ label: 'PV', data: rows.map(row => row.pv), borderColor: '#2563eb' }],
},
options: { responsive: true, maintainAspectRatio: false, animation: false },
});
return {
update(next) {
chart.data.labels = next.map(row => row.day);
chart.data.datasets[0].data = next.map(row => row.pv);
chart.update('none');
},
destroy() { chart.destroy(); },
};
}
给 canvas 的父容器明确高度和相对定位,移动端改变容器尺寸时由图表更新。离开页面调用 destroy,不能在同一个 canvas 上不断 new 实例。示例用 auto 换取简单性,正式工程可以只注册需要的 controller、scale、element 与 plugin,并比较包体。
Victory 的组合边界
Victory 以 React 组件描述图形,适合把数据和选中状态纳入组件模型。不要假设 React 包装就自动适合数万点实时数据;过多标记、文本和交互节点仍可能耗时。按业务目标聚合与降采样,并告诉用户缩略曲线与原始数据的关系。
SSR 需测试当前版本及容器测量行为。无论 Canvas 还是 SVG,都要为键盘用户提供等价筛选和明细入口,不能只有鼠标 tooltip。
从曲线跳到证据
热门页面和点击元素应有可操作的明细按钮。携带相同日期和筛选条件,在服务端分页返回事件;不要点击一项后显示全站数据。明细访问受权限控制,敏感字段最小化,导出也必须遵守同样的范围。
数值卡片显示请求失败时应保留明确错误或旧值时间戳,不能回落成貌似真实的 0。加载态、无记录、部分采集和后端不可用至少分成四种状态。
可访问性与边界值
为每张图提供标题、简短结论与可展开数据表;同一指标不只靠颜色区分。用 tabular-nums 减少数字跳动,长路径可以换行但保留完整值。手机端图例、筛选和图表应独立布局,不挤成一排。
测试全零、单点、缺天、大值、负值、夏令时、非整数和接口乱序。时间范围到底包含几天,要明确首尾均包含还是半开区间;所谓“最近 7 天”不能意外返回 8 个日期。
官方资料
资源发现来源:25 项前端资源清单。
实战:先让每日数据能够被核对
下面补一条完整的数据准备链路。它是独立练习,不声称当前博客后台使用了这些字段。接口示例约定:day 是 UTC 日历日;pv、uv 是该日完整统计值;省略某天表示未知,而不是零。真实项目可以选北京时间等业务时区,但应由服务端按同一时区分桶,不能把下例的 UTC 日期直接贴上“北京时间”标签。
为什么先处理数据?假设 11 月 1 日有 20 次访问,2 日没有采集结果,3 日有 0 次访问。图上应该是“20、断点、0”。如果先填零再画图,读者会把采集故障理解成流量归零;如果只画已有两天,间距又会隐藏缺失的一天。
可直接执行的日期与数值校验
下面的函数接收首尾均包含的日期范围,输出有序、补齐日历的记录。它不修改输入,不猜测字符串数字,不累加重复日期的 UV,最多接受 366 天。预算属于本例设计,实际服务端还应限制查询成本。
export function normalizeDailyVisits(rows, start, end) {
const DAY = 86_400_000;
function dayTime(value) {
if (typeof value !== 'string' || !/^\d{4}-\d{2}-\d{2}$/.test(value)) {
throw new TypeError('日期必须是 YYYY-MM-DD');
}
const time = Date.parse(value + 'T00:00:00.000Z');
if (!Number.isFinite(time) || new Date(time).toISOString().slice(0, 10) !== value) {
throw new RangeError('不存在的日期');
}
return time;
}
const first = dayTime(start), last = dayTime(end);
const count = (last - first) / DAY + 1;
if (count < 1 || count > 366 || !Array.isArray(rows) || rows.length > count) {
throw new RangeError('日期范围或行数超出预算');
}
const byDay = new Map();
for (const row of rows) {
if (!row || typeof row !== 'object') throw new TypeError('无效记录');
const time = dayTime(row.day);
if (time < first || time > last || byDay.has(row.day)) {
throw new RangeError('日期越界或重复');
}
for (const key of ['pv', 'uv']) {
if (!Number.isSafeInteger(row[key]) || row[key] < 0) {
throw new TypeError('指标必须是非负安全整数');
}
}
if (row.uv > row.pv) throw new RangeError('此统计契约下 UV 不能超过 PV');
byDay.set(row.day, { day: row.day, pv: row.pv, uv: row.uv, known: true });
}
return Array.from({ length: count }, (_, index) => {
const day = new Date(first + index * DAY).toISOString().slice(0, 10);
return byDay.get(day) ?? { day, pv: null, uv: null, known: false };
});
}
把函数存为 daily-visits.mjs 后,在另一份模块中运行:
import { normalizeDailyVisits } from './daily-visits.mjs';
const days = normalizeDailyVisits([
{ day: '2026-11-03', pv: 0, uv: 0 },
{ day: '2026-11-01', pv: 20, uv: 8 },
], '2026-11-01', '2026-11-03');
console.assert(days[0].pv === 20);
console.assert(days[1].known === false && days[1].pv === null);
console.assert(days[2].known === true && days[2].pv === 0);
接到前面的 mountVisits 时,把 days 当作 rows;给折线数据集明确设置 spanGaps: false,保留未知日期的断点。数据表显示“未采集”而非字符串 null,真实零值照常显示 0。日期函数会拒绝 2026-02-30,避免 JavaScript 自动纠正日期后悄悄画到三月。
这份校验有明确前提:PV 是页面浏览、UV 是这些浏览中的独立访客,因此 UV 不大于 PV。如果产品把 UV 定义成所有心跳用户,规则就不成立,应该先更正接口契约。区间 UV 也不能由每日 UV 求和:同一个人在三天访问会被算三次;区间去重必须由掌握访客标识的聚合层完成。
不让旧请求覆盖新筛选
快速从“最近 7 天”切到“最近 30 天”,7 天请求可能更晚返回。只给按钮加 loading 无法解决它。下面用取消信号节省资源,再用代次检查阻止迟到结果,二者各有作用:取消不保证服务器立即停止,某些测试替身也可能忽略信号。
export function createLatestQuery(fetchRows, commit, reportError) {
let generation = 0, active, disposed = false;
return {
async load(range) {
if (disposed) return;
const current = ++generation;
active?.abort();
const controller = new AbortController();
active = controller;
try {
const rows = await fetchRows(range, controller.signal);
if (disposed || controller.signal.aborted || current !== generation) return;
commit(normalizeDailyVisits(rows, range.start, range.end));
} catch (error) {
if (disposed || controller.signal.aborted || current !== generation) return;
reportError(error);
} finally {
if (current === generation) active = undefined;
}
},
dispose() {
disposed = true;
generation++;
active?.abort();
active = undefined;
},
};
}
fetchRows 负责 HTTP 状态检查、解析 JSON 和请求期限;commit 更新图表与表格,reportError 显示错误。二者是同步且不抛错的界面适配函数。把 normalizeDailyVisits 放在同一模块或显式导入。组件卸载先 dispose(),再销毁图表,防止结果写进已经离开的页面。此例不负责重试、缓存或 loading,不能直接当成完整请求框架。
从热门页面下钻到事件:一次操作应保留什么
| 层次 | 需要保留 | 容易出错的地方 |
|---|---|---|
| 热门页面排行 | 起止时间、业务时区、页面规范路径 | 排行查 7 天,明细却默认今天 |
| 页面内交互 | 路径、稳定元素 ID、事件类型 | 把按钮文案当唯一 ID,改文案后断档 |
| 单元素明细 | 上述条件、分页游标、排序规则 | 只按元素 ID 查到全站同名按钮 |
| 返回上一层 | 原筛选、页码和滚动位置 | 返回后筛选丢失,无法继续比较 |
URL 查询参数应经允许列表保留,令牌、邮箱、验证码等敏感参数不应进入埋点。旧路径含查询串、片段或尾斜线时,先定义归一化规则,再在查询层兼容;不要为了统计方便直接删除原始证据。点击详情也不能展示输入框值、访问密码或完整个人标识。
“所有可交互元素自动埋点”可以用委托监听覆盖按钮与链接,但播放器切歌、拖动进度、表单提交等需要语义事件。捕获每次鼠标移动或键盘输入会产生噪音和隐私风险。至少约定 play、pause、track_change、seek_complete 等事件,并对重复触发与高频事件采样;采集端和聚合端的版本都应能追踪。
图表在手机上怎样才算可用
先把日期选择与快捷范围放到图表上方;320px 时允许换成两行。图表父级设置 min-width: 0,否则位于 grid/flex 内的 Canvas 可能把整页撑宽。表格自身横滚,页面本身不横滚;tooltip 不承担唯一明细入口,列表里的“查看明细”按钮需要可聚焦、可触摸。
不要把五条曲线、十个图例和全部日期都挤进首屏。可以默认展示核心指标,允许用户显式增加序列,同时保持单位、颜色和选择状态稳定。高对比文本、线型与点形共同传递含义;减少动画偏好开启时关闭非必要入场动效。空态仍保留日期和指标说明,读者才能判断是在看哪段数据。
排错时按这个顺序缩小范围:浏览器是否发事件 → 接口是否接收 → 是否持久化 → 聚合窗口和时区是否正确 → 管理端是否使用同一筛选 → 图表是否展示新数据。看到零值不能直接判定采集失败,也不能用演示数据填补。用明确时间的一次自有测试访问串起链路,删除测试数据则走独立、可核查流程。
补充资料与复现边界
- Chart.js 数据结构:核对缺失值的表达。
- Chart.js 可访问性:Canvas 仍需要文本替代。
- MDN AbortController:理解取消请求与清理生命周期。
两个函数和示例是本篇原创练习,可以离线保存后用 Node.js 执行;它们不连接本站数据库、不自动创建埋点,也不证明某个生产统计结果正确。项目选型目录保留在原资源专题,本文只深入数据契约、并发和展示。
留言提交后直接公开,请友善交流。