更新记录

1.2.10(2020-12-18)

  • uni-easyinput 修复 校验返回值与实际返回值不一致的问题
  • uni-easyinput 新增 styles 属性,可以自定义部分样式
  • uni-easyinput 新增 图标点击事件
  • uni-forms 修复 不设置 label 属性的时候 errorMessage 位置错误的问题
  • uni-list 修复 uni-list-chat 扩展组件角标显示不正常的问题
  • uni-dateformat 修复 iOS 平台日期格式化出错的问题
  • uni-data-checkbox 修复 异步获取数据渲染失败的Bug
  • uni-data-checkbox 修复 支付宝小程序端报错且显示不正常的Bug
  • uni-data-checkbox 修复 z-index 错误的Bug
  • uni-data-checkbox 优化 兼容属性 disabled
  • uni-indexed-list 修复 easyCom 模式下,找不到子组件的问题

1.2.9(2020-12-04)

  • uni-easyinput 修复 校验返回值与实际返回值不一致的问题
  • uni-forms 修复 不设置 label 属性的时候 errorMessage 位置错误的问题
  • uni-list 修复 uni-list-chat 扩展组件角标显示不正常的问题
  • uni-dateformat 修复 iOS 平台日期格式化出错的问题
查看更多

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 的组件,会自动判断自己的显示状态,在组件不再可见时,不会再消耗硬件资源。

  1. 全端

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

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

uni-ui 还支持nvue原生渲染,详见

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

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

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

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

  1. 主题扩展

    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

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问