介绍
@silver-formily/vue 是对官方的 @formily/vue 的一次重新封装,主要为了解决官方依赖中由于需要兼容 Vue2 所引入的 vue-demi vue-frag等依赖。同时也消除了兼容 Vue2 渲染时产生的额外的 template 标签和使用display: content样式包裹的div标签。display: content并不能解决所有的样式问题。精简后的代码当然也具有更好的可读性,易于维护。
详细的指南请参考官方文档,若精力允许会考虑重写指南。接口部分除了 重大改动 之外也几乎未做改动,本文档仅提供更好的阅读体验。
重大改动
@formily/vue对入参和事件的映射是value/onChange这样的设计对 react 默认行为的对齐。现在通过 Vue3 重构后入参的事件改为了modelValue/onUpdate:modelValue触发。对于大部分Vue3的组件库中的大部分组件,无需额外的封装即可满足最基础的使用。
提示
如果你还没有做好升级的准备,可以使用 @silver-formily/vue 的 1.x 版本。这是一个与 @formily/vue 的 API 完全对齐的版本。
@silver-formily/vue移除了对 Schema 的导出,请从@formily/json-schema导入。