Skip to content

(二)引入uni-ui

uni-ui是uniapp官方的一套ui框架。它用起来还算趁手,美观度一般般吧,比起第三方ui框架,跨平台适配性最高。

因为我这两次H5的开发都是使用VSCode,所以下面的方法是针对vue-cli构建的引用步骤。

https://uniapp.dcloud.net.cn/component/uniui/quickstart.html

按需引入

进入组件的插件时长,点击下载。得到zip包以后,将里面的内容拷贝到uni_modules文件夹下即可。

刚刚创建的项目可能没有这个文件夹,需要自行创建。

有一个偷懒的方法,就是通过HBX一键导入。这是我唯一使用HBX的时候。

除了uni-ui的组件,第三方组件也要放到uni_modules文件夹下。

全量引入

如果想一次把所有uni-ui组件导入到项目中,只需要导入一个uni-ui组件即可点击去导入。

如果没有自动导入其他组件,可以在 uni-ui 组件目录上右键选择 安装三方插件依赖即可。

npm安装

首先,需要在根目录创建 vue.config.js文件 ,增加 @dcloudio/uni-ui包的编译即可正常,否则报错。

js
// vue.config.js
module.exports = {
		transpileDependencies:['@dcloudio/uni-ui']
}

准备sass

npm i sass -D   yarn add sass -D

和sass-loader

npm i sass-loader@10.1.1 -D   yarn add sass-loader@10.1.1 -D

最后安装 uni-ui

npm i @dcloudio/uni-ui   yarn add @dcloudio/uni-ui

配置easycom

使用 npm 安装好 uni-ui 之后,需要配置 easycom 规则,让 npm 安装的组件支持 easycom

打开项目根目录下的 pages.json 并添加 easycom 节点:

json
// pages.json
{
	"easycom": {
		"autoscan": true,
		"custom": {
			// uni-ui 规则如下配置
			"^uni-(.*)": "@dcloudio/uni-ui/lib/uni-$1/uni-$1.vue"
		}
	},
}

引入后就可以愉快滴使用ui框架了。

easycom

vue原生开发,引用组件的时候需要先 import,然后在components中声明,然后才能使用。

uniapp开发中,可以用easycom这个内置工具省掉注册和声明这两个步骤,直接用组件。

使用的条件是,组件按照特定的命名方式,放到components里(或uni_modules)

如果出现报错,可能有两个原因:

  1. 没有下载这个插件(在用uni_ui的时候出现过)
  2. 组件没有按规则命名
  3. 第三方组件可能需要额外配置

Released under the MIT License.