前端组件纪律 · 六条可抄进组件库
空态六律
把「判不了」渲染成一等状态 —— 空值是被看见的状态,缺栏不是。
先红
每律皆可交互切 cause · 切口径 · 跑必红臂 · 点「判红」盖章 发布 2026-11-22
律一 · LACKING SLOT
缺栏不可挑战:槽先落、值可为「—」
错值有能被打掉的对象,缺栏连对象都没有——一格写着「—」的界面强于整栏不存在,因为前者你知道该问谁。
原 则
结构缺失与错值是两类问题。整栏不存在时,用户连「这里该有个数」都提不出来。
落 法
占位符三件套 = 槽位名 + 「—」 + 一句为什么空。禁止用条件渲染把整栏连同表头一起吃掉。
组件实例 · 本周读数表
| 样本 | 读数 | 量程 | 复检 |
|---|---|---|---|
| A-07 | 0.42 | 0–1.0 | 11-25 |
| A-08 | —为什么空:未到复检日 | 0–1.0 | 11-30 |
| B-03 | 0.19 | 0–0.5 | 11-27 |
「—」占位在槽里:该问谁、为什么空,都答得出来。
列头存在而数据缺位的格子,被 display:none 连坐隐藏——审查点名。
律二 · NULL TRIAGE
null 要分诊:四档四种按钮
「null」在 JSON 里长得一样,成因与处理动作相反——空态组件必须吃一个 cause 枚举,不许只有「暂无数据」。
原 则
未测量、测量失败、低于检出限、呈现层省略——四种空,四个相反的动作。
落 法
点下面四档切换 cause,看文案与主按钮怎么跟着换;把「测量失败」渲染成「暂无数据」,等于把仪器瞎记成内容病。
组件实例 · 空态分诊卡
槽位在,仪器还没开口——去测就有数。
喂 cause:"measurement_failed" 却渲染通用文案 → 判红。
律三 · THIRD STATE
UNKNOWN 是第三种状态,不许折进绿
「判不了」是可以公开的结论,伪造的绿不是。校验异常被 catch 后 return true,或 unknown 被 || 默认成 pass,都是折法。
原 则
三态枚举 pass / fail / unknown;unknown 渲染为灰或琥珀,计数上算 pending、不算通过。
落 法
校验器 C 会抛异常。切到「三态枚举」看灰章与 pending 计数;切到「|| 默认 pass」看伪绿怎么造出来。
组件实例 · 三校验器结果板
unknown 公开为灰章:判不了就说判不了,pending 不溜进通过率。
塞一个抛异常的校验器,断言结果不得是「通过」——伪绿即红。
律四 · PENDING OBJECT
挂起态带四字段,默认朝不通过一侧
挂起卡片必带:各来源判词 · 缺哪一层 · owner(谁负责补)· 复检截止。没有 owner 的 pending 一周后默认升级 fail。
原 则
默认值总偏向放行,所以默认必须朝不通过那一侧:无 owner 渲染「未指派 · 按未解决计」。
落 法
挂起徽章的 props 就是这四个字段;工单「待处理」不许从完成率分母里溜出去。
组件实例 · 挂起卡(双读数冲突)
- 判 词
- 两来源冲突:0.42 / 0.19,未定谳
- 缺哪层
- 缺复核层(第二来源读数)
- owner
- 大医(bot)
- 复检截止
- 2026-11-27
owner 在岗:到期未补复核,按未解决升级。
无 owner 无截止的 pending 卡,在周报里被算成「已解决」→ 判红。
律五 · RED ARM
空态也要过必红臂:三条测试
一条从不由红变绿的判据恒真、因而无信息。空态逻辑同样要喂负控:应判空但数据其实在 / 不该判空但数据为空,都必须能红。
原 则
过滤条件写错导致全列表走空态、页面却平静写「暂无数据」——这是最日常的假空。
落 法
逐条点「运行」看左臂变红;再切「负控已接入」看修复后怎么变绿。红臂 = 这条测试真能判红。
组件实例 · 空态负控三条
输入:A-08 在库,被过滤规则误伤 → 期望「显示数据」
输入:B-99 不存在 → 期望「空态且 cause 正确」
输入:读数是坏格式 "0.42ppm" → 期望「输出未携带」
提示:点了「运行」变红的行,行本身就是红实例——点行体重听判红理由。
过滤条件写错,全列表走空态,页面平静地写「暂无数据」——最日常的假空。
律六 · DENOMINATOR
报数带计量基:百分比必须声明分母
同一张 2x 光栅,按设备像素与按 CSS px 积分,full%/eff45% 一升一降,两个读数都对——分母不同。tooltip 必须答得出「分母是什么」。
原 则
哪一批、哪一档、含不含未读格——分母说不清的百分比不构成信息。
落 法
答不出分母的百分比降级为装饰,删掉 %。点「查分母」:左卡成立、右卡当场降级。
组件实例 · 百分比双卡
full% · 全栅读数覆盖
分母 = 512 格全栅(DPR=2,按设备像素计数),含 34 个未读格。✓ 计量基成立 · 保留 %
达标率 · 「看着很不错」
答不出分母:哪一批?哪一档?含不含未读格?——一个都答不上。按律降级:删 %,降为装饰
tooltip 答不出分母的「95% 达标」→ 按律降级为装饰,删掉 %。