我按下 F11,把浏览器铺满整块屏幕,然后起身关了宿舍的灯。
深色背景,不停翻滚的数字,地图上一明一灭的呼吸光点。那是清明前后,我刚新建了一个叫 bigdata-frontend 的仓库,关起门来折腾数据大屏,上传页和几张图表的外壳刚调顺手。底下跑的明明只是几行随手写死的假数据,可灯一关,屏幕那片幽蓝一亮,我竟然真生出一点指挥千军万马的错觉,抱着胳膊欣赏了好一会儿。
(后来回想,那大概是这个项目里我最得意、也最心虚的五分钟。)
新鲜劲儿过得很快。等我准备撤掉假数据、真正往组件里接业务字段时,对着代码里那一排排空荡荡的容器,忽然不知道该往里填什么了。之前光顾着搭骨架、调动效,页面上每个数字是什么意思,没写过一份像样的数据字典;每个字段从哪来,也没跟后端把来路钉死。我盯着那些还在欢快跳动的假数字发了会儿呆,把原本想写的那篇“点亮数据可视化”心得删了,老老实实拉过草稿本,开始补本该做在最前头的笨功夫。
一个名字,能吵半天
最先拦住我的,是“活跃用户”。几乎每块大屏都会把它摆在最显眼的位置,我也不例外。可落到草稿纸上,我才发现自己根本说不清它算的是谁:当天点开过登录页的人?最近七天内有过实际业务操作的人?还是此时此刻正挂在线上的会话数?
旁边的“完成率”也一样。分子分母到底是提交总数除以任务总数,还是按人员去重之后再算?
在代码里随手敲个变量名只要两秒钟,把一个指标缩成没有歧义的一句话,往往得来回抠半天字眼。这些口径如果没在后端接口和前端组件之间对齐,字段含义、单位、时间跨度没落成白纸黑字,外头的图表做得越精致,底下的误解就被放大得越厉害。站在屏幕前的人只能凭着红绿颜色猜个大概;等过上一阵子发现两张表的数字对不上了,连我自己都分不清,究竟是上游数据源换了统计口径,还是前端折算单位时悄悄抹掉了小数点。
我在草稿本上给每个指标写了一行定义,写到第三个就开始头疼,但等把定义逐条钉死的时候,心里倒是踏实了不少。
刷得勤,不等于准
接着是时间。刚写大屏那会儿,为了让画面显得“活”,我总忍不住把定时器的刷新间隔调得很短,好像网络请求发得越密,系统就越敏锐。
后来一想就觉得好笑:假如上游的数据源每五分钟才归集计算一次,前端哪怕每秒钟去敲一次接口,拿回来的也永远是同一份旧账。屏幕上的数字不会因此准上半分,只是让服务器白白多转几圈。
轮询、服务端推送、本地缓存,本来就是对付完全不同场面的。真需要争分夺秒的告警指标,该走单独的事件推送通道,犯不着和满屏的常规统计卡片挤在同一个定时器里排队。至于性能,我也学乖了,先别急着换一套名头更响、粒子动效更炫的可视化库,不如先动手把空转的轮询砍掉,零散的重复请求合并起来,给折线图和散点图设好点数上限。页面到底顺不顺,得看加载耗时、请求次数和渲染帧率,凭肉眼觉得“好像流畅多了”,是当不得数的。
那个兜底的 0
最让我脸红的是这一处。写业务页面那阵子图省事,接口没返回或者报错,我顺手就拿一个 0 兜底。
直到有一次自己盯着屏幕,看见某张卡片显示 0,下意识以为“今天确实没人提交”,过了好几秒才反应过来:是接口挂了。
在看表的人眼里,0 意味着业务确确实实发生了、只是统计出来的数量恰好为零,这和“压根没收到记录”完全是两码事。后来我把几种状态一个个拆开安顿:请求还在路上跑,就用灰色骨架屏先占住位置,告诉用户数据正在拉取;接口正常返回了空数组,就大大方方写明“暂无数据”;万一遇上网络抽风或者接口报错,就把上一次成功拉到的数据留在原地,并在卡片角落醒目标出最近更新的时间戳和异常提示。这远比让整块区域突然黑掉,或者渲染出一排真假难辨的 0,要靠谱得多。
把这些边角状态妥妥帖帖安顿好以后,大屏才算得上是一件能帮人做判断的工具,不再只是一段供人参观的演示动画。
好看要有分寸
视觉设计当然也重要,只是这份好看得收在“方便比较”和“快速定位”的分寸里头。每种颜色指向固定的业务含义,呼吸灯别抢了真实读数的风头,每张图表都老老实实带上单位和时间跨度。
一个人维护的小项目,更要克制住把所有花哨图表都往画布上摆一遍的冲动。少放几种猎奇组件,把剩下每一种在加载、空值、超时、越界时的模样都测透,往后维护起来日子会好过得多。
折腾到后来,我越来越觉得数据大屏像一层翻译:它负责把数据库表里冷冰冰的行与列,翻译成站在几步开外也能一眼读懂的画面,而一位称职的译者,绝不能擅自篡改或丢掉原文的上下文。现在每次手痒想再往画布上塞一张新卡片时,我都会先停下来问自己一句:这张卡能帮看屏幕的人改变哪一个具体决定?要是什么决定都改变不了,它多半只是在凑热闹。
后来
那天晚上我把整理好的字段说明一列列补进文档,全部理清时夜已经很深了。
bigdata-frontend 最初那几条简短的提交,回头看倒像一句及时的提醒,拦住了我把页面炫酷程度当成绩单的那点虚荣。比起抓人眼球的光点,真正值得长久留在仓库里的,其实是扎实的数据字典、严丝合缝的接口约定,以及对每一处异常状态的妥帖安置。它们不会出现在漂亮的宣传截图里,但几个月后的我,或者下一个接手的人,能靠它们一眼看明白:屏幕上的每个数字,为什么安安静静停在那里。