在uni-app中引入和使用uViewUI

心已赠人 2023-02-27 10:38 1阅读 0赞

# uni-app 引入uViewUI #

uViewUI在HBuilder X的插件市场：[https://ext.dcloud.net.cn/plugin?id=1593][https_ext.dcloud.net.cn_plugin_id_1593]  
uViewUI官方地址：[https://uviewui.com/][https_uviewui.com]

# 1、npm 安装或者更新uViewUI #

## 1.1、安装 ##

// 安装
    npm install uview-ui

## 1.2、更新 ##

已经安装想更新版本可以使用

//更新
    npm update uview-ui

## 1.3、查看版本号 ##

有两种方式可以查询到正在使用的uView的版本：

通过console.log打印的形式

console.log(this.$u.config.v);
    
    // 或者(二者等价)
    console.log(this.$u.config.version);

通过源码查看的形式  
可以查阅uView的配置文件得知当前版本号，具体位置为"/uview-ui/libs/config/config.js"。

# 2、npm 安装方式的配置 #

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

## 2.1、HBuilderX工具中要安装scss插件： HX菜单的 工具->插件安装中找到"scss/sass编译"插件进行安装 ##

## 在插件市场直接导入：[https://ext.dcloud.net.cn/plugin?id=2046][https_ext.dcloud.net.cn_plugin_id_2046] ##

*注：插件市场不支持IE跳转，建议用谷歌浏览器*

如果您的项目是由vue-cli创造的，请通过以下命令安装对sass（scss）的支持，如果已安装，请略过。

// 安装node-sass
    npm i node-sass -D
     
    // 安装sass-loader
    npm i sass-loader -D

# 3、对相关文件进行配置 #

## 3.1、在main.js 文件全局引入uView ##

// main.js 文件
    import uView from "uview-ui";
    Vue.use(uView);

## 3.2、uni.scss 文件 引入uView的全局SCSS主题文件 ##

/* uni.scss 文件 引入uView的全局SCSS主题文件 */
    @import 'uview-ui/theme.scss';

## 3.3、在App.vue文件引入uView基础样式 ##

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

# 4、全局引入和按需加载 #

## 4.1、全局引入 ##

在pages.json配置easycom

*注：uni-app为了调试性能的原因，修改easycom规则不会实时生效，配置完后，您需要重启HX或重新编译项目才能正常使用uView的功能。  
请确保您的pages.json中只有一个easycom分区，否则请自行合并多个约会规则。*

// pages.json
    { 
    	"easycom": { 
    		"^u-(.*)": "uview-ui/components/u-$1/u-$1.vue"
    	},
    	// 此为本身已有的内容
    	"pages": [
    		// ......
    	]
    }

## 4.2、按需加载 ##

某些情况下，您可能不想通过easycom引用组件（虽然我们极力推荐您使用easycom），那么您可以使用import这个常规的约会方式，如下：

<template>
    	<u-action-sheet :list="list" v-model="show"></u-action-sheet>
    </template>
    
    <script>
    	import uActionSheet from "uView-ui/components/u-action-sheet/u-action-sheet.vue";
    	export default { 
    		components: { 
    			uActionSheet
    		},
    		data() { 
    			return { 
    				list: [{ 
    					text: '点赞',
    					color: 'blue',
    					fontSize: 28
    				}, { 
    					text: '分享'
    				}, { 
    					text: '评论'
    				}],
    				show: true
    			}
    		}
    	}
    </script>

[https_ext.dcloud.net.cn_plugin_id_1593]: https://ext.dcloud.net.cn/plugin?id=1593
[https_uviewui.com]: https://uviewui.com/
[https_ext.dcloud.net.cn_plugin_id_2046]: https://ext.dcloud.net.cn/plugin?id=2046