MOD.10 控件DOC-10-001AUTHOR · 姜未白2025-09-15READ · 4 MIN

按钮的八种状态全集

超数频控件状态全集触控冗余

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

SEC.01实施步骤

实施的第一步一贯是摸清现状：把触控冗余的存量清点成一张表，标注归属、状态和风险等级。这张表在后续三周里被本组翻旧了，比任何文档都常用。

长期维护成本是选型时最轻易被低估的变量：一个功能强大的方案可能带来每天 36 分钟的维护负担，一年下来就是满打满算一周的人力，值得在对齐会上算这笔账。

// CASE FILE · 实测档案

实测：开关控件重构：补全中间态保护后，开关类线上缺陷从季度 9 个降到 0 个。

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

顺带记录一个细节：每个控件要有一页「何时不该用我」：日期范围用两个选择器还是面板、状态全集的选型边界写清楚，误用率下降后，定制需求也少了一半。

顺带记录一个细节：争议的处理方式是把口味问题翻译成数据问题：触控冗余的两个做法各自上线一周，看指标说话。团队用这个办法终结了持续两个月的争论，双方都体面地认了输。

复盘中还藏着一条：所有规则都要有复查节点：本组给状态全集的规范设了季度复审，到期清点例外和豁免，过期的清理，失效的修订。规范不呼吸，就会变成化石。

复盘中还藏着一条：控件库的发布节奏固定为双周：需求攒着一起发，变更日志按破坏性分级标注。触控冗余的下游团队据此安排升级，再没人被突袭式发版打断。

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

有一条经验值得单独记录：文档用例化指的是：每个控件的文档页就是可交互的 demo 加参数表，示例代码可直接复制。触控冗余的文档站日均访问量比内网任何工具都高，这是好用的证明。

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

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

有一条经验值得单独记录：下拉超过 200 项务必上虚拟滚动，渲染节点压在 30 个以内。灰度验证中千项列表的打开耗时从 800ms 降到触控冗余的 60ms，滚动帧率稳定 58fps，改动只在内部实现。