![]()
uView框架
uView框架
uView2.0是继
1.0以来的一次重大更新，2.0已全面兼容nvue，为了这个最初的梦想，我们曾日以夜继，挑灯夜战，闻鸡起舞。您能看到屏幕上的字，却看不到我们洒在键盘上的泪。uView来源于社区，也回归到社区，正是有一群热爱
uni-app生态的同学推着它前行，而我们也一如既往的承诺，uView永久开源，永远免费。
NPM方式-安装
//在项目根目录执行如下命令即可：
// 如果您的根目录没有package.json文件的话，请先执行如下命令：
// npm init -y
npm install uview-ui@2.0.31
// 更新
// npm update uview-ui
NPM安装方式-配置
uView依赖SCSS，您必须要安装此插件，否则无法正常运行。
- 如果您的项目是由
HBuilder X创建的，相信已经安装scss插件，如果没有，请在HX菜单的 工具->插件安装中找到"scss/sass编译"插件进行安装， 如不生效，重启HX即可- 如果您的项目是由vue-cli创建的，请通过以下命令安装对sass(scss)的支持，如果已安装，请略过。
// 安装sass
npm i sass -D
// 安装sass-loader，注意需要版本10，否则可能会导致vue与sass的兼容问题而报错
npm i sass-loader@10 -D
NPM安装-准备工作
在进行配置之前，请确保您已经根据安装中的步骤对uView进行了npm安装，如果没有，请先执行安装：
// 如果您的项目是HX创建的，根目录又没有package.json文件的话，请先执行如下命令：
// npm init -y
// 安装
npm install uview-ui@2.0.31
NPM-配置步骤
1. 引入uView主JS库
在项目
src目录中的main.js中，引入并使用uView的JS库，注意这两行要放在import Vue之后。
// main.js
import uView from "uview-ui";
Vue.use(uView);
2. 在引入uView的全局SCSS主题文件
在项目
src目录的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组件模式
此配置需要在项目
src目录的pages.json中进行。温馨提示
- uni-app为了调试性能的原因，修改
easycom规则不会实时生效，配置完后，您需要重启HX或者重新编译项目才能正常使用uView的功能。- 请确保您的
pages.json中只有一个easycom字段，否则请自行合并多个引入规则。
// pages.json
{
"easycom": {
"^u-(.*)": "uview-ui/components/u-$1/u-$1.vue"
},
// 此为本身已有的内容
//默认生成，无需导入
"pages": [
// ......
]
}
5. Cli模式额外配置
如果您是
vue-cli模式的项目，还需要在项目根目录的vue.config.js文件中进行如下配置：
// vue.config.js，如没有此文件则手动创建
module.exports = {
transpileDependencies: ['uview-ui']
}
版本查询
//有两种方式可以查询到正在使用的uView的版本：
// 通过`console.log`打印的形式
console.log(uni.$u.config.v);
// 可以查阅uView的配置文件得知当前版本号，具体位置为：
/uview-ui/libs/config/config.js
作者：前端阿力 维吾尔族程序员
