参考:官方文档-NPM安装方式配置
不知道为什么,Hbuilder X方式安装不了
npm方式安装
// 如果您的根目录没有package.json文件的话,请先执行如下命令:
// npm init -y
//npm install uview-ui@2.0.31 //指定安装的版本
npm install uview-ui
// 更新
// npm update uview-ui
配置步骤
1. 引入uView主JS库
在项目src
目录中的main.js
中,引入并使用uView的JS库,注意这两行要放在import Vue
之后。
// main.js
import uView from "uview-ui";
Vue.use(uView);
2. 在引入uView的全局SCSS主题文件
在项目src
目录的uni.scss
中引入此文件。
/* uni.scss */
@import 'uview-ui/theme.scss';
3. 引入uView基础样式
注意:在App.vue中首行的位置引入,注意给style标签加入lang=”scss”属性
<style lang="scss">
/* 注意要写在第一行,同时给style标签加入lang="scss"属性 */
@import "uview-ui/index.scss";
</style>
4. 配置easycom组件模式
此配置需要在项目src
目录的pages.json
中进行。
温馨提示
- uni-app为了调试性能的原因,修改easycom规则不会实时生效,配置完后,您需要重启HX或者重新编译项目才能正常使用uView的功能。
请确保您的pages.json中只有一个easycom字段,否则请自行合并多个引入规则。
// pages.json
{
"easycom": {
"^u-(.*)": "uview-ui/components/u-$1/u-$1.vue"
},
// 此为本身已有的内容
"pages": [
// ......
]
}
修改uView内置配置方案 2.0.25
我们可以通过setCofig方法配置uView内部的各项内置配置,目前可配置的有config、props、zIndex、color属性,目前只建议修改config、props属性, 除非您清楚知道自己的修改所带来的影响。
// main.js
import uView from 'uview-ui'
Vue.use(uView)
// 调用setConfig方法,方法内部会进行对象属性深度合并,可以放心嵌套配置
// 需要在Vue.use(uView)之后执行
uni.$u.setConfig({
// 修改$u.config对象的属性
config: {
// 修改默认单位为rpx,相当于执行 uni.$u.config.unit = 'rpx'
unit: 'rpx'
},
// 修改$u.props对象的属性
props: {
// 修改radio组件的size参数的默认值,相当于执行 uni.$u.props.radio.size = 30
radio: {
size: 15
}
// 其他组件属性配置
// ......
}
})