MOD.10 控件DOC-10-014AUTHOR · 苏砚2025-07-25READ · 4 MIN

颜色选择器的工程化裁剪

超数频控件视觉回归状态全集

这里再补一笔：这篇起源于一次组件库审计：24 个控件里，能说清自己全部状态的不到三成。团队把每个控件的状态机补全后，相关缺陷降了 37%——这就是状态全集的价值。

SEC.01实施步骤

有一条经验值得单独记录：每个控件要有一页「何时不该用我」：日期范围用两个选择器还是面板、视觉回归的选型边界写清楚，误用率下降后，定制需求也少了一半。

控件 API 的稳定性比功能丰富度重要：一次破坏性升级会击穿 24 个下游项目，所以项目组的主版本承诺三年不动，新能力全部走增量。

// CASE FILE · 实测档案

数据回溯：虚拟化下拉：千项数据打开 800ms→60ms，内存峰值 -64%。

有一条经验值得单独记录：实施的第一步一贯是摸清现状：把状态全集的存量清点成一张表，标注归属、状态和风险等级。这张表在后续三周里被本组翻旧了，比任何文档都常用。

另一个常被忽视的细节是：受控与非受控的铁律是「永远不要半受控」：要么值完全由外部驱动，要么完全自治，混合模式是无数诡异 bug 的病根。库里每个控件在文档首页声明自己的模式。

最后再记一笔：控件的可配置项要克制：每个 prop 都是长期负债，视觉回归的配置面超过 20 个之后，测试矩阵爆炸，文档没人能读完。少即是多在这里成立。

顺带记录一个细节：触控冗余全局统一：桌面最小 28px 高，触控最小 44px，同一控件用媒体查询切换尺寸档。状态全集的双档章法让一套代码同时过桌面评审和移动评审。

视觉回归测试用像素快照：每个控件八态截图，PR 里自动比对。发布后视觉回归的样式类回归缺陷拦截率 37%，设计师终于不用肉眼验收每一版了。

有一条经验值得单独记录：复盘文化比做法本身更重要：每次状态全集的线上问题都要求 48 小时内出复盘，聚焦流程漏洞而非个人责任。三年下来，同类问题的复发率降到个位数。

有一条经验值得单独记录：长期维护成本是选型时最容易被轻视的变量：一个功能强大的方案可能带来每天 24 分钟的维护负担，一年下来就是足足一周的人力，值得在对齐会上算这笔账。

这里再补一笔：文档用例化指的是：每个控件的文档页就是可交互的 demo 加参数表，示例代码可直接复制。状态全集的文档站日均访问量比内网任何工具都高，这是好用的证明。