前端学习交流QQ群:1群:173683895 ,2群: 173683866
承接项目开发,需求功能开发,博主微信号:Jay_09168
uView是uni-app生态优秀的UI框架
安装说明
-
由于uView使用
easycom
模式,让您无需引入组件即可直接使用,但是此功能需要Hbuilder X 2.5.5及以上版本才支持,详见配置easycom组件模式。easycom
打包的时候是按需引入的,您可以放心引入uView的整个组件库,发布打包时会自动剔除您没有使用的组件(注意:调试时仍然是全部引入的) -
请确保您下载的Hbuilder X (opens new window)为
APP开发版
,而非标准版
,并且在"工具-插件安装"中安装了"scss/sass编译"插件
npm安装方式配置
#关于SCSS
uView依赖SCSS,您必须要安装此插件,否则无法正常运行。
-
如果您的项目是由
HBuilder X
创建的,相信已经安装scss插件,如果没有,请在HX菜单的 工具->插件安装中找到"scss/sass编译"插件进行安装, 如不生效,重启HX即可 -
如果您的项目是由vue-cli创建的,请通过以下命令安装对sass(scss)的支持,如果已安装,请略过。
// 安装node-sass
npm i node-sass -D// 安装sass-loader
npm i sass-loader -D
#准备工作
在进行配置之前,请确保您已经根据安装中的步骤对uView进行了npm安装,如果没有,请先执行安装:
// 如果您的项目是HX创建的,根目录又没有package.json文件的话,请先执行如下命令:
// npm init -y
// 安装
npm install uview-ui@1.8.8
#配置步骤
#1. 引入uView主JS库
在项目根目录中的main.js
中,引入并使用uView的JS库,注意这两行要放在import Vue
之后。
// main.js
import uView from "uview-ui";
Vue.use(uView);
#2. 在引入uView的全局SCSS主题文件
在项目根目录的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组件模式
此配置需要在项目根目录的pages.json
中进行。
温馨提示
-
uni-app为了调试性能的原因,修改
easycom
规则不会实时生效,配置完后,您需要重启HX或者重新编译项目才能正常使用uView的功能。 -
请确保您的
pages.json
中只有一个easycom
字段,否则请自行合并多个引入规则。// pages.json
{
"easycom": {
"^u-(.*)": "uview-ui/components/u-$1/u-$1.vue"
},// 此为本身已有的内容 "pages": [ // ...... ]
}