uView是uni-app生态专用的UI框架,uni-app 是一个使用 Vue.js 开发所有前端应用的框架,开发者编写一套代码, 可发布到iOS、Android、H5、以及各种小程序(微信/支付宝/百度/头条/QQ/钉钉)等多个平台(引言自uni-app网)


一、创建uniapp空白项目

项目名testUview2,使用vue2,如图:

点击‘创建’后,项目创建成功,目录结构如图:

二、下载安装

1、安装uView2.0

如果您是使用Hbuilder X开发的用户,您可以在uni-app插件市场通过uni_modules的形式进行安装,此安装方式可以方便您后续在uni_modules对uView进行一键升级。

插件地址:https://ext.dcloud.net.cn/plugin?id=1593

通过浏览器找到找到插件,如图:


点击‘下载插件并导入HBuilderX’会弹框提示,选择‘打开HBuilderX’, 如图:

 

这时会弹出关联项目,确定插件关联到刚刚创建的项目,点击‘确定’,如图:

项目中增加了目录‘uni_modules’,这个时候就已经安装完成,如图:

2、安装SCSS

uView依赖SCSS,您必须要安装此插件,否则无法正常运行。

如果您的项目是由HBuilder X创建的,相信已经安装scss插件,如果没有,请在HX菜单的 工具->插件安装中找到"scss/sass编译"插件进行安装, 如不生效,重启HX即可。

插件地址:https://ext.dcloud.net.cn/plugin?id=2046

安装过程和安装uView类似,这里省略。查看安装是否成功,如图:

三、配置

1. 引入uView主JS库

在项目根目录中的main.js中,引入并使用uView的JS库,注意这两行要放在import Vue之后。

// main.js
import uView from '@/uni_modules/uview-ui'
Vue.use(uView)

2. 在引入uView的全局SCSS主题文件

/* uni.scss */
@import '@/uni_modules/uview-ui/theme.scss';

3. 引入uView基础样式

注意!在App.vue中首行的位置引入,注意给style标签加入lang="scss"属性
/* 注意要写在第一行,同时给style标签加入lang="scss"属性 */ 
@import "@/uni_modules/uview-ui/index.scss";

4. 配置easycom组件模式(注意:如果您是通过uni_modules形式引入uView,可以忽略此配置)

温馨提示
uni-app为了调试性能的原因,修改easycom规则不会实时生效,配置完后,您需要重启HX或者重新编译项目才能正常使用uView的功能。
请确保您的pages.json中只有一个easycom字段,否则请自行合并多个引入规则。
如果您是通过uni_modules形式引入uView,可以忽略此配置
// pages.json
{
    // 如果您是通过uni_modules形式引入uView,可以忽略此配置
    "easycom": {
        "^u-(.*)": "@/uni_modules/uview-ui/components/u-$1/u-$1.vue"
    },
    // 此为本身已有的内容
    "pages": [// ......]
}

四、测试

修改首页,增加一个按钮,如图:

保存并运行,如图:

运行成功并正常展示按钮,如图:

测试成功完成。