一家做环境检测的实验室,水样里某项指标的检测结果是 0.0000231 mg/L。系统按 Excel 的老习惯把它显示成 2.31E-05。报告发到委托方,评审意见回来只有一句,请按规范写成 2.31×10⁻⁵。
数值和量级都没变,卡住的是那个 E,和没有抬起来的指数。
报告是签字盖章的交付物。格式不统一,评审方有理由怀疑记录本身不够严谨。落到报告员身上,这还意味着一趟额外的流程,改完要复核,复核完要重新走签发。
这类实验室的报告通常套一份固定模板,几十个检测项,每项都有检出限和单位。数据从仪器和原始记录汇总进系统,到交付环节却要按行业规范重排一遍格式。常见的处理是导出到 Excel 手工改,或者在 Word 里把数字重新打一遍。一份报告几十个数据点,逐个改并不轻松。改完之后,报告上的数和系统里的原始值不再对应,复检追溯要靠人工比对。
检测、医药、材料、半导体这些行业对数字写法有硬性要求。浓度可以低到 10 的负六次方,颗粒计数可以高到 10 的九次方,同一张表里量级差十几个数量级。半导体厂务的颗粒物计数、电池材料的微量元素含量,走的也是这个路数。科学计数法在这里承担的是让人一眼看出量级的作用。
单元格里存的是数,看到的写法是另一层
电子表格的模型把值和显示分得比较清楚。一个单元格有值,也有格式。值是 0.0000231,格式决定它显示成 0.0000231、2.31E-05,还是 2.31×10⁻⁵。公式引用、排序、求和用的是值,眼睛看到的是格式渲染出来的文本。
Excel 的格式系统覆盖得比较全,百分比、千分位、日期、货币、科学计数都在里面。它内置的科学计数格式输出 2.31E-05 这种写法,指数紧跟在 E 后面,负号是普通减号。这是工程计算里常见的简写,不少行业报告要的却是 2.31×10⁻⁵,10 后面跟一个抬高的指数。同一个数,两套排版约定。
多数前端表格控件在这里会露出短板。它们能渲染数据,能调列宽和颜色,数字格式却常常只有内置的几种。要让一个数显示成上标形式,通常有两条路。后端提前拼好字符串再传给前端,显示是解决了,传下来的却已经是文本,排序和再次计算都要另想办法。前端直接改 DOM,滚动、复制、编辑之后很容易和真实值错位。
显示文本如果直接参与排序,顺序也会错。1.1×10⁴ 和 9.8×10⁵ 按字符比较,前者排在前面;按数值比较,后者大得多。报告里的顺序一旦错了,读者很容易把量级看反。
SpreadJS 的做法是把数字格式当成单元格属性,格式器允许开发者自己实现。写一个格式器,相当于告诉引擎,拿到原始值以后按我的规则算出显示文本,这段文本只参与呈现,单元格里存的仍然是原来那个数。JavaScript 电子表格控件要做到类 Excel 的体验,这一层绕不过去。
格式器通常要实现两个方向。一个方向把值变成显示文本,另一个方向把用户敲进去的文字变回值。前者决定报告长什么样,后者决定改数时系统怎么理解。两个方向都写清楚,格式才算完整。
以上标形式为例,处理过程可以拆成三步。先把数值转成指数形式的字符串,得到类似 1.23e+4 的结果。再把指数位置上的每个数字换成对应的上标字符,正指数写成 ⁴,负指数写成 ⁻⁵。最后把中间的 e 换成 ×10。12347.57 保留两位,显示为 1.23×10⁴,参与计算的依然是 12347.57;保留三位,显示为 1.235×10⁴。
这里有个容易被忽略的细节。显示位数由人设定,四舍五入只发生在显示层。原始值的精度不变,报表里看到的是 1.23×10⁴,单元格里存的还是 12347.57。对需要复核的检测数据,这个区分很有分量。
上标由 Unicode 的上标字符拼成,没有使用富文本的上标样式。换字体时要确认 ⁻ 和 ⁴ 这类字符在目标字体里有字形,缺字会显示成方框,打印出来更扎眼。
检测表里也不全是数字,偶尔有“未检出”或者“<0.001”这样的文本。格式器判断到非数字会原样返回,不会把整列弄乱。
会写格式器的人,和每天要用它的人
格式器解决了显示,写格式器的却是开发。实验室的报告员不会去改一段构造函数。能力要落到日常,得有另一个入口。
在 SpreadJS 的设计器里,这个入口可以是一条自定义命令。工具栏增加一个选项卡,里面放一个按钮,选中单元格以后点一下,弹出小对话框问保留几位小数。确认后,当前单元格的格式换成上标科学计数法。再次点开时,对话框里带出这个单元格当前的设置,不用每次从零填。
对话框里的数字值得加一层校验。填 0、负数或者一个过大的位数,格式要么退回原值,要么在转换时出错。把范围卡在合理区间,报错提示写清楚,用户不用猜系统为什么不动。
这一步决定了这个能力是项目交付时的一次性配置,还是业务人员能自己维护的日常操作。客户把报告规范从三位小数改成两位,报告员在对话框里改个数字就行,不用排一轮开发。整套符号约定都要换的时候,比如改成 10 的幂次写法或者换一种单位前缀,仍然需要开发介入,格式器的规则本身得重写。
实践上还有一处要处理。自定义格式器有自己的类型名,引擎在读取和应用单元格样式时,要靠类型名找回对应的格式器。把类型名登记到类型解析入口,格式才能在样式的读取和重新应用中被识别。漏掉这一步,格式在单个单元格上看着正常,换个位置就可能退回默认显示。
格式逻辑跟着前端走,还有个附带的好处。显示规则变了,改的是页面里的格式器,后端接口不用跟着发版。检测系统的接口常常连着仪器和实验室管理系统,动一次牵扯好几方,能把这类改动留在前端,推进起来会轻一些。
上标也有它不合适的场合
科学计数法有适用范围。量级跨度大、尾数精度重要的数据适合,浓度、颗粒计数、概率、电阻率都是。金额、库存件数、人数不适合,读者要在脑子里换算量级,反而增加负担。一份报价单上写 1.23×10⁴ 元,不如写 12300 元。
上标写法还占宽度。指数抬高以后,同一列要留出更多空间,窄屏或者打印时容易截断。小数位设得太少,尾数信息在显示层就丢了,原始值还在,报告上却看不出来。规范如果要求体现有效数字,位数要按有效数字来定,不能随手设成两位。有效数字和小数位是两个概念,1.23×10⁴ 有三位有效数字,尾数却只保留两位小数,规则按哪个写,格式器就得按哪个算。
单位前缀和科学计数法最好别在同一张表里混用。1.23×10⁴ 和 12.3k 说的是一个量,读者却要换算两次才敢比较。选定一种写法,整份报告统一到底。
反向输入也要提前想清楚。把 2.31×10⁻⁵ 这样的文本粘回单元格,在没有对应解析规则的情况下,它会被当成文本,不会自动还原成数值。格式器的解析方法默认只处理能转成数字的输入,上标字符不在其中。业务上如果真有这种粘贴需求,得把上标字符的反向映射补上,否则两个看起来一样的单元格,一个是数,一个是字符串。
落到不同岗位上,这件事的分量不一样
对检测和业务人员,价值在报告一次过评审。不用导出后再手工改数字,报告里的数和系统里的原始记录对得上,复检时不用再翻两套文件。
对产品经理,数字格式是验收项的一部分。客户嘴上说的是报告要符合规范,落到系统里就是某个字段显示成什么样子、保留几位、指数怎么写。需求评审时不写清楚,上线后它会以缺陷的形式回来。
对技术负责人,格式放在单元格属性上,显示逻辑就不必侵入数据管道。后端传数值,前端负责呈现,导出和打印才有机会沿用同一套规则,不用每个出口各写一遍拼接。
对开发,路径是清楚的。继承 SpreadJS 的格式器基类,实现格式化和解析两个方法,通过单元格的格式属性挂上去,再用自定义命令和对话框交到业务人员手里。工作量不大,难的是把业务规范翻译成规则,把边界情况想全。
验收时,挑一个最小的数看一眼
如果团队正在推动 Excel 迁移,把检测、报价、实验数据这类表格搬进浏览器,验收时可以找一个最小的数试试。挑一行 0.0000231,看它在系统里显示成什么。如果还是 2.31E-05,而交付规范要求 2.31×10⁻⁵,后面大概率还要补一轮。
回到那份水样报告。报告员选中单元格,在对话框里填上两位,屏幕上出现 2.31×10⁻⁵。单元格里存的仍是 0.0000231,复检时点开就能看到,评审这一关也就过去了。
SpreadJS 的自定义格式能力正是冲着这类差异去的,事情不大,返工的次数却不少。