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

一、创建uniapp空白项目

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

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

二、NPM安装uView2.x

注意: 此安装方式项目名称不能有中文字符。

在项目根目录执行如下命令即可:

// 如果您的根目录没有package.json文件的话,请先执行如下命令:
// npm init -y
npm install uview-ui@2.0.37
// 更新
// npm update uview-uicopy



执行完成后,项目目录中增加了目录“node_modules”和文件“package.json” ,如图:

三、配置

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"属性 */ 
@import "uview-ui/index.scss";

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": [// ......]
}

四、测试

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

保存并运行,如图:

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

测试成功完成。