- 1、新建项目
- a、首先下载HBuilderX
- b、使用HBuilderX 创建uniapp 项目
- 2、设置项目名称、目录
- 3、下载uView UI
- 已下载安装为例
- 4、安装scss
- 5、配置步骤
- a、 引入uView主JS库
- b、在引入uView的全局SCSS主题文件
- c、引入uView基础样式
- d、配置easycom组件模式
- 6、 运行项目
- a、缺少AppID报错
- 添加AppID
- 使用一下uView UI组件
- 代码示例
- 效果图
1、新建项目
a、首先下载HBuilderX
HBuilderX:官方IDE下载地址
b、使用HBuilderX 创建uniapp 项目
uni-app:uni-app官网
2、设置项目名称、目录
3、下载uView UI
官网地址:uView UI 官网 下载地址:uView UI下载
uView UI 目前分为下载安装和npm安装两种,各有利弊具体区别看官网
已下载安装为例
a、在uni-app插件市场右上角选择使用HBuilder X 导入插件或者下载插件ZIP
b、如果您的项目是由HBuilder X创建的标准uni-app项目,将下载后的uview-ui文件夹(现在是uni_modules了),复制到项目根目录。
c、如果您的项目是由vue-cli模式创建的, 请将下载后的uview-ui文件夹放到项目的src文件夹中即可。
最终目录结构如下:
4、安装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
5、配置步骤
a、 引入uView主JS库
在项目根目录中的main.js中,引入并使用uView的JS库,注意这两行要放在import Vue之后。
// main.js
import uView from "uview-ui";
Vue.use(uView);
b、在引入uView的全局SCSS主题文件
在项目根目录的uni.scss中引入此文件。
/* uni.scss */
@import 'uview-ui/theme.scss';
c、引入uView基础样式
在App.vue中首行的位置引入,注意给style标签加入lang="scss"属性
<style lang="scss">
/* 注意要写在第一行,同时给style标签加入lang="scss"属性 */
@import "uview-ui/index.scss";
</style>
d、配置easycom组件模式
此配置需要在项目根目录的pages.json中进行。
uni-app为了调试性能的原因,修改easycom规则不会实时生效,配置完后,您需要重启HX或者重新编译项目才能正常使用uView的功能。
请确保您的pages.json中只有一个easycom字段,否则请自行合并多个引入规则。
// 注意地址,写实际uview所在地址
// pages.json
{
"easycom": {
"^u-(.*)": "@/uview-ui/components/u-/u-.vue"
},
// 此为本身已有的内容
"pages": [
// ......
]
}
6、 运行项目
ok,到这里就可以正常运行啦!一起启动一下!!
a、缺少AppID报错
添加AppID
如图添加AppID (AppID去开发者工具中申请获取)
使用一下uView UI组件
编辑pages/index/index 文件
代码示例
<template>
<view class="home-wrap">
<div class="btn-box" >
<u-button @click="show = true">选择时间</u-button>
</div>
<u-picker v-model="show" mode="time"></u-picker>
</view>
</template>
<script>
export default {
data() {
return {
show :false
}
}
}
</script>
<style lang="scss" scoped>
.home-wrap{
.btn-box{
width: 200rpx;
margin: 100rpx auto;
}
}
</style>
效果图