This commit is contained in:
2026-04-19 22:20:57 +08:00
parent ef1aebb209
commit 96280c2e79
759 changed files with 0 additions and 0 deletions

View File

@@ -0,0 +1,110 @@
## 1.3.12021-05-14
- uni-badge 新增 uni-badge 的 absolute 属性,支持定位
- uni-badge 新增 uni-badge 的 offset 属性,支持定位偏移
- uni-badge 新增 uni-badge 的 is-dot 属性,支持仅显示有一个小点
- uni-badge 新增 uni-badge 的 max-num 属性,支持自定义封顶的数字值,超过 99 显示99+
- uni-badge 优化 uni-badge 属性 custom-style 支持以对象形式自定义样式
- uni-badge 修复 uni-badge 在 App 端数字小于10时不是圆形的bug
- uni-badge 修复 uni-badge 在父元素不是 flex 布局时宽度缩小的bug
- uni-badge 新增 uni-badge 属性 custom-style 支持自定义样式
- uni-datetime-picker 修复 ios 下不识别 '-' 日期格式的 bug
- uni-datetime-picker 优化 pc 下弹出层添加边框和阴影
- uni-datetime-picker 修复 在 admin 中获取弹出层定位错误的bug
- uni-datetime-picker 修复 type 属性向下兼容,默认值从 date 变更为 datetime
- uni-datetime-picker 支持日历形式的日期+时间的范围选择
- uni-steps 修复 uni-steps 横向布局时,多行文字高度不合理的 bug
- uni-countdown 修复 uni-countdown 不能控制倒计时的 bug
- uni-tag 修复 royal 类型无效的bug
- uni-tag 修复 uni-tag 宽度不自适应的bug
- uni-tag 新增 uni-tag 支持属性 custom-style 自定义样式
- uni-link 新增 href 属性支持 tel:|mailto:
- uni-popup 修复 组件内放置 input 、textarea 组件,无法聚焦的问题
- uni-popup 新增 type 属性的 left\right 值,支持左右弹出
- uni-popup 新增 open(String:type) 方法参数 ,可以省略 type 属性 ,直接传入类型打开指定弹窗
- uni-popup 新增 backgroundColor 属性,可定义主窗口背景色,默认不显示背景色
- uni-popup 新增 safeArea 属性,是否适配底部安全区
- uni-popup 修复 App\h5\微信小程序底部安全区占位不对的Bug
- uni-popup 修复 App 端弹出等待的Bug
- uni-popup 优化 提升低配设备性能,优化动画卡顿问题
- uni-popup 优化 更简单的组件自定义方式
- uni-table 修复 示例项目缺少组件的Bug
- uni-forms 修复 自定义检验器失效的问题
- uni-title 修复 示例项目缺少组件的Bug
- uni-transition 修复 示例项目缺少组件的Bug
- uni-swiper-dot 修复 示例项目缺少组件的Bug
- uni-ui 新增 组件示例地址
## 1.3.02021-04-23
- uni-combox 优化 添加依赖 uni-icons, 导入后自动下载依赖
- uni-data-picker 修复 非树形数据有 where 属性查询报错的问题
- uni-fav 优化 添加依赖 uni-icons, 导入后自动下载依赖
- uni-goods-nav 优化 添加依赖 uni-icons, 导入后自动下载依赖
- uni-nav-bar 优化 添加依赖 uni-icons, 导入后自动下载依赖
- uni-notice-bar 优化 添加依赖 uni-icons, 导入后自动下载依赖
- uni-number-box 修复 uni-number-box 浮点数运算不精确的 bug
- uni-number-box 修复 uni-number-box change 事件触发不正确的 bug
- uni-number-box 新增 uni-number-box v-model 双向绑定
- uni-rate 修复 布局变化后 uni-rate 星星计算不准确的 bug
- uni-rate 优化 添加依赖 uni-icons, 导入 uni-rate 自动下载依赖
- uni-search-bar 优化 添加依赖 uni-icons, 导入后自动下载依赖
- uni-steps 优化 添加依赖 uni-icons, 导入后自动下载依赖
- uni-transition 新增 通过方法自定义动画
- uni-transition 新增 custom-class 非 NVUE 平台支持自定义 class 定制样式
- uni-transition 优化 动画触发逻辑,使动画更流畅
- uni-transition 优化 支持单独的动画类型
- uni-transition 优化 文档示例
## 1.2.132021-04-16
- uni-ui 新增 uni-data-picker 支持云端非树形表结构数据
- uni-ui 修复 uni-data-checkbox nvue 下无法选中的问题
- uni-ui 修复 uni-data-picker 根节点 parent_field 字段等于null时选择界面错乱问题
- uni-ui 修复 uni-file-picker 选择的文件非 file-extname 字段指定的扩展名报错的Bug
- uni-ui 修复 uni-swipe-action 报错 nv_navigator is not defined 的bug
- uni-ui 修复 uni-load-more 在首页使用时h5 平台报 'uni is not defined' 的 bug
- uni-ui 优化 uni-file-picker file-extname 字段支持字符串写法,多个扩展名需要用逗号分隔
- uni-ui 优化 uni-pagination PC 和 移动端适配不同的 ui
- uni-ui 更新 uni-file-picker 组件示例
- uni-ui 修复 uni-nav-bar 当 fixed 属性为 true 时铺不满屏幕的 bug
- uni-ui 新增 uni-search-bar 的 focus 事件
- uni-ui 修复 uni-rate 属性 margin 值为 string 组件失效的 bug
- uni-data-picker 修复 本地数据概率无法回显时问题
- uni-table 新增 sortable 属性,是否开启单列排序
- uni-table 优化 表格多选逻辑
## 1.2.122021-03-23
- uni-ui 新增 uni-datetime-picker 的 hide-second 属性、border 属性;
- uni-ui 修复 uni-datetime-picker 选择跟显示的日期不一样的 bug
- uni-ui 修复 uni-datetime-picker change事件触发2次的 bug
- uni-ui 修复 uni-datetime-picker 分、秒 end 范围错误的 bug
- uni-ui 新增 uni-tr selectable 属性,用于 type=selection 时,设置某行是否可由全选按钮控制
- uni-ui 新增 uni-data-checkbox 新增 disabled属性支持nvue
- uni-ui 优化 uni-data-checkbox 无选项时提示“暂无数据”
- uni-ui 优化 uni-data-checkbox 默认颜色显示
- uni-ui 新增 uni-link href 属性支持 tel:|mailto:
- uni-ui 新增 uni-table 示例demo
- uni-ui 修复 uni-data-picker 微信小程序某些情况下无法选择的问题,事件无法触发的问题
- uni-ui 修复 uni-nav-bar easycom 下,找不到 uni-status-bar 的bug
- uni-ui 修复 uni-easyinput 示例在 qq 小程序上的bug
- uni-ui 修复 uni-forms 动态显示uni-forms-item的情况下submit 方法获取值错误的Bug
- uni-ui 调整 cli 项目 建议使用 easycom 方式引用组件,如使用按需引用,需手动维护组件内部引用
## 1.2.112021-02-24
- 调整为uni_modules目录规范
- uni-data-picker 新增 数据驱动的picker选择器
- uni-file-picker 新增 文件选择上传
- uni-row 新增 栅格系统
- uni-data-checkbox 优化 支持 nvue
- uni-forms 修复 偶发性获取表单值错误的Bug
- uni-forms 修复 校验 uni-data-picker value 为 0 时返回值错误的Bug
- uni-forms 修复 uni-forms-item 组件隐藏时依然触发校验的bug
- uni-forms 优化 实时校验
- uni-forms 优化 兼容nvue页面
- uni-easyinput 优化 兼容nvue页面
- uni-group 优化 兼容nvue页面
- uni-popup 优化 组件适配 PC
- uni-fab 优化 适配 PC
- uni-swiper-dot 优化 适配 PC
- uni-rate 优化 适配 PC
- uni-notice-bar 优化 适配 PC
- uni-indexed-list 优化 适配 PC
- uni-combox 优化 适配 PC
- uni-transition 优化 适配 PC
- uni-nav-bar 优化 适配 PC
- uni-swipe-action 优化 适配 PC

View File

@@ -0,0 +1,7 @@
<template>
<view>占位组件请勿使用</view>
</template>
<script>
</script>
<style>
</style>

View File

@@ -0,0 +1,125 @@
{
"id": "uni-ui",
"displayName": "uni-ui",
"version": "1.3.1",
"description": "基于 uni-app 的 UI 组件库",
"keywords": [
"uni-ui",
"uniui",
"",
"UI组件库",
"ui框架",
"ui库"
],
"repository": "https://github.com/dcloudio/uni-ui",
"engines": {
"HBuilderX": ""
},
"directories": {
"example": "../../temps/example_temps"
},
"dcloudext": {
"category": [
"前端组件",
"通用组件"
],
"sale": {
"regular": {
"price": "0.00"
},
"sourcecode": {
"price": "0.00"
}
},
"contact": {
"qq": ""
},
"declaration": {
"ads": "无",
"data": "无",
"permissions": "无"
},
"npmurl": "https://www.npmjs.com/package/@dcloudio/uni-ui"
},
"uni_modules": {
"dependencies": [
"uni-badge",
"uni-calendar",
"uni-card",
"uni-collapse",
"uni-combox",
"uni-countdown",
"uni-data-checkbox",
"uni-data-picker",
"uni-dateformat",
"uni-datetime-picker",
"uni-drawer",
"uni-easyinput",
"uni-fab",
"uni-fav",
"uni-file-picker",
"uni-forms",
"uni-goods-nav",
"uni-grid",
"uni-group",
"uni-icons",
"uni-indexed-list",
"uni-link",
"uni-list",
"uni-load-more",
"uni-nav-bar",
"uni-notice-bar",
"uni-number-box",
"uni-pagination",
"uni-popup",
"uni-rate",
"uni-row",
"uni-search-bar",
"uni-segmented-control",
"uni-steps",
"uni-swipe-action",
"uni-swiper-dot",
"uni-table",
"uni-tag",
"uni-title",
"uni-transition"
],
"encrypt": [],
"platforms": {
"cloud": {
"tcb": "y",
"aliyun": "y"
},
"client": {
"App": {
"app-vue": "y",
"app-nvue": "y"
},
"H5-mobile": {
"Safari": "y",
"Android Browser": "y",
"微信浏览器(Android)": "y",
"QQ浏览器(Android)": "y"
},
"H5-pc": {
"Chrome": "y",
"IE": "y",
"Edge": "y",
"Firefox": "y",
"Safari": "y"
},
"小程序": {
"微信": "y",
"阿里": "y",
"百度": "y",
"字节跳动": "y",
"QQ": "y"
},
"快应用": {
"华为": "u",
"联盟": "u"
}
}
}
}
}

View File

@@ -0,0 +1,228 @@
# 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` 还支持nvue原生渲染[详见](https://github.com/dcloudio/uni-ui/tree/nvue-uni-ui)
未来 `uni-ui` 还会支持pc等大屏设备。
### 3. 与uni统计自动集成实现免打点
uni统计是优秀的多端统计平台见[tongji.dcloud.net.cn](https://tongji.dcloud.net.cn)。
除了一张报表看全端,它的另一个重要特点是免打点。
比如使用 `uni-ui` 的navbar标题栏、收藏、购物车等组件均可实现自动打点统计页面标题等各种行为数据。
当然你也可以关闭uni统计这不是强制的。
### 4. 主题扩展
`uni-ui` 支持[uni.scss](https://uniapp.dcloud.io/collocation/uni-scss)可以方便的切换App的风格。
ui是一种需求非常发散的产品DCloud官方也无意用 `uni-ui` 压制第三方ui插件的空间但官方有义务在性能和多端方面提供一个开源的标杆给大家。
我们欢迎更多优秀的ui组件出现也欢迎更多人贡献 `uni-ui` 的主题风格,满足更多用户的需求。
# 快速开始
## 方式一:使用 uni_modules 安装(推荐)
使用 `uni_modules` 方式安装组件库,可以直接通过插件市场导入,通过右键菜单快速更新组件,不需要引用、注册,直接在页面中使用 `uni-ui` 组件。[点击安装 uni-ui 组件库](https://ext.dcloud.net.cn/plugin?id=55)
**注意:下载最新的组件目前仅支持 uni_modules ,非 uni_modules 版本最高支持到组件的1.2.10版本**
如不能升级到 `uni_modules` 版本,可以使用 `uni_modules` 安装好对应组件,将组件拷贝到对应目录。
例如需更新 `uni-list``uni-badge` ,将 `uni_modules>uni-list>components``uni_modules>uni-badege>components`下所有目录拷贝到如下目录即可:
**目录示例**
```json {2,3,4,5,6,7}
┌─components 组件目录
│ ├─uni-list list 列表目录
│ │ └─uni-list.vue list 组件文件
│ ├─uni-list-item list-item 列表目录
│ │ └─uni-list-item.vue list 组件文件
│ ├─uni-badge badge 角标目录
│ │ └─uni-badge.vue badge 组件文件
│ └─ //.... 更多组件文件
├─pages 业务页面文件存放的目录
│ ├─index
│ │ └─index.vue index示例页面
├─main.js Vue初始化入口文件
├─App.vue 应用配置用来配置App全局样式以及监听 应用生命周期
├─manifest.json 配置应用名称、appid、logo、版本等打包信息详见
└─pages.json 配置页
```
## 方式二:使用 npm 安装
在 `vue-cli` 项目中可以使用 `npm` 安装 `uni-ui` 库 ,或者直接在 `HBuilderX` 项目中使用 `npm` 。(不推荐后一种方式)
**准备 sass**
`vue-cli` 项目请先安装 sass 及 sass-loader如在 HBuliderX 中使用,可跳过此步。
- 安装 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
```
> sass-loader 请使用低于 @11.0.0 的版本,[sass-loader@11.0.0 不支持 vue@2.6.12 ](https://stackoverflow.com/questions/66082397/typeerror-this-getoptions-is-not-a-function)
**安装 uni-ui**
```
npm i @dcloudio/uni-ui 或 yarn add @dcloudio/uni-ui
```
在 ``script`` 中引用组件:
```javascript
import {uniBadge} from '@dcloudio/uni-ui'
//import uniBadge from '@dcloudio/uni-ui/lib/uni-badge/uni-badge.vue' //也可使用此方式引入组件
export default {
components: {uniBadge}
}
```
在 ``template`` 中使用组件:
```html
<uni-badge text="1"></uni-badge>
<uni-badge text="2" type="success" @click="bindClick"></uni-badge>
<uni-badge text="3" type="primary" :inverted="true"></uni-badge>
```
> **注意**
> - `CLI` 引用方式, `H5` 端不支持在 `main.js` 中全局注册组件,如有需求请使用([easyCom](https://uniapp.dcloud.io/collocation/pages?id=easycom) 的方式引用组件
> - 使用 npm 安装的组件,默认情况下 babel-loader 会忽略所有 node_modules 中的文件 ,导致条件编译失效,需要通过配置 `vue.config.js` 解决:
> ```javascript
> // 在根目录创建 vue.config.js 文件,并配置如下
> module.exports = {
> transpileDependencies: ['@dcloudio/uni-ui']
> }
> ```
## 使用 npm + easycom
使用 `npm` 安装好 `uni-ui` 之后,需要配置 `easycom` 规则,让 `npm` 安装的组件支持 `easycom`
打开项目根目录下的 `pages.json` 并添加 `easycom` 节点:
```javascript {8}
// pages.json
{
"easycom": {
"autoscan": true,
"custom": {
// uni-ui 规则如下配置
"^uni-(.*)": "@dcloudio/uni-ui/lib/uni-$1/uni-$1.vue"
}
},
// 其他内容
pages:[
// ...
]
}
```
### uni-ui 已支持的组件列表
|组件名|组件说明|
|---|---|
|uni-badge|[数字角标](https://ext.dcloud.net.cn/plugin?name=uni-badge)|
|uni-calendar|[日历](https://ext.dcloud.net.cn/plugin?name=uni-calendar)|
|uni-card|[卡片](https://ext.dcloud.net.cn/plugin?name=uni-card)|
|uni-collapse|[折叠面板](https://ext.dcloud.net.cn/plugin?name=uni-collapse)|
|uni-combox|[组合框](https://ext.dcloud.net.cn/plugin?name=uni-combox)|
|uni-countdown|[倒计时](https://ext.dcloud.net.cn/plugin?name=uni-countdown)|
|uni-data-checkbox|[数据选择器](https://ext.dcloud.net.cn/plugin?name=uni-data-checkbox)|
|uni-data-picker|[数据驱动的picker选择器](https://ext.dcloud.net.cn/plugin?name=uni-data-picker)|
|uni-dateformat|[日期格式化](https://ext.dcloud.net.cn/plugin?name=uni-dateformat)|
|uni-datetime-picker|[日期选择器](https://ext.dcloud.net.cn/plugin?name=uni-datetime-picker)|
|uni-drawer|[抽屉](https://ext.dcloud.net.cn/plugin?name=uni-drawer)|
|uni-easyinput|[增强输入框](https://ext.dcloud.net.cn/plugin?name=uni-easyinput)|
|uni-fab|[悬浮按钮](https://ext.dcloud.net.cn/plugin?name=uni-fab)|
|uni-fav|[收藏按钮](https://ext.dcloud.net.cn/plugin?name=uni-fav)|
|uni-file-picker|[文件选择上传](https://ext.dcloud.net.cn/plugin?name=uni-file-picker)|
|uni-forms|[表单](https://ext.dcloud.net.cn/plugin?name=uni-forms)|
|uni-goods-nav|[商品导航](https://ext.dcloud.net.cn/plugin?name=uni-goods-nav)|
|uni-grid|[宫格](https://ext.dcloud.net.cn/plugin?name=uni-grid)|
|uni-group|[分组](https://ext.dcloud.net.cn/plugin?name=uni-group)|
|uni-icons|[图标](https://ext.dcloud.net.cn/plugin?name=uni-icons)|
|uni-indexed-list|[索引列表](https://ext.dcloud.net.cn/plugin?name=uni-indexed-list)|
|uni-link|[超链接](https://ext.dcloud.net.cn/plugin?name=uni-link)|
|uni-list|[列表](https://ext.dcloud.net.cn/plugin?name=uni-list)|
|uni-load-more|[加载更多](https://ext.dcloud.net.cn/plugin?name=uni-load-more)|
|uni-nav-bar|[自定义导航栏](https://ext.dcloud.net.cn/plugin?name=uni-nav-bar)|
|uni-notice-bar|[通告栏](https://ext.dcloud.net.cn/plugin?name=uni-notice-bar)|
|uni-number-box|[数字输入框](https://ext.dcloud.net.cn/plugin?name=uni-number-box)|
|uni-pagination|[分页器](https://ext.dcloud.net.cn/plugin?name=uni-pagination)|
|uni-popup|[弹出层](https://ext.dcloud.net.cn/plugin?name=uni-popup)|
|uni-rate|[评分](https://ext.dcloud.net.cn/plugin?name=uni-rate)|
|uni-row|[布局-行](https://ext.dcloud.net.cn/plugin?name=uni-row)|
|uni-search-bar|[搜索栏](https://ext.dcloud.net.cn/plugin?name=uni-search-bar)|
|Section|[标题栏](https://ext.dcloud.net.cn/plugin?name=uni-section)|
|uni-segmented-control|[分段器](https://ext.dcloud.net.cn/plugin?name=uni-segmented-control)|
|uni-steps|[步骤条](https://ext.dcloud.net.cn/plugin?name=uni-steps)|
|uni-swipe-action|[滑动操作](https://ext.dcloud.net.cn/plugin?name=uni-swipe-action)|
|uni-swiper-dot|[轮播图指示点](https://ext.dcloud.net.cn/plugin?name=uni-swiper-dot)|
|uni-table|[表格](https://ext.dcloud.net.cn/plugin?name=uni-table)|
|uni-tag|[标签](https://ext.dcloud.net.cn/plugin?name=uni-tag)|
|uni-title|[章节标题](https://ext.dcloud.net.cn/plugin?name=uni-title)|
|uni-transition|[过渡动画](https://ext.dcloud.net.cn/plugin?name=uni-transition)|
### 其他
- uni-ui 是全端兼容的基于flex布局的、无dom的ui库
- uni-ui 是uni-app内置组件的扩展。注意与web开发不同uni-ui不包括基础组件它是基础组件的补充。web开发中有的开发者习惯用一个ui库完成所有开发但在uni-app体系中推荐开发者首先使用性能更高的基础组件然后按需引入必要的扩展组件。
> **注意**
> - `uni-ui` 不支持使用 `Vue.use()` 的方式安装
### 贡献代码
在使用 `uni-ui` 中,如遇到无法解决的问题,请提 [Issues](https://github.com/dcloudio/uni-ui/issues) 给我们,假如您有更好的点子或更好的实现方式,也欢迎给我们提交 [PR](https://github.com/dcloudio/uni-ui/pulls)