安装 ¶
本ui库尽量使用 cli 脚手架模式
后续还有自动化部署打包
NPM方式 ¶
在项目根目录执行如下命令即可:
js
// 如果您的根目录没有package.json文件的话,请先执行如下命令:
// npm init -y
下载
sh
npm install @10yun/cv-mobile-ui -D
更新
sh
npm install @10yun/cv-mobile-ui -f
版本查询 ¶
有两种方式可以查询到正在使用的uView的版本:
js
// 通过`console.log`打印的形式
console.log(uni.$u.config.v);
// 可以查阅uView的配置文件得知当前版本号,具体位置为:
/uview-ui/libs/config/config.js
配置步骤 ¶
1. 引入uView主JS库 ¶
在项目src
目录中的main.js
中,引入并使用uView的JS库,注意这两行要放在import Vue
之后。
js
// main.js
import uView from "uview-ui";
Vue.use(uView)
2. 在引入uView的全局SCSS主题文件 ¶
在main.js
中的引入
在项目根目录的uni.css
中引入此文件。 在项目src
目录的uni.css
中引入此文件。
js
// main.js
import 'uview-ui/theme.css';
3. 引入uView基础样式 ¶
在App.vue
中首行的位置引入
css
<style>
@import "uview-ui/index.css";
</style>
4. 配置easycom组件模式 ¶
此配置需要在项目src
目录的pages.json
中进行配置。
温馨提示
- uni-app为了调试性能的原因,修改
easycom
规则不会实时生效,配置完后,您需要重启HX或者重新编译项目才能正常使用cv-mobile-ui
的功能。 - 请确保您的
pages.json
中只有一个easycom
字段,否则请自行合并多个引入规则。
json
// pages.json
{
// 如果您是通过uni_modules形式引入的,可以忽略此配置
"easycom": {
"autoscan": true,
"custom": {
"^cv-(.*)": "@10yun/cv-mobile-ui/ui-cv/components//cv-$1/cv-$1.vue",
"^up-(.*)": "@10yun/cv-mobile-ui/uview-plus/components/u-$1/u-$1.vue"
}
},
// 此为本身已有的内容
"pages": [
// ......
]
}
5. Cli模式额外配置 ¶
如果您是vue-cli
模式的项目,还需要在项目根目录
的vue.config.js
文件中进行如下配置:
js
// vue.config.js,如没有此文件则手动创建
module.exports = {
transpileDependencies: ['uview-ui']
}