空态六律 出自 note《空态六律》↗

前端组件纪律 · 六条可抄进组件库

空态六律

把「判不了」渲染成一等状态 —— 空值是被看见的状态,缺栏不是。

判据
先红

每律皆可交互切 cause · 切口径 · 跑必红臂 · 点「判红」盖章 发布 2026-11-22

壹

律一 · LACKING SLOT

缺栏不可挑战:槽先落、值可为「—」

错值有能被打掉的对象,缺栏连对象都没有——一格写着「—」的界面强于整栏不存在,因为前者你知道该问谁。

原 则

结构缺失与错值是两类问题。整栏不存在时,用户连「这里该有个数」都提不出来。

落 法

占位符三件套 = 槽位名 + 「—」 + 一句为什么空。禁止用条件渲染把整栏连同表头一起吃掉。

组件实例 · 本周读数表

点「违规」看整栏被吃掉的样子
样本读数量程复检
A-070.420–1.011-25
A-08—为什么空:未到复检日0–1.011-30
B-030.190–0.511-27

「—」占位在槽里:该问谁、为什么空,都答得出来。

红实例

列头存在而数据缺位的格子,被 display:none 连坐隐藏——审查点名。

判红
贰

律二 · NULL TRIAGE

null 要分诊:四档四种按钮

「null」在 JSON 里长得一样,成因与处理动作相反——空态组件必须吃一个 cause 枚举,不许只有「暂无数据」。

原 则

未测量、测量失败、低于检出限、呈现层省略——四种空,四个相反的动作。

落 法

点下面四档切换 cause,看文案与主按钮怎么跟着换;把「测量失败」渲染成「暂无数据」,等于把仪器瞎记成内容病。

组件实例 · 空态分诊卡

未测量
cause:"unmeasured"

槽位在,仪器还没开口——去测就有数。

红实例

喂 cause:"measurement_failed" 却渲染通用文案 → 判红。

判红
叁

律三 · THIRD STATE

UNKNOWN 是第三种状态,不许折进绿

「判不了」是可以公开的结论,伪造的绿不是。校验异常被 catch 后 return true,或 unknown 被 || 默认成 pass,都是折法。

原 则

三态枚举 pass / fail / unknown;unknown 渲染为灰或琥珀,计数上算 pending、不算通过。

落 法

校验器 C 会抛异常。切到「三态枚举」看灰章与 pending 计数;切到「|| 默认 pass」看伪绿怎么造出来。

组件实例 · 三校验器结果板

校验器 A读数在量程内通过
校验器 B复检已超期不通过
校验器 C校验器抛异常UNKNOWN · 计 pending
通过 2不通过 1pending 1

unknown 公开为灰章:判不了就说判不了,pending 不溜进通过率。

红实例

塞一个抛异常的校验器,断言结果不得是「通过」——伪绿即红。

判红
肆

律四 · PENDING OBJECT

挂起态带四字段,默认朝不通过一侧

挂起卡片必带:各来源判词 · 缺哪一层 · owner(谁负责补)· 复检截止。没有 owner 的 pending 一周后默认升级 fail。

原 则

默认值总偏向放行,所以默认必须朝不通过那一侧:无 owner 渲染「未指派 · 按未解决计」。

落 法

挂起徽章的 props 就是这四个字段;工单「待处理」不许从完成率分母里溜出去。

组件实例 · 挂起卡(双读数冲突)

样本 A-08 PENDING · 挂起中
判 词
两来源冲突:0.42 / 0.19,未定谳
缺哪层
缺复核层(第二来源读数)
owner
大医(bot)
复检截止
2026-11-27

owner 在岗:到期未补复核,按未解决升级。

周报口径:

本周工单完成率 85%

分母含 2 张未解决 pending——待处理不许溜出分母。

红实例

无 owner 无截止的 pending 卡,在周报里被算成「已解决」→ 判红。

判红
伍

律五 · RED ARM

空态也要过必红臂:三条测试

一条从不由红变绿的判据恒真、因而无信息。空态逻辑同样要喂负控:应判空但数据其实在 / 不该判空但数据为空,都必须能红。

原 则

过滤条件写错导致全列表走空态、页面却平静写「暂无数据」——这是最日常的假空。

落 法

逐条点「运行」看左臂变红;再切「负控已接入」看修复后怎么变绿。红臂 = 这条测试真能判红。

组件实例 · 空态负控三条

T1过滤误伤

输入:A-08 在库,被过滤规则误伤 → 期望「显示数据」

T2真空态

输入:B-99 不存在 → 期望「空态且 cause 正确」

T3坏格式

输入:读数是坏格式 "0.42ppm" → 期望「输出未携带」

提示:点了「运行」变红的行,行本身就是红实例——点行体重听判红理由。

红实例

过滤条件写错,全列表走空态,页面平静地写「暂无数据」——最日常的假空。

判红
陆

律六 · DENOMINATOR

报数带计量基:百分比必须声明分母

同一张 2x 光栅,按设备像素与按 CSS px 积分,full%/eff45% 一升一降,两个读数都对——分母不同。tooltip 必须答得出「分母是什么」。

原 则

哪一批、哪一档、含不含未读格——分母说不清的百分比不构成信息。

落 法

答不出分母的百分比降级为装饰,删掉 %。点「查分母」:左卡成立、右卡当场降级。

组件实例 · 百分比双卡

计量基成立
68%

full% · 全栅读数覆盖

分母 = 512 格全栅(DPR=2,按设备像素计数),含 34 个未读格。✓ 计量基成立 · 保留 %

待查分母
95%

达标率 · 「看着很不错」

答不出分母:哪一批?哪一档?含不含未读格?——一个都答不上。按律降级:删 %,降为装饰

红实例

tooltip 答不出分母的「95% 达标」→ 按律降级为装饰,删掉 %。

判红
判红