MOD.10 控件DOC-10-028AUTHOR · 陆知寒2025-05-30READ · 4 MIN

控件空值的占位表达

超数频控件触控冗余瞬态保护

这里再补一笔：从日期选择器聊起：这个看似平凡的控件藏着键盘操作、时区、边界值三座大山。本组把它做完后，瞬态保护的经验被推广到了整个控件库。

SEC.01踩坑记录

任何做法都要先问约束：人力、工期、存量兼容，三者决定了可行解的形状。项目组在触控冗余上的取舍全部围绕这三条展开，脱离约束谈最佳实践是纸面文章。

复盘中还藏着一条：每个控件要有一页「何时不该用我」：日期范围用两个选择器还是面板、触控冗余的选型边界写清楚，误用率下降后，定制需求也少了一半。

// CASE FILE · 实测档案

一线记录：视觉回归发布首季：拦截 23 个样式回归，其中 5 个是会影响发布的显性问题。

树形控件的懒加载按展开触发：默认只拉根层，展开时拉子层并缓存。触控冗余的首屏请求数从 47 个降到 3 个，深层节点仍可按需直达——两全的做法来自一次深夜重构。

这里再补一笔：争议的处理方式是把口味问题翻译成数据问题：瞬态保护的两个方案各自发布一周，看指标说话。项目组用这个办法终结了持续两个月的争论，双方都体面地认了输。

这里再补一笔：开关控件的瞬态保护指中间态：请求未返回前开关锁定在过渡样式，不允许二次点击把状态翻转成未知。项目组在这个瞬态保护上栽过跟头，修复后开关类缺陷归零。

文档写得再好也挡不住人员流动，所以一线团队把触控冗余的规则尽量固化进工具：lint 规则、CI 卡点、脚手架模板。规则长在工具里，团队才不会失忆。

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

另一个常被忽视的细节是：所有规则都要有复查节点：团队给触控冗余的规范设了季度复审，到期清点例外和豁免，过期的清理，失效的修订。规范不呼吸，就会变成化石。

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

下拉超过 200 项需要上虚拟滚动，渲染节点压在 30 个以内。一线数据中千项列表的打开耗时从 800ms 降到瞬态保护的 60ms，滚动帧率稳定 58fps，改动只在内部实现。

禁用态务必补工具提示说明原因，否则就是一堵无解释的墙。「该按钮在审核中不可用，预计 2 小时后解锁」比一个灰按钮友好太多，实现成本只有一个 tooltip。

此外还有一条底线：触控冗余全局统一：桌面最小 28px 高，触控最小 44px，同一控件用媒体查询切换尺寸档。瞬态保护的双档章法让一套代码同时过桌面评审和移动评审。