high-mini/components/uni-ui

uni-ui产品特点

1. 高性能

目前为止，在小程序和混合app领域，暂时还没有比 uni-ui 更高性能的框架。

• 自动差量更新数据

虽然uni-app支持小程序自定义组件，所有小程序的ui库都可以用。但小程序自定义组件的ui库都需要使用setData手动更新数据，在大数据量时、或高频更新数据时，很容易产生性能问题。

而 uni-ui 属于vue组件，uni-app引擎底层自动diff更新数据。当然其实插件市场里众多vue组件都具备这个特点。

• 优化逻辑层和视图层通讯折损

非H5，不管是小程序还是App，不管是app的webview渲染还是原生渲染，全都是逻辑层和视图层分离的。这里就有一个逻辑层和视图层通讯的折损问题。 比如在视图层拖动一个可跟手的组件，由于通讯的损耗，用js监听很难做到实时跟手。

这时就需要使用css动画以及平台底层提供的wxs、bindingx等技术。不过这些技术都比较复杂，所以 uni-ui 里做了封装，在需要跟手式操作的ui组件，比如swiperaction列表项左滑菜单，就在底层使用了这些技术，实现了高性能的交互体验

• 背景停止

很多ui组件是会一直动的，比如轮播图、跑马灯。即便这个窗体被新窗体挡住，它在背景层仍然在消耗着硬件资源。在Android的webview版本为chrome66以上，背景操作ui会引发很严重的性能问题，造成前台界面明显卡顿。

而 uni-ui 的组件，会自动判断自己的显示状态，在组件不再可见时，不会再消耗硬件资源。

2. 全端

uni-ui 的组件都是多端自适应的，底层会抹平很多小程序平台的差异或bug。

比如导航栏navbar组件，会自动处理不同端的状态栏。 比如swiperaction组件，在app和微信小程序上会使用交互体验更好的wxs技术，但在不支持wxs的其他小程序端会使用js模拟类似效果。

未来 uni-ui 还会支持pc等大屏设备。

3. 与uni统计自动集成实现免打点

uni统计是优秀的多端统计平台，见tongji.dcloud.net.cn。

除了一张报表看全端，它的另一个重要特点是免打点。 比如使用 uni-ui 的navbar标题栏、收藏、购物车等组件，均可实现自动打点，统计页面标题等各种行为数据。 当然你也可以关闭uni统计，这不是强制的。

4. 主题扩展

uni-ui 支持uni.scss，可以方便的切换App的风格。

ui是一种需求非常发散的产品，DCloud官方也无意用 uni-ui 压制第三方ui插件的空间，但官方有义务在性能和多端方面提供一个开源的标杆给大家。

我们欢迎更多优秀的ui组件出现，也欢迎更多人贡献 uni-ui 的主题风格，满足更多用户的需求。

uni-ui 使用说明

方式1 (推荐)

HBuilderX 2.5.5起支持 easycom 组件模式。在使用 uni-ui 的时候，只要uni-ui 组件 安装在项目的 components 目录下,并符合 components/组件名称/组件名称.vue 目录结构。就可以不用引用、注册，直接在页面中使用 uni-ui 组件

easycom 组件模式的好处在于不管 components 目录下安装了多少组件，easycom 打包后会自动剔除没有使用的组件，对组件库的使用尤为友好,组件库批量安装，随意使用，自动按需打包。 关于 easycom 更详细内容 参考文档

方式2（vue-cli）

初始化项目

如果是使用 HBuiderX 创建的项目，需先执行以下命令初始化：

npm init -y

安装 uni-ui

npm i @dcloudio/uni-ui --save

npm i sass -D

npm i sass-loader -D

在 script 中引用组件：

例如我们需要导入 uni-badge 组件

import {uniBadge} from '@dcloudio/uni-ui'
export default {
    components: {uniBadge}
}

方式3（vue-cli + easycom）

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

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

// pages.json

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

uni-ui 已支持的组件列表

组件名	组件说明
uniBadge	数字角标
uniCalendar	日历
uniCard	卡片
uniCollapse	折叠面板
uniCombox	组合框
uniCountdown	倒计时
uniDataCheckbox	数据选择器
uniDateformat	日期格式化
uniDatetimePicker	日期格式化
uniDrawer	抽屉
uniEasyinput	增强输入框
uniFab	悬浮按钮
uniFav	收藏按钮
uniField	输入框
uniForms	表单
uniGoodsNav	商品导航
uniGrid	宫格
uniGroup	分组
uniIcons	图标
uniIndexedList	索引列表
uniLink	超链接
uniList	列表
uniLoadMore	加载更多
uniNavBar	自定义导航栏
uniNoticeBar	通告栏
uniNumberBox	数字输入框
uniPagination	分页器
uniPopUp	弹出层
uniRate	评分
uniSearchBar	搜索栏
uniSegmentedControl	分段器
uniSteps	步骤条
uniSwipeAction	滑动操作
uniSwiperDot	轮播图指示点
uniTable	表格
uniTag	标签
uniTitle	章节标题
uniTransition	过渡动画

其他

• uni-ui 是全端兼容的基于flex布局的、无dom的ui库
• uni-ui 是uni-app内置组件的扩展。注意与web开发不同，uni-ui不包括基础组件，它是基础组件的补充。web开发中有的开发者习惯用一个ui库完成所有开发，但在uni-app体系中，推荐开发者首先使用性能更高的基础组件，然后按需引入必要的扩展组件。
• uni-ui 不支持使用 Vue.use() 的方式安装
• uni-ui 依赖 scss，若是 HBuilderX 中创建的 uni-app 项目，需要在 HBuilderX 中安装 scss 插件；如果是使用 cli 创建的 uni-app 项目，需要在项目下npm安装 node-sass 和 sass-loader
• CLI 引用方式 H5 端不支持在 main.js 中全局注册组件，如有需求请使用 easyCom 的方式引用组件

贡献代码

在使用 uni-ui 中，如遇到无法解决的问题，请提 Issues 给我们，假如您有更好的点子或更好的实现方式，也欢迎给我们提交 PR