Skip to content

注意事项

由于 uni-app具备出色的多端开发支持能力,然而各端,尤其是不同的小程序平台,缺乏统一的标准规范,这无疑给开发者和企业带来了额外的成本负担,增加了开发的复杂度与资源投入。所幸的是,uni-app采用了Vue标准,实现了各端写法的统一,为开发工作带来了极大的便利,有力地推动了整个生态的蓬勃发展。不过,受部分小程序平台自身特性的制约,仍然不可避免地会出现一些兼容性问题。为了助力广大uni-app开发者更好地应对这些问题,我们特意将在制作fusions - ui过程中所遭遇的,以及平日里收集到的兼容性问题,悉心整理并呈现在本专题之中,希望能帮助到uni-app开发者。

其他一些开发中遇到的问题,后期在问题汇总里面持续更新。

VUE3注意

vue3 下 ref 不可以等于组件名,比如 fu-popup 组件 ref 不能为 fuPopup 或 fupopup

customStyle样式

我们在大部分组件上提供了一个 customStyle 属性,推荐用户可以用对象形式传递样式给组件内部,可以轻松的修改组件的宽度、边框、背景颜色等样式。

有效控制组件宽度

除了上面的 customStyle 可以修改外,如果需要修改组件的整体宽度,可以在组件外层套一个 view 标签,控制它的宽度就行。

安装组件后为什么在微信小程序无法正常解析?

如果你在安装组件之前就运行了项目,那么在安装配置好后,需要重新启动项目。

以微信小程序为例:关闭微信编辑器,最好是删除一次 unpackage 文件,然后重新运行项目,一般就可正常运行。

如果不这样做,很有可能存在缓存,你怎么刷新都没用。

微信小程序

注意

微信小程序基础库需要设置在2.19.2及以上

支付宝小程序

注意

fusions-ui需要开启了 component2 模式才支持支付宝小程序

  • 支付宝在很早前,已升级为 component2 模式,此模式支持更多的功能和特性,uni-app上,很多的特性,如provide/inject、$slots等,需要开启此模式才能支持, 而此模式在uni-app新建项目中默认是关闭的,因而需要在项目根目录的manifest.json中开启,如没有alipay属性节点,新增即可:
json
......
"mp-alipay" : {
    "component2": true
},
......