uni-app vue-cli项目 uView安装及配置
一、说明
uView安装有下载安装和npm安装两种方式,使用的是npm安装。
二、步骤
1、安装SCSS
uView依赖SCSS,您必须要安装此插件,否则无法正常运行。
// 安装node-sass
npm i node-sass -D
// 安装sass-loader
npm i sass-loader -D
2、对uView进行npm安装
// 安装
npm install uview-ui
3、引入uView主JS库
在项目根目录中的main.js中,引入并使用uView的JS库,注意这两行要放在import Vue之后。
// main.js
import uView from "uview-ui";
Vue.use(uView);
4、引入uView的全局SCSS主题文件
在项目根目录的uni.scss中引入此文件。
/ uni.scss /
@import 'uview-ui/theme.scss';
5、在App.vue中引入uView基础样式
<style lang="scss">
/* 注意要写在第一行,同时给style标签加入lang="scss"属性 */
@import "uview-ui/index.scss";
</style>
6、配置easycom组件模式
此配置需要在项目根目录的pages.json中进行。uni-app为了调试性能的原因,修改easycom规则不会实时生效,配置完后,重新编译项目才能正常使用uView的功能。
// pages.json
{
"easycom": {
"^u-(.*)": "uview-ui/components/u-$1/u-$1.vue"
},
// 此为本身已有的内容
"pages": [
// ......
]
}
遇到问题:
执行完上面的步骤后,重新编译时报错。
解决问题:
经过排查,应该是sass-loader的版本过高问题。在package.json文件中修改sass-loader,从12.x.x(忘记具体是多少了)改成10.1.0,执行npm install安装依赖,然后重新编译项目,编译成功,可正常使用uView组件。
// package.json
"node-sass": "^6.0.1",
"sass-loader": "^10.1.0", // 修改后
记录于2021/09/03。
本作品采用 知识共享署名-相同方式共享 4.0 国际许可协议 进行许可。
经过排查,应该是sass-loader的版本过高问题。在package.json文件中修改sass-loader,从12.x.x(忘记具体是多少了)改成10.1.0,执行npm install安装依赖,然后重新编译项目,编译成功,可正常使用uView组件。