MOD.10 控件DOC-10-002AUTHOR · 闻人诀2025-09-11READ · 4 MIN

开关控件的瞬态保护

超数频控件可访问性瞬态保护

这里再补一笔：控件是设计系统的弹药库。本文讨论的不是怎么画控件，而是怎么让可访问性在 36 个项目里被标准地使用：版本章法、文档形态、回归保障，一条链讲完。

SEC.01性能策略

灰度是工程做法的安全网：先放 5% 流量观察关键指标，任何劣化超过基线 5% 立即回滚。可访问性的那次灰度让团队在凌晨两点避免了一次全量事故。

最后再记一笔：受控与非受控的信条是「始终不要半受控」：要么值完全由外部驱动，要么完全自治，混合模式是无数诡异 bug 的起点。库里每个控件在文档首页声明自己的模式。

// CASE FILE · 实测档案

档案记录：下拉虚拟化：千项数据打开 800ms→60ms，用户「卡死」反馈消失。

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

组合控件的解耦信条：一个控件只做一件事，复杂表单靠组合而非继承。搜索框不带下拉逻辑，下拉不带过滤逻辑，可访问性的每个零件都可单独测试和替换。

补充一条实战观察：控件的主题化靠 CSS 变量注入而非样式覆盖：瞬态保护的换肤做法如果依赖选择器优先级，就会在下一个版本被实现细节反噬。

有一条经验值得单独记录：触控冗余全局统一：桌面最小 28px 高，触控最小 44px，同一控件用媒体查询切换尺寸档。瞬态保护的双档打法让一套代码同时过桌面评审和移动评审。

这里再补一笔：所有规则都要有复查节点：本组给可访问性的规范设了季度复审，到期清点例外和豁免，过期的清理，失效的修订。规范不呼吸，就会变成化石。

复盘文化比做法本身更重要：每次瞬态保护的线上问题都要求 48 小时内出复盘，聚焦流程漏洞而非个人责任。三年下来，同类问题的复发率降到个位数。

另一个常被忽视的细节是：文档用例化指的是：每个控件的文档页就是可交互的 demo 加参数表，示例代码可直接复制。瞬态保护的文档站日均访问量比内网任何工具都高，这是好用的证明。

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

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

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