大家好我是不如摸鱼去wot-ui 的主要维护者。Wot UI 2.2.0 正式发布啦。这次更新依然不是那种“把整个组件库翻一遍”的大版本但很适合日常项目直接升级体验。它主要补了两类内容一类是组件能力继续往前走比如Button新增了subtle变体、VideoPreview支持全屏预览另一类是一些真实场景里会踩到的细节问题比如隐藏表单项校验、支付宝小程序Tabs渲染顺序、Toast图标行高异常等。如果你已经在用 Wot UI v2这个版本值得跟上。Button 新增 subtle 类型变体先说一个很直观的更新Button现在新增了subtle变体。之前按钮已经支持base、plain、dashed、soft、text等几种表现形式但在一些场景里大家想要的其实是一种“比soft更克制一点、又比纯描边更柔和一点”的视觉效果。2.2.0 把这个空位补上了。现在你可以直接这样写wd-button variantsubtle主要按钮/wd-button这个变体比较适合这些场景页面里需要弱化操作层级但又不想完全退成文字按钮列表页、卡片页里需要保留按钮轮廓感一组按钮里希望主次关系更自然一些如果你之前是靠自定义样式去拼这种效果那现在可以直接用官方变体了组件语义也会更统一。VideoPreview 支持全屏预览这次我自己比较关注的另一个更新是VideoPreview的预览体验增强。从 2.2.0 开始wd-video-preview和useVideoPreview都支持全屏预览能力了。对于竖屏视频、展示型视频内容或者你就是希望用户点开以后直接沉浸式查看这个能力会顺手很多。比如函数式调用时可以直接传入fullScreenimport{useVideoPreview}from/uni_modules/wot-uiconst{previewVideo}useVideoPreview()functionopenPreview(){previewVideo({url:https://unpkg.com/wot-design-uni-assets1.0.3/VID_115503.mp4,title:全屏视频,fullScreen:true,closePosition:right-top})}如果你更习惯组件式写法也可以直接在组件上声明wd-video-preview full-screen /这次更新不只是“多了一个参数”这么简单。针对 App 端的原生video全屏播放场景内部也补了一层处理逻辑尽量规避原生视频同层渲染带来的遮挡问题。对使用者来说最直接的感受就是视频预览终于更像“视频预览”了而不只是一个普通弹层里塞了个 video。Form 隐藏字段不再误触发校验这次还有一个很实用的修复来自表单场景。之前如果某个wd-form-item是通过v-if控制显示隐藏即使它已经没渲染出来只要校验schema里还保留着这个字段它依然可能影响validate()的结果。这在动态表单里会比较难受。明明用户看不到那个字段也没法填写但提交时却可能被它卡住。2.2.0 修复了这个问题。现在的行为会更符合直觉通过 v-if 卸载的表单项不再参与当前校验结果 重新显示后再重新参与校验也就是说动态增减表单项的体验会更稳定业务上也更容易控制。尤其是那种“根据开关、身份、配置项决定是否显示字段”的页面这个修复会省掉不少额外判断。其他问题也一起修了除了上面几个比较明显的变化2.2.0 还顺手修了一批使用体验问题修复Toast图标设置图标大小后行高异常的问题修复支付宝小程序Tabs子组件渲染顺序错误的问题修复文档中自动导入示例代码的问题这些更新单看都不算“大新闻”但都属于真实项目里会碰到、碰到了就挺烦的问题。一个个补掉之后整体体验会顺很多。文档也同步补齐了配合这次版本文档侧也补上了几块内容Button文档新增subtle变体说明VideoPreview/useVideoPreview文档补充了全屏预览、关闭按钮位置等配置Form文档新增隐藏字段校验说明和示例如果你刚好在做动态表单、视频预览或者页面交互风格统一建议顺手看一下最新文档。如何升级到 2.2.0如果你已经在项目中使用 Wot UI可以把package.json中的wot-ui/ui版本更新到2.2.0{dependencies:{wot-ui/ui:2.2.0}}然后重新安装依赖pnpminstall如果你希望直接更新也可以执行pnpmaddwot-ui/ui2.2.0使用 npm 的项目可以执行npminstallwot-ui/ui2.2.0对已有项目来说重点不是重新安装组件库而是把当前项目中的wot-ui/ui版本升级到2.2.0。最后Wot UI 2.2.0 是一次很典型的“看起来不夸张但升级以后会觉得更顺手”的版本。它主要带来了几件事Button新增subtle变体按钮层级表达更丰富VideoPreview支持全屏预览视频展示体验更完整Form修复隐藏字段仍参与校验的问题动态表单更符合直觉同步修复Toast、支付宝小程序Tabs和文档示例中的一些细节问题如果你的项目已经在使用 Wot UI v2可以直接升级到 2.2.0 试试看。也欢迎大家继续反馈真实使用场景和问题我们会继续把这些“小而关键”的体验一点点补齐。相关资源Wot UI 文档https://wot-ui.cn/Wot UI 仓库https://github.com/wot-ui/wot-ui版本对比https://github.com/wot-ui/wot-ui/compare/v2.1.0…v2.2.0