WeUI组件库简介
这是一套基于样式库weui-wxss开发的小程序扩展组件库,同微信原生视觉体验一致的UI组件库,由微信官方设计团队和小程序团队为微信小程序量身设计,令用户的使用感知更加统一。
微信官方文档提供两种方式引入组件
1、 通过 useExtendedLib 扩展库 的方式引入,这种方式引入的组件将不会计入代码包大小。
2、 可以通过npm方式下载构建,npm包名为weui-miniprogram
推荐使用useExtendedLib 扩展库的方式引入
一、【useExtendedLib】
注意:前提是APPID是真实有效的,游客模式只能npm导入。
第一步
在小程序根目录的app.json里添加:
"useExtendedLib": {
"weui": true
},
第二步
在需要使用weui的页面引入,首先在页面的 json 文件加入 usingComponents 配置字段:
{
"usingComponents": {
"mp-icon": "weui-miniprogram/icon/icon"
}
}
在对应页面的 wxml 中直接使用该组件:
<mp-icon icon="add" color="green" size="{{26}}"></mp-icon>
编译即可看到图片!
注意事项
1、weui-miniprogram/icon/icon 前面不要加miniprogram_npm、components等等
2、需要使用真实APPID,游客模式新建的项目都会报错。
编译报错
Failed to load resource: the server responded with a status of 500 (Internal Server Error)(env: Windows,mp,1.05.2108130; lib: 2.19.2)
如果没有登录,是游客模式进入的,APPID是虚拟的,刚开启就会报错:
"useExtendedLib": {
"weui": true
},
Error: Component is not found in path "miniprogram_npm/weui-miniprogram/icon/icon" (using by "pages/person/info")
at e (VM72 WAService.js:2)APPID是虚拟的,引用不到WeUI。
二、【npm方式】
因为需要npm下载组件库,需要nodeJS环境,先去命令行查看是否已安装node,npm是否可用:
npm --version
如果没有安装,请去 Node.js 安装配置
第一步
命令行到项目文件夹下,运行:
npm install --save weui-miniprogram
这时项目文件夹下多了个node_modules
第二步
在微信开发者工具的“工具”菜单 --> “构建 npm”,项目文件夹下就多了个miniprogram_npm文件夹,这时node_modules可用删除掉了。
第三步
在需要使用weui的页面引入,首先在页面的 json 文件加入 usingComponents 配置字段:
{
"usingComponents": {
"mp-icon": "weui-miniprogram/icon/icon"
}
}
在对应页面的 wxml 中直接使用该组件:
<mp-icon icon="add" color="green" size="{{26}}"></mp-icon>
编译即可看到图片!
PS:
微信官方文档说要在根目录app.wxss 里面引入 weui.wxss:
@import 'weui-miniprogram/weui-wxss/dist/style/weui.wxss';
但是我没有引入也没有报错,使用的icon也能正常显示出来。
三、【直接导入miniprogram_npm】
第一步
将其他人已经构建npm的miniprogram_npm文件夹,拷贝到项目目录下。(文末有下载地址)
第二步
在需要使用weui的页面引入,首先在页面的 json 文件加入 usingComponents 配置字段:
{
"usingComponents": {
"mp-icon": "weui-miniprogram/icon/icon"
}
}
在对应页面的 wxml 中直接使用该组件:
<mp-icon icon="add" color="green" size="{{26}}"></mp-icon>
编译即可看到图片!
miniprogram_npm压缩包,百度云盘:
链接:https://pan.baidu.com/s/1bjKo1Y8dOmJFb2xHtpBq0A
提取码:9fm3