注意事项

特别说明

使用组件前务必先阅读注意事项，避免开发中遇到各种问题。尽量少走弯路！

组件属性传值问题

组件属性必须严格按照类型传值，务必参考文档标注的类型传入对应类型的值。

属性传值注意事项：

• Number类型： 如 :size=“24”，不可直接写成 size=“24”，前面务必加上冒号。

• Boolean类型：如 :disabled=“true” ，不可直接写成 disabled 或者 disabled=“true” 等，不支持简写或者传入其他类型。

• 所有组件 props属性 类型为 Number 的请传入数字，如字体大小、宽度、高度等，这些属性如果为 Number 类型传入值时不可带单位，且必须传入Number类型值，如果类型为 String，则需要自行带单位。

必须引入的文件

组件内有内置文件必须引入，当按需使用部分组件时，务必查看对应组件文档，尤其是温馨提示内容，看是否需要导入其他依赖文件。

必须导入的文件：

• fui-types：组件内props属性参数、事件回调参数、方法参数类型 文件。

• fui-lang：组件内置国际化文件，如果对应组件有配置，需要同时引入。

• fui-icon：字体图标组件，该组件可能会内置使用到其他组件内部，使用时注意查看文档。

编译报错

如果编译报错，可以查看出错原因是否提示的很清楚，常见问题排查如下：

编译报错排查：

• 请确保您下载的Hbuilder X 为APP开发版，而非标准版，且版本需要更新至 Hbuilder X 3.9.9+， 并且在"工具-插件安装"中安装了"scss/sass编译"插件 以及 uts 编译相关插件。

• 仔细检查组件属性传参是否有问题，不可传入不同类型值。

• 查看组件示例，对比写法是否有问题。

组件示例预览问题

说明

目前文档展示的为web端预览，app端可下载 apk文件 (opens new window) 进行安装预览。

Web端发行后uts中部分uni api无法使用

发行后报错问题

目前支持使用的API详见 文档 (opens new window)，部分API如果使用报错，可能尚未进行适配 或为 uniapp官方 bug。