@@ -0,0 +1,33 @@
+## 1.2.2(2023-01-28)
+- 修复 运行/打包 控制台警告问题
+## 1.2.1(2022-09-05)
+- 修复 当 text 超过 max-num 时,badge 的宽度计算是根据 text 的长度计算,更改为 css 计算实际展示宽度,详见:[https://ask.dcloud.net.cn/question/150473](https://ask.dcloud.net.cn/question/150473)
+## 1.2.0(2021-11-19)
+- 优化 组件UI,并提供设计资源,详见:[https://uniapp.dcloud.io/component/uniui/resource](https://uniapp.dcloud.io/component/uniui/resource)
+- 文档迁移,详见:[https://uniapp.dcloud.io/component/uniui/uni-badge](https://uniapp.dcloud.io/component/uniui/uni-badge)
+## 1.1.7(2021-11-08)
+- 优化 升级ui
+- 修改 size 属性默认值调整为 small
+- 修改 type 属性,默认值调整为 error,info 替换 default
+## 1.1.6(2021-09-22)
+- 修复 在字节小程序上样式不生效的 bug
+## 1.1.5(2021-07-30)
+- 组件兼容 vue3,如何创建vue3项目,详见 [uni-app 项目支持 vue3 介绍](https://ask.dcloud.net.cn/article/37834)
+## 1.1.4(2021-07-29)
+- 修复 去掉 nvue 不支持css 的 align-self 属性,nvue 下不暂支持 absolute 属性
+## 1.1.3(2021-06-24)
+- 优化 示例项目
+## 1.1.1(2021-05-12)
+- 新增 组件示例地址
+## 1.1.0(2021-05-12)
+- 新增 uni-badge 的 absolute 属性,支持定位
+- 新增 uni-badge 的 offset 属性,支持定位偏移
+- 新增 uni-badge 的 is-dot 属性,支持仅显示有一个小点
+- 新增 uni-badge 的 max-num 属性,支持自定义封顶的数字值,超过 99 显示99+
+- 优化 uni-badge 属性 custom-style, 支持以对象形式自定义样式
+## 1.0.7(2021-05-07)
+- 修复 uni-badge 在 App 端,数字小于10时不是圆形的bug
+- 修复 uni-badge 在父元素不是 flex 布局时,宽度缩小的bug
+- 新增 uni-badge 属性 custom-style, 支持自定义样式
+## 1.0.6(2021-02-04)
+- 调整为uni_modules目录规范
@@ -0,0 +1,268 @@
+<template>
+ <view class="uni-badge--x">
+ <slot />
+ <text v-if="text" :class="classNames" :style="[positionStyle, customStyle, dotStyle]"
+ class="uni-badge" @click="onClick()">{{displayValue}}</text>
+ </view>
+</template>
+
+<script>
+ /**
+ * Badge 数字角标
+ * @description 数字角标一般和其它控件(列表、9宫格等)配合使用,用于进行数量提示,默认为实心灰色背景
+ * @tutorial https://ext.dcloud.net.cn/plugin?id=21
+ * @property {String} text 角标内容
+ * @property {String} size = [normal|small] 角标内容
+ * @property {String} type = [info|primary|success|warning|error] 颜色类型
+ * @value info 灰色
+ * @value primary 蓝色
+ * @value success 绿色
+ * @value warning 黄色
+ * @value error 红色
+ * @property {String} inverted = [true|false] 是否无需背景颜色
+ * @property {Number} maxNum 展示封顶的数字值,超过 99 显示 99+
+ * @property {String} absolute = [rightTop|rightBottom|leftBottom|leftTop] 开启绝对定位, 角标将定位到其包裹的标签的四角上
+ * @value rightTop 右上
+ * @value rightBottom 右下
+ * @value leftTop 左上
+ * @value leftBottom 左下
+ * @property {Array[number]} offset 距定位角中心点的偏移量,只有存在 absolute 属性时有效,例如:[-10, -10] 表示向外偏移 10px,[10, 10] 表示向 absolute 指定的内偏移 10px
+ * @property {String} isDot = [true|false] 是否显示为一个小点
+ * @event {Function} click 点击 Badge 触发事件
+ * @example <uni-badge text="1"></uni-badge>
+ */
+ export default {
+ name: 'UniBadge',
+ emits: ['click'],
+ props: {
+ type: {
+ type: String,
+ default: 'error'
+ },
+ inverted: {
+ type: Boolean,
+ default: false
+ isDot: {
+ maxNum: {
+ type: Number,
+ default: 99
+ absolute: {
+ default: ''
+ offset: {
+ type: Array,
+ default () {
+ return [0, 0]
+ }
+ text: {
+ type: [String, Number],
+ size: {
+ default: 'small'
+ customStyle: {
+ type: Object,
+ return {}
+ data() {
+ return {};
+ computed: {
+ width() {
+ return String(this.text).length * 8 + 12
+ classNames() {
+ const {
+ inverted,
+ type,
+ size,
+ absolute
+ } = this
+ return [
+ inverted ? 'uni-badge--' + type + '-inverted' : '',
+ 'uni-badge--' + type,
+ 'uni-badge--' + size,
+ absolute ? 'uni-badge--absolute' : ''
+ ].join(' ')
+ positionStyle() {
+ if (!this.absolute) return {}
+ let w = this.width / 2,
+ h = 10
+ if (this.isDot) {
+ w = 5
+ h = 5
+ const x = `${- w + this.offset[0]}px`
+ const y = `${- h + this.offset[1]}px`
+ const whiteList = {
+ rightTop: {
+ right: x,
+ top: y
+ rightBottom: {
+ bottom: y
+ leftBottom: {
+ left: x,
+ leftTop: {
+ const match = whiteList[this.absolute]
+ return match ? match : whiteList['rightTop']
+ dotStyle() {
+ if (!this.isDot) return {}
+ return {
+ width: '10px',
+ minWidth: '0',
+ height: '10px',
+ padding: '0',
+ borderRadius: '10px'
+ displayValue() {
+ isDot,
+ text,
+ maxNum
+ return isDot ? '' : (Number(text) > maxNum ? `${maxNum}+` : text)
+ methods: {
+ onClick() {
+ this.$emit('click');
+ };
+</script>
+<style lang="scss" >
+ $uni-primary: #2979ff !default;
+ $uni-success: #4cd964 !default;
+ $uni-warning: #f0ad4e !default;
+ $uni-error: #dd524d !default;
+ $uni-info: #909399 !default;
+ $bage-size: 12px;
+ $bage-small: scale(0.8);
+ .uni-badge--x {
+ /* #ifdef APP-NVUE */
+ // align-self: flex-start;
+ /* #endif */
+ /* #ifndef APP-NVUE */
+ display: inline-block;
+ position: relative;
+ .uni-badge--absolute {
+ position: absolute;
+ .uni-badge--small {
+ transform: $bage-small;
+ transform-origin: center center;
+ .uni-badge {
+ display: flex;
+ overflow: hidden;
+ box-sizing: border-box;
+ font-feature-settings: "tnum";
+ min-width: 20px;
+ justify-content: center;
+ flex-direction: row;
+ height: 20px;
+ padding: 0 4px;
+ line-height: 18px;
+ color: #fff;
+ border-radius: 100px;
+ background-color: $uni-info;
+ background-color: transparent;
+ border: 1px solid #fff;
+ text-align: center;
+ font-family: 'Helvetica Neue', Helvetica, sans-serif;
+ font-size: $bage-size;
+ /* #ifdef H5 */
+ z-index: 999;
+ cursor: pointer;
+ &--info {
+ &--primary {
+ background-color: $uni-primary;
+ &--success {
+ background-color: $uni-success;
+ &--warning {
+ background-color: $uni-warning;
+ &--error {
+ background-color: $uni-error;
+ &--inverted {
+ padding: 0 5px 0 0;
+ color: $uni-info;
+ &--info-inverted {
+ &--primary-inverted {
+ color: $uni-primary;
+ &--success-inverted {
+ color: $uni-success;
+ &--warning-inverted {
+ color: $uni-warning;
+ &--error-inverted {
+ color: $uni-error;
+</style>
@@ -0,0 +1,85 @@
+{
+ "id": "uni-badge",
+ "displayName": "uni-badge 数字角标",
+ "version": "1.2.2",
+ "description": "数字角标(徽章)组件,在元素周围展示消息提醒,一般用于列表、九宫格、按钮等地方。",
+ "keywords": [
+ "",
+ "badge",
+ "uni-ui",
+ "uniui",
+ "数字角标",
+ "徽章"
+],
+ "repository": "https://github.com/dcloudio/uni-ui",
+ "engines": {
+ "HBuilderX": ""
+ "directories": {
+ "example": "../../temps/example_temps"
+"dcloudext": {
+ "sale": {
+ "regular": {
+ "price": "0.00"
+ "sourcecode": {
+ "contact": {
+ "qq": ""
+ "declaration": {
+ "ads": "无",
+ "data": "无",
+ "permissions": "无"
+ "npmurl": "https://www.npmjs.com/package/@dcloudio/uni-ui",
+ "type": "component-vue"
+ "uni_modules": {
+ "dependencies": ["uni-scss"],
+ "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"
+ "快应用": {
+ "华为": "y",
+ "联盟": "y"
+ "Vue": {
+ "vue2": "y",
+ "vue3": "y"
+}
@@ -0,0 +1,10 @@
+## Badge 数字角标
+> **组件名:uni-badge**
+> 代码块: `uBadge`
+数字角标一般和其它控件(列表、9宫格等)配合使用,用于进行数量提示,默认为实心灰色背景,
+### [查看文档](https://uniapp.dcloud.io/component/uniui/uni-badge)
+#### 如使用过程中有任何问题,或者您对uni-ui有一些好的建议,欢迎加入 uni-ui 交流群:871950839
@@ -0,0 +1,6 @@
+## 0.1.2(2022-06-08)
+- 修复 微信小程序 separator 不显示的Bug
+## 0.1.1(2022-06-02)
+- 新增 支持 uni.scss 修改颜色
+## 0.1.0(2022-04-21)
+- 初始化
@@ -0,0 +1,121 @@
+ <view class="uni-breadcrumb-item">
+ <view :class="{
+ 'uni-breadcrumb-item--slot': true,
+ 'uni-breadcrumb-item--slot-link': to && currentPage !== to
+ }" @click="navTo">
+ <i v-if="separatorClass" class="uni-breadcrumb-item--separator" :class="separatorClass" />
+ <text v-else class="uni-breadcrumb-item--separator">{{ separator }}</text>
+ * BreadcrumbItem 面包屑导航子组件
+ * @property {String/Object} to 路由跳转页面路径/对象
+ * @property {Boolean} replace 在使用 to 进行路由跳转时,启用 replace 将不会向 history 添加新记录(仅 h5 支持)
+ currentPage: ""
+ options: {
+ virtualHost: true
+ to: {
+ replace:{
+ inject: {
+ uniBreadcrumb: {
+ from: "uniBreadcrumb",
+ default: null
+ created(){
+ const pages = getCurrentPages()
+ const page = pages[pages.length-1]
+ if(page){
+ this.currentPage = `/${page.route}`
+ separator() {
+ return this.uniBreadcrumb.separator
+ separatorClass() {
+ return this.uniBreadcrumb.separatorClass
+ navTo() {
+ const { to } = this
+ if (!to || this.currentPage === to){
+ return
+ if(this.replace){
+ uni.redirectTo({
+ url:to
+ })
+ }else{
+ uni.navigateTo({
+<style lang="scss">
+ $uni-base-color: #6a6a6a !default;
+ $uni-main-color: #3a3a3a !default;
+ .uni-breadcrumb-item {
+ align-items: center;
+ white-space: nowrap;
+ font-size: 14px;
+ &--slot {
+ color: $uni-base-color;
+ padding: 0 10px;
+ &-link {
+ color: $uni-main-color;
+ font-weight: bold;
+ &:hover {
+ &--separator {
+ font-size: 12px;
+ &:first-child &--slot {
+ padding-left: 0;
+ &:last-child &--separator {
+ display: none;
@@ -0,0 +1,41 @@
+ <view class="uni-breadcrumb">
+ * Breadcrumb 面包屑导航父组件
+ * @description 显示当前页面的路径,快速返回之前的任意页面
+ * @tutorial https://ext.dcloud.net.cn/plugin?id=xxx
+ * @property {String} separator 分隔符,默认为斜杠'/'
+ * @property {String} separatorClass 图标分隔符 class
+ separator: {
+ default: '/'
+ separatorClass: {
+ provide() {
+ uniBreadcrumb: this
+ .uni-breadcrumb {
@@ -0,0 +1,88 @@
+ "id": "uni-breadcrumb",
+ "displayName": "uni-breadcrumb 面包屑",
+ "version": "0.1.2",
+ "description": "Breadcrumb 面包屑",
+ "uni-breadcrumb",
+ "breadcrumb",
+ "面包屑导航",
+ "面包屑"
+ "repository": "",
+ "HBuilderX": "^3.1.0"
+ "dcloudext": {
+ "category": [
+ "前端组件",
+ "通用组件"
+ ],
+ "npmurl": ""
+ "dependencies": [],
+ "app-nvue": "n"
+ "阿里": "u",
+ "百度": "u",
+ "字节跳动": "u",
+ "QQ": "u",
+ "京东": "u"
+ "华为": "u",
+ "联盟": "u"
@@ -0,0 +1,66 @@
+## breadcrumb 面包屑导航
+> **组件名:uni-breadcrumb**
+> 代码块: `ubreadcrumb`
+显示当前页面的路径,快速返回之前的任意页面。
+### 安装方式
+本组件符合[easycom](https://uniapp.dcloud.io/collocation/pages?id=easycom)规范,`HBuilderX 2.5.5`起,只需将本组件导入项目,在页面`template`中即可直接使用,无需在页面中`import`和注册`components`。
+如需通过`npm`方式使用`uni-ui`组件,另见文档:[https://ext.dcloud.net.cn/plugin?id=55](https://ext.dcloud.net.cn/plugin?id=55)
+### 基本用法
+在 ``template`` 中使用组件
+```html
+<uni-breadcrumb separator="/">
+ <uni-breadcrumb-item v-for="(route,index) in routes" :key="index" :to="route.to">{{route.name}}</uni-breadcrumb-item>
+</uni-breadcrumb>
+```
+```js
+export default {
+ name: "uni-stat-breadcrumb",
+ routes: [{
+ to: '/A',
+ name: 'A页面'
+ }, {
+ to: '/B',
+ name: 'B页面'
+ to: '/C',
+ name: 'C页面'
+ }]
+## API
+### Breadcrumb Props
+|属性名 |类型 |默认值 |说明 |
+|:-: |:-: |:-: |:-: |
+|separator |String |斜杠'/' |分隔符 |
+|separatorClass |String | |图标分隔符 class |
+### Breadcrumb Item Props
+|to |String | |路由跳转页面路径 |
+|replace|Boolean | |在使用 to 进行路由跳转时,启用 replace 将不会向 history 添加新记录(仅 h5 支持) |
+## 组件示例
+点击查看:[https://hellouniapp.dcloud.net.cn/pages/extUI/breadcrumb/breadcrumb](https://hellouniapp.dcloud.net.cn/pages/extUI/breadcrumb/breadcrumb)
@@ -0,0 +1,26 @@
+## 1.4.10(2023-04-10)
+- 修复 某些情况 monthSwitch 未触发的Bug
+## 1.4.9(2023-02-02)
+- 修复 某些情况切换月份错误的Bug
+## 1.4.8(2023-01-30)
+- 修复 某些情况切换月份错误的Bug [详情](https://ask.dcloud.net.cn/question/161964)
+## 1.4.7(2022-09-16)
+- 优化 支持使用 uni-scss 控制主题色
+## 1.4.6(2022-09-08)
+- 修复 表头年月切换,导致改变当前日期为选择月1号,且未触发change事件的Bug
+## 1.4.5(2022-02-25)
+- 修复 条件编译 nvue 不支持的 css 样式的Bug
+## 1.4.4(2022-02-25)
+## 1.4.3(2021-09-22)
+- 修复 startDate、 endDate 属性失效的Bug
+## 1.4.2(2021-08-24)
+- 新增 支持国际化
+## 1.4.1(2021-08-05)
+- 修复 弹出层被 tabbar 遮盖的Bug
+## 1.4.0(2021-07-30)
+## 1.3.16(2021-05-12)
+## 1.3.15(2021-02-04)
@@ -0,0 +1,546 @@
+/**
+* @1900-2100区间内的公历、农历互转
+* @charset UTF-8
+* @github https://github.com/jjonline/calendar.js
+* @Author Jea杨(JJonline@JJonline.Cn)
+* @Time 2014-7-21
+* @Time 2016-8-13 Fixed 2033hex、Attribution Annals
+* @Time 2016-9-25 Fixed lunar LeapMonth Param Bug
+* @Time 2017-7-24 Fixed use getTerm Func Param Error.use solar year,NOT lunar year
+* @Version 1.0.3
+* @公历转农历:calendar.solar2lunar(1987,11,01); //[you can ignore params of prefix 0]
+* @农历转公历:calendar.lunar2solar(1987,09,10); //[you can ignore params of prefix 0]
+*/
+/* eslint-disable */
+var calendar = {
+ * 农历1900-2100的润大小信息表
+ * @Array Of Property
+ * @return Hex
+ lunarInfo: [0x04bd8, 0x04ae0, 0x0a570, 0x054d5, 0x0d260, 0x0d950, 0x16554, 0x056a0, 0x09ad0, 0x055d2, // 1900-1909
+ 0x04ae0, 0x0a5b6, 0x0a4d0, 0x0d250, 0x1d255, 0x0b540, 0x0d6a0, 0x0ada2, 0x095b0, 0x14977, // 1910-1919
+ 0x04970, 0x0a4b0, 0x0b4b5, 0x06a50, 0x06d40, 0x1ab54, 0x02b60, 0x09570, 0x052f2, 0x04970, // 1920-1929
+ 0x06566, 0x0d4a0, 0x0ea50, 0x06e95, 0x05ad0, 0x02b60, 0x186e3, 0x092e0, 0x1c8d7, 0x0c950, // 1930-1939
+ 0x0d4a0, 0x1d8a6, 0x0b550, 0x056a0, 0x1a5b4, 0x025d0, 0x092d0, 0x0d2b2, 0x0a950, 0x0b557, // 1940-1949
+ 0x06ca0, 0x0b550, 0x15355, 0x04da0, 0x0a5b0, 0x14573, 0x052b0, 0x0a9a8, 0x0e950, 0x06aa0, // 1950-1959
+ 0x0aea6, 0x0ab50, 0x04b60, 0x0aae4, 0x0a570, 0x05260, 0x0f263, 0x0d950, 0x05b57, 0x056a0, // 1960-1969
+ 0x096d0, 0x04dd5, 0x04ad0, 0x0a4d0, 0x0d4d4, 0x0d250, 0x0d558, 0x0b540, 0x0b6a0, 0x195a6, // 1970-1979
+ 0x095b0, 0x049b0, 0x0a974, 0x0a4b0, 0x0b27a, 0x06a50, 0x06d40, 0x0af46, 0x0ab60, 0x09570, // 1980-1989
+ 0x04af5, 0x04970, 0x064b0, 0x074a3, 0x0ea50, 0x06b58, 0x05ac0, 0x0ab60, 0x096d5, 0x092e0, // 1990-1999
+ 0x0c960, 0x0d954, 0x0d4a0, 0x0da50, 0x07552, 0x056a0, 0x0abb7, 0x025d0, 0x092d0, 0x0cab5, // 2000-2009
+ 0x0a950, 0x0b4a0, 0x0baa4, 0x0ad50, 0x055d9, 0x04ba0, 0x0a5b0, 0x15176, 0x052b0, 0x0a930, // 2010-2019
+ 0x07954, 0x06aa0, 0x0ad50, 0x05b52, 0x04b60, 0x0a6e6, 0x0a4e0, 0x0d260, 0x0ea65, 0x0d530, // 2020-2029
+ 0x05aa0, 0x076a3, 0x096d0, 0x04afb, 0x04ad0, 0x0a4d0, 0x1d0b6, 0x0d250, 0x0d520, 0x0dd45, // 2030-2039
+ 0x0b5a0, 0x056d0, 0x055b2, 0x049b0, 0x0a577, 0x0a4b0, 0x0aa50, 0x1b255, 0x06d20, 0x0ada0, // 2040-2049
+ /** Add By JJonline@JJonline.Cn**/
+ 0x14b63, 0x09370, 0x049f8, 0x04970, 0x064b0, 0x168a6, 0x0ea50, 0x06b20, 0x1a6c4, 0x0aae0, // 2050-2059
+ 0x0a2e0, 0x0d2e3, 0x0c960, 0x0d557, 0x0d4a0, 0x0da50, 0x05d55, 0x056a0, 0x0a6d0, 0x055d4, // 2060-2069
+ 0x052d0, 0x0a9b8, 0x0a950, 0x0b4a0, 0x0b6a6, 0x0ad50, 0x055a0, 0x0aba4, 0x0a5b0, 0x052b0, // 2070-2079
+ 0x0b273, 0x06930, 0x07337, 0x06aa0, 0x0ad50, 0x14b55, 0x04b60, 0x0a570, 0x054e4, 0x0d160, // 2080-2089
+ 0x0e968, 0x0d520, 0x0daa0, 0x16aa6, 0x056d0, 0x04ae0, 0x0a9d4, 0x0a2d0, 0x0d150, 0x0f252, // 2090-2099
+ 0x0d520], // 2100
+ * 公历每个月份的天数普通表
+ * @return Number
+ solarMonth: [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31],
+ * 天干地支之天干速查表
+ * @Array Of Property trans["甲","乙","丙","丁","戊","己","庚","辛","壬","癸"]
+ * @return Cn string
+ Gan: ['\u7532', '\u4e59', '\u4e19', '\u4e01', '\u620a', '\u5df1', '\u5e9a', '\u8f9b', '\u58ec', '\u7678'],
+ * 天干地支之地支速查表
+ * @trans["子","丑","寅","卯","辰","巳","午","未","申","酉","戌","亥"]
+ Zhi: ['\u5b50', '\u4e11', '\u5bc5', '\u536f', '\u8fb0', '\u5df3', '\u5348', '\u672a', '\u7533', '\u9149', '\u620c', '\u4ea5'],
+ * 天干地支之地支速查表<=>生肖
+ * @trans["鼠","牛","虎","兔","龙","蛇","马","羊","猴","鸡","狗","猪"]
+ Animals: ['\u9f20', '\u725b', '\u864e', '\u5154', '\u9f99', '\u86c7', '\u9a6c', '\u7f8a', '\u7334', '\u9e21', '\u72d7', '\u732a'],
+ * 24节气速查表
+ * @trans["小寒","大寒","立春","雨水","惊蛰","春分","清明","谷雨","立夏","小满","芒种","夏至","小暑","大暑","立秋","处暑","白露","秋分","寒露","霜降","立冬","小雪","大雪","冬至"]
+ solarTerm: ['\u5c0f\u5bd2', '\u5927\u5bd2', '\u7acb\u6625', '\u96e8\u6c34', '\u60ca\u86f0', '\u6625\u5206', '\u6e05\u660e', '\u8c37\u96e8', '\u7acb\u590f', '\u5c0f\u6ee1', '\u8292\u79cd', '\u590f\u81f3', '\u5c0f\u6691', '\u5927\u6691', '\u7acb\u79cb', '\u5904\u6691', '\u767d\u9732', '\u79cb\u5206', '\u5bd2\u9732', '\u971c\u964d', '\u7acb\u51ac', '\u5c0f\u96ea', '\u5927\u96ea', '\u51ac\u81f3'],
+ * 1900-2100各年的24节气日期速查表
+ * @return 0x string For splice
+ sTermInfo: ['9778397bd097c36b0b6fc9274c91aa', '97b6b97bd19801ec9210c965cc920e', '97bcf97c3598082c95f8c965cc920f',
+ '97bd0b06bdb0722c965ce1cfcc920f', 'b027097bd097c36b0b6fc9274c91aa', '97b6b97bd19801ec9210c965cc920e',
+ '97bcf97c359801ec95f8c965cc920f', '97bd0b06bdb0722c965ce1cfcc920f', 'b027097bd097c36b0b6fc9274c91aa',
+ '97b6b97bd19801ec9210c965cc920e', '97bcf97c359801ec95f8c965cc920f', '97bd0b06bdb0722c965ce1cfcc920f',
+ 'b027097bd097c36b0b6fc9274c91aa', '9778397bd19801ec9210c965cc920e', '97b6b97bd19801ec95f8c965cc920f',
+ '97bd09801d98082c95f8e1cfcc920f', '97bd097bd097c36b0b6fc9210c8dc2', '9778397bd197c36c9210c9274c91aa',
+ '97b6b97bd19801ec95f8c965cc920e', '97bd09801d98082c95f8e1cfcc920f', '97bd097bd097c36b0b6fc9210c8dc2',
+ '9778397bd097c36c9210c9274c91aa', '97b6b97bd19801ec95f8c965cc920e', '97bcf97c3598082c95f8e1cfcc920f',
+ '97bd097bd097c36b0b6fc9210c8dc2', '9778397bd097c36c9210c9274c91aa', '97b6b97bd19801ec9210c965cc920e',
+ '97bcf97c3598082c95f8c965cc920f', '97bd097bd097c35b0b6fc920fb0722', '9778397bd097c36b0b6fc9274c91aa',
+ '97b6b97bd19801ec9210c965cc920e', '97bcf97c3598082c95f8c965cc920f', '97bd097bd097c35b0b6fc920fb0722',
+ '9778397bd097c36b0b6fc9274c91aa', '97b6b97bd19801ec9210c965cc920e', '97bcf97c359801ec95f8c965cc920f',
+ '97bd097bd097c35b0b6fc920fb0722', '9778397bd097c36b0b6fc9274c91aa', '97b6b97bd19801ec9210c965cc920e',
+ '97bcf97c359801ec95f8c965cc920f', '97bd097bd097c35b0b6fc920fb0722', '9778397bd097c36b0b6fc9274c91aa',
+ '97b6b97bd19801ec9210c965cc920e', '97bcf97c359801ec95f8c965cc920f', '97bd097bd07f595b0b6fc920fb0722',
+ '9778397bd097c36b0b6fc9210c8dc2', '9778397bd19801ec9210c9274c920e', '97b6b97bd19801ec95f8c965cc920f',
+ '97bd07f5307f595b0b0bc920fb0722', '7f0e397bd097c36b0b6fc9210c8dc2', '9778397bd097c36c9210c9274c920e',
+ '97b6b97bd19801ec95f8c965cc920f', '97bd07f5307f595b0b0bc920fb0722', '7f0e397bd097c36b0b6fc9210c8dc2',
+ '9778397bd097c36c9210c9274c91aa', '97b6b97bd19801ec9210c965cc920e', '97bd07f1487f595b0b0bc920fb0722',
+ '7f0e397bd097c36b0b6fc9210c8dc2', '9778397bd097c36b0b6fc9274c91aa', '97b6b97bd19801ec9210c965cc920e',
+ '97bcf7f1487f595b0b0bb0b6fb0722', '7f0e397bd097c35b0b6fc920fb0722', '9778397bd097c36b0b6fc9274c91aa',
+ '97b6b97bd19801ec9210c965cc920e', '97bcf7f1487f595b0b0bb0b6fb0722', '7f0e397bd097c35b0b6fc920fb0722',
+ '9778397bd097c36b0b6fc9274c91aa', '97b6b97bd19801ec9210c965cc920e', '97bcf7f1487f531b0b0bb0b6fb0722',
+ '7f0e397bd097c35b0b6fc920fb0722', '9778397bd097c36b0b6fc9274c91aa', '97b6b97bd19801ec9210c965cc920e',
+ '97bcf7f1487f531b0b0bb0b6fb0722', '7f0e397bd07f595b0b6fc920fb0722', '9778397bd097c36b0b6fc9274c91aa',
+ '97b6b97bd19801ec9210c9274c920e', '97bcf7f0e47f531b0b0bb0b6fb0722', '7f0e397bd07f595b0b0bc920fb0722',
+ '9778397bd097c36b0b6fc9210c91aa', '97b6b97bd197c36c9210c9274c920e', '97bcf7f0e47f531b0b0bb0b6fb0722',
+ '7f0e397bd07f595b0b0bc920fb0722', '9778397bd097c36b0b6fc9210c8dc2', '9778397bd097c36c9210c9274c920e',
+ '97b6b7f0e47f531b0723b0b6fb0722', '7f0e37f5307f595b0b0bc920fb0722', '7f0e397bd097c36b0b6fc9210c8dc2',
+ '9778397bd097c36b0b70c9274c91aa', '97b6b7f0e47f531b0723b0b6fb0721', '7f0e37f1487f595b0b0bb0b6fb0722',
+ '7f0e397bd097c35b0b6fc9210c8dc2', '9778397bd097c36b0b6fc9274c91aa', '97b6b7f0e47f531b0723b0b6fb0721',
+ '7f0e27f1487f595b0b0bb0b6fb0722', '7f0e397bd097c35b0b6fc920fb0722', '9778397bd097c36b0b6fc9274c91aa',
+ '97b6b7f0e47f531b0723b0b6fb0721', '7f0e27f1487f531b0b0bb0b6fb0722', '7f0e397bd097c35b0b6fc920fb0722',
+ '9778397bd097c36b0b6fc9274c91aa', '97b6b7f0e47f531b0723b0b6fb0721', '7f0e27f1487f531b0b0bb0b6fb0722',
+ '7f0e397bd097c35b0b6fc920fb0722', '9778397bd097c36b0b6fc9274c91aa', '97b6b7f0e47f531b0723b0b6fb0721',
+ '7f0e27f1487f531b0b0bb0b6fb0722', '7f0e397bd07f595b0b0bc920fb0722', '9778397bd097c36b0b6fc9274c91aa',
+ '97b6b7f0e47f531b0723b0787b0721', '7f0e27f0e47f531b0b0bb0b6fb0722', '7f0e397bd07f595b0b0bc920fb0722',
+ '9778397bd097c36b0b6fc9210c91aa', '97b6b7f0e47f149b0723b0787b0721', '7f0e27f0e47f531b0723b0b6fb0722',
+ '7f0e397bd07f595b0b0bc920fb0722', '9778397bd097c36b0b6fc9210c8dc2', '977837f0e37f149b0723b0787b0721',
+ '7f07e7f0e47f531b0723b0b6fb0722', '7f0e37f5307f595b0b0bc920fb0722', '7f0e397bd097c35b0b6fc9210c8dc2',
+ '977837f0e37f14998082b0787b0721', '7f07e7f0e47f531b0723b0b6fb0721', '7f0e37f1487f595b0b0bb0b6fb0722',
+ '7f0e397bd097c35b0b6fc9210c8dc2', '977837f0e37f14998082b0787b06bd', '7f07e7f0e47f531b0723b0b6fb0721',
+ '7f0e27f1487f531b0b0bb0b6fb0722', '7f0e397bd097c35b0b6fc920fb0722', '977837f0e37f14998082b0787b06bd',
+ '7f07e7f0e47f531b0723b0b6fb0721', '7f0e27f1487f531b0b0bb0b6fb0722', '7f0e397bd097c35b0b6fc920fb0722',
+ '977837f0e37f14998082b0787b06bd', '7f07e7f0e47f531b0723b0b6fb0721', '7f0e27f1487f531b0b0bb0b6fb0722',
+ '7f0e397bd07f595b0b0bc920fb0722', '977837f0e37f14998082b0787b06bd', '7f07e7f0e47f531b0723b0b6fb0721',
+ '7f0e27f1487f531b0b0bb0b6fb0722', '7f0e397bd07f595b0b0bc920fb0722', '977837f0e37f14998082b0787b06bd',
+ '7f07e7f0e47f149b0723b0787b0721', '7f0e27f0e47f531b0b0bb0b6fb0722', '7f0e397bd07f595b0b0bc920fb0722',
+ '977837f0e37f14998082b0723b06bd', '7f07e7f0e37f149b0723b0787b0721', '7f0e27f0e47f531b0723b0b6fb0722',
+ '7f0e397bd07f595b0b0bc920fb0722', '977837f0e37f14898082b0723b02d5', '7ec967f0e37f14998082b0787b0721',
+ '7f07e7f0e47f531b0723b0b6fb0722', '7f0e37f1487f595b0b0bb0b6fb0722', '7f0e37f0e37f14898082b0723b02d5',
+ '7ec967f0e37f14998082b0787b0721', '7f07e7f0e47f531b0723b0b6fb0722', '7f0e37f1487f531b0b0bb0b6fb0722',
+ '7f0e37f0e37f14898082b0723b02d5', '7ec967f0e37f14998082b0787b06bd', '7f07e7f0e47f531b0723b0b6fb0721',
+ '7f0e37f1487f531b0b0bb0b6fb0722', '7f0e37f0e37f14898082b072297c35', '7ec967f0e37f14998082b0787b06bd',
+ '7f07e7f0e47f531b0723b0b6fb0721', '7f0e27f1487f531b0b0bb0b6fb0722', '7f0e37f0e37f14898082b072297c35',
+ '7ec967f0e37f14998082b0787b06bd', '7f07e7f0e47f531b0723b0b6fb0721', '7f0e27f1487f531b0b0bb0b6fb0722',
+ '7f0e37f0e366aa89801eb072297c35', '7ec967f0e37f14998082b0787b06bd', '7f07e7f0e47f149b0723b0787b0721',
+ '7f0e27f1487f531b0b0bb0b6fb0722', '7f0e37f0e366aa89801eb072297c35', '7ec967f0e37f14998082b0723b06bd',
+ '7f07e7f0e47f149b0723b0787b0721', '7f0e27f0e47f531b0723b0b6fb0722', '7f0e37f0e366aa89801eb072297c35',
+ '7ec967f0e37f14998082b0723b06bd', '7f07e7f0e37f14998083b0787b0721', '7f0e27f0e47f531b0723b0b6fb0722',
+ '7f0e37f0e366aa89801eb072297c35', '7ec967f0e37f14898082b0723b02d5', '7f07e7f0e37f14998082b0787b0721',
+ '7f07e7f0e47f531b0723b0b6fb0722', '7f0e36665b66aa89801e9808297c35', '665f67f0e37f14898082b0723b02d5',
+ '7ec967f0e37f14998082b0787b0721', '7f07e7f0e47f531b0723b0b6fb0722', '7f0e36665b66a449801e9808297c35',
+ '665f67f0e37f14898082b0723b02d5', '7ec967f0e37f14998082b0787b06bd', '7f07e7f0e47f531b0723b0b6fb0721',
+ '7f0e36665b66a449801e9808297c35', '665f67f0e37f14898082b072297c35', '7ec967f0e37f14998082b0787b06bd',
+ '7f07e7f0e47f531b0723b0b6fb0721', '7f0e26665b66a449801e9808297c35', '665f67f0e37f1489801eb072297c35',
+ '7ec967f0e37f14998082b0787b06bd', '7f07e7f0e47f531b0723b0b6fb0721', '7f0e27f1487f531b0b0bb0b6fb0722'],
+ * 数字转中文速查表
+ * @trans ['日','一','二','三','四','五','六','七','八','九','十']
+ nStr1: ['\u65e5', '\u4e00', '\u4e8c', '\u4e09', '\u56db', '\u4e94', '\u516d', '\u4e03', '\u516b', '\u4e5d', '\u5341'],
+ * 日期转农历称呼速查表
+ * @trans ['初','十','廿','卅']
+ nStr2: ['\u521d', '\u5341', '\u5eff', '\u5345'],
+ * 月份转农历称呼速查表
+ * @trans ['正','一','二','三','四','五','六','七','八','九','十','冬','腊']
+ nStr3: ['\u6b63', '\u4e8c', '\u4e09', '\u56db', '\u4e94', '\u516d', '\u4e03', '\u516b', '\u4e5d', '\u5341', '\u51ac', '\u814a'],
+ * 返回农历y年一整年的总天数
+ * @param lunar Year
+ * @eg:var count = calendar.lYearDays(1987) ;//count=387
+ lYearDays: function (y) {
+ var i; var sum = 348
+ for (i = 0x8000; i > 0x8; i >>= 1) { sum += (this.lunarInfo[y - 1900] & i) ? 1 : 0 }
+ return (sum + this.leapDays(y))
+ * 返回农历y年闰月是哪个月;若y年没有闰月 则返回0
+ * @return Number (0-12)
+ * @eg:var leapMonth = calendar.leapMonth(1987) ;//leapMonth=6
+ leapMonth: function (y) { // 闰字编码 \u95f0
+ return (this.lunarInfo[y - 1900] & 0xf)
+ * 返回农历y年闰月的天数 若该年没有闰月则返回0
+ * @return Number (0、29、30)
+ * @eg:var leapMonthDay = calendar.leapDays(1987) ;//leapMonthDay=29
+ leapDays: function (y) {
+ if (this.leapMonth(y)) {
+ return ((this.lunarInfo[y - 1900] & 0x10000) ? 30 : 29)
+ return (0)
+ * 返回农历y年m月(非闰月)的总天数,计算m为闰月时的天数请使用leapDays方法
+ * @return Number (-1、29、30)
+ * @eg:var MonthDay = calendar.monthDays(1987,9) ;//MonthDay=29
+ monthDays: function (y, m) {
+ if (m > 12 || m < 1) { return -1 }// 月份参数从1至12,参数错误返回-1
+ return ((this.lunarInfo[y - 1900] & (0x10000 >> m)) ? 30 : 29)
+ * 返回公历(!)y年m月的天数
+ * @param solar Year
+ * @return Number (-1、28、29、30、31)
+ * @eg:var solarMonthDay = calendar.leapDays(1987) ;//solarMonthDay=30
+ solarDays: function (y, m) {
+ if (m > 12 || m < 1) { return -1 } // 若参数错误 返回-1
+ var ms = m - 1
+ if (ms == 1) { // 2月份的闰平规律测算后确认返回28或29
+ return (((y % 4 == 0) && (y % 100 != 0) || (y % 400 == 0)) ? 29 : 28)
+ } else {
+ return (this.solarMonth[ms])
+ * 农历年份转换为干支纪年
+ * @param lYear 农历年的年份数
+ toGanZhiYear: function (lYear) {
+ var ganKey = (lYear - 3) % 10
+ var zhiKey = (lYear - 3) % 12
+ if (ganKey == 0) ganKey = 10// 如果余数为0则为最后一个天干
+ if (zhiKey == 0) zhiKey = 12// 如果余数为0则为最后一个地支
+ return this.Gan[ganKey - 1] + this.Zhi[zhiKey - 1]
+ * 公历月、日判断所属星座
+ * @param cMonth [description]
+ * @param cDay [description]
+ toAstro: function (cMonth, cDay) {
+ var s = '\u9b54\u7faf\u6c34\u74f6\u53cc\u9c7c\u767d\u7f8a\u91d1\u725b\u53cc\u5b50\u5de8\u87f9\u72ee\u5b50\u5904\u5973\u5929\u79e4\u5929\u874e\u5c04\u624b\u9b54\u7faf'
+ var arr = [20, 19, 21, 21, 21, 22, 23, 23, 23, 23, 22, 22]
+ return s.substr(cMonth * 2 - (cDay < arr[cMonth - 1] ? 2 : 0), 2) + '\u5ea7'// 座
+ * 传入offset偏移量返回干支
+ * @param offset 相对甲子的偏移量
+ toGanZhi: function (offset) {
+ return this.Gan[offset % 10] + this.Zhi[offset % 12]
+ * 传入公历(!)y年获得该年第n个节气的公历日期
+ * @param y公历年(1900-2100);n二十四节气中的第几个节气(1~24);从n=1(小寒)算起
+ * @return day Number
+ * @eg:var _24 = calendar.getTerm(1987,3) ;//_24=4;意即1987年2月4日立春
+ getTerm: function (y, n) {
+ if (y < 1900 || y > 2100) { return -1 }
+ if (n < 1 || n > 24) { return -1 }
+ var _table = this.sTermInfo[y - 1900]
+ var _info = [
+ parseInt('0x' + _table.substr(0, 5)).toString(),
+ parseInt('0x' + _table.substr(5, 5)).toString(),
+ parseInt('0x' + _table.substr(10, 5)).toString(),
+ parseInt('0x' + _table.substr(15, 5)).toString(),
+ parseInt('0x' + _table.substr(20, 5)).toString(),
+ parseInt('0x' + _table.substr(25, 5)).toString()
+ ]
+ var _calday = [
+ _info[0].substr(0, 1),
+ _info[0].substr(1, 2),
+ _info[0].substr(3, 1),
+ _info[0].substr(4, 2),
+ _info[1].substr(0, 1),
+ _info[1].substr(1, 2),
+ _info[1].substr(3, 1),
+ _info[1].substr(4, 2),
+ _info[2].substr(0, 1),
+ _info[2].substr(1, 2),
+ _info[2].substr(3, 1),
+ _info[2].substr(4, 2),
+ _info[3].substr(0, 1),
+ _info[3].substr(1, 2),
+ _info[3].substr(3, 1),
+ _info[3].substr(4, 2),
+ _info[4].substr(0, 1),
+ _info[4].substr(1, 2),
+ _info[4].substr(3, 1),
+ _info[4].substr(4, 2),
+ _info[5].substr(0, 1),
+ _info[5].substr(1, 2),
+ _info[5].substr(3, 1),
+ _info[5].substr(4, 2)
+ return parseInt(_calday[n - 1])
+ * 传入农历数字月份返回汉语通俗表示法
+ * @param lunar month
+ * @eg:var cnMonth = calendar.toChinaMonth(12) ;//cnMonth='腊月'
+ toChinaMonth: function (m) { // 月 => \u6708
+ var s = this.nStr3[m - 1]
+ s += '\u6708'// 加上月字
+ return s
+ * 传入农历日期数字返回汉字表示法
+ * @param lunar day
+ * @eg:var cnDay = calendar.toChinaDay(21) ;//cnMonth='廿一'
+ toChinaDay: function (d) { // 日 => \u65e5
+ var s
+ switch (d) {
+ case 10:
+ s = '\u521d\u5341'; break
+ case 20:
+ s = '\u4e8c\u5341'; break
+ break
+ case 30:
+ s = '\u4e09\u5341'; break
+ default :
+ s = this.nStr2[Math.floor(d / 10)]
+ s += this.nStr1[d % 10]
+ return (s)
+ * 年份转生肖[!仅能大致转换] => 精确划分生肖分界线是“立春”
+ * @param y year
+ * @eg:var animal = calendar.getAnimal(1987) ;//animal='兔'
+ getAnimal: function (y) {
+ return this.Animals[(y - 4) % 12]
+ * 传入阳历年月日获得详细的公历、农历object信息 <=>JSON
+ * @param y solar year
+ * @param m solar month
+ * @param d solar day
+ * @return JSON object
+ * @eg:console.log(calendar.solar2lunar(1987,11,01));
+ solar2lunar: function (y, m, d) { // 参数区间1900.1.31~2100.12.31
+ // 年份限定、上限
+ if (y < 1900 || y > 2100) {
+ return -1// undefined转换为数字变为NaN
+ // 公历传参最下限
+ if (y == 1900 && m == 1 && d < 31) {
+ return -1
+ // 未传参 获得当天
+ if (!y) {
+ var objDate = new Date()
+ var objDate = new Date(y, parseInt(m) - 1, d)
+ var i; var leap = 0; var temp = 0
+ // 修正ymd参数
+ var y = objDate.getFullYear()
+ var m = objDate.getMonth() + 1
+ var d = objDate.getDate()
+ var offset = (Date.UTC(objDate.getFullYear(), objDate.getMonth(), objDate.getDate()) - Date.UTC(1900, 0, 31)) / 86400000
+ for (i = 1900; i < 2101 && offset > 0; i++) {
+ temp = this.lYearDays(i)
+ offset -= temp
+ if (offset < 0) {
+ offset += temp; i--
+ // 是否今天
+ var isTodayObj = new Date()
+ var isToday = false
+ if (isTodayObj.getFullYear() == y && isTodayObj.getMonth() + 1 == m && isTodayObj.getDate() == d) {
+ isToday = true
+ // 星期几
+ var nWeek = objDate.getDay()
+ var cWeek = this.nStr1[nWeek]
+ // 数字表示周几顺应天朝周一开始的惯例
+ if (nWeek == 0) {
+ nWeek = 7
+ // 农历年
+ var year = i
+ var leap = this.leapMonth(i) // 闰哪个月
+ var isLeap = false
+ // 效验闰月
+ for (i = 1; i < 13 && offset > 0; i++) {
+ // 闰月
+ if (leap > 0 && i == (leap + 1) && isLeap == false) {
+ --i
+ isLeap = true; temp = this.leapDays(year) // 计算农历闰月天数
+ temp = this.monthDays(year, i)// 计算农历普通月天数
+ // 解除闰月
+ if (isLeap == true && i == (leap + 1)) { isLeap = false }
+ // 闰月导致数组下标重叠取反
+ if (offset == 0 && leap > 0 && i == leap + 1) {
+ if (isLeap) {
+ isLeap = false
+ isLeap = true; --i
+ offset += temp; --i
+ // 农历月
+ var month = i
+ // 农历日
+ var day = offset + 1
+ // 天干地支处理
+ var sm = m - 1
+ var gzY = this.toGanZhiYear(year)
+ // 当月的两个节气
+ // bugfix-2017-7-24 11:03:38 use lunar Year Param `y` Not `year`
+ var firstNode = this.getTerm(y, (m * 2 - 1))// 返回当月「节」为几日开始
+ var secondNode = this.getTerm(y, (m * 2))// 返回当月「节」为几日开始
+ // 依据12节气修正干支月
+ var gzM = this.toGanZhi((y - 1900) * 12 + m + 11)
+ if (d >= firstNode) {
+ gzM = this.toGanZhi((y - 1900) * 12 + m + 12)
+ // 传入的日期的节气与否
+ var isTerm = false
+ var Term = null
+ if (firstNode == d) {
+ isTerm = true
+ Term = this.solarTerm[m * 2 - 2]
+ if (secondNode == d) {
+ Term = this.solarTerm[m * 2 - 1]
+ // 日柱 当月一日与 1900/1/1 相差天数
+ var dayCyclical = Date.UTC(y, sm, 1, 0, 0, 0, 0) / 86400000 + 25567 + 10
+ var gzD = this.toGanZhi(dayCyclical + d - 1)
+ // 该日期所属的星座
+ var astro = this.toAstro(m, d)
+ return { 'lYear': year, 'lMonth': month, 'lDay': day, 'Animal': this.getAnimal(year), 'IMonthCn': (isLeap ? '\u95f0' : '') + this.toChinaMonth(month), 'IDayCn': this.toChinaDay(day), 'cYear': y, 'cMonth': m, 'cDay': d, 'gzYear': gzY, 'gzMonth': gzM, 'gzDay': gzD, 'isToday': isToday, 'isLeap': isLeap, 'nWeek': nWeek, 'ncWeek': '\u661f\u671f' + cWeek, 'isTerm': isTerm, 'Term': Term, 'astro': astro }
+ * 传入农历年月日以及传入的月份是否闰月获得详细的公历、农历object信息 <=>JSON
+ * @param y lunar year
+ * @param m lunar month
+ * @param d lunar day
+ * @param isLeapMonth lunar month is leap or not.[如果是农历闰月第四个参数赋值true即可]
+ * @eg:console.log(calendar.lunar2solar(1987,9,10));
+ lunar2solar: function (y, m, d, isLeapMonth) { // 参数区间1900.1.31~2100.12.1
+ var isLeapMonth = !!isLeapMonth
+ var leapOffset = 0
+ var leapMonth = this.leapMonth(y)
+ var leapDay = this.leapDays(y)
+ if (isLeapMonth && (leapMonth != m)) { return -1 }// 传参要求计算该闰月公历 但该年得出的闰月与传参的月份并不同
+ if (y == 2100 && m == 12 && d > 1 || y == 1900 && m == 1 && d < 31) { return -1 }// 超出了最大极限值
+ var day = this.monthDays(y, m)
+ var _day = day
+ // bugFix 2016-9-25
+ // if month is leap, _day use leapDays method
+ if (isLeapMonth) {
+ _day = this.leapDays(y, m)
+ if (y < 1900 || y > 2100 || d > _day) { return -1 }// 参数合法性效验
+ // 计算农历的时间差
+ var offset = 0
+ for (var i = 1900; i < y; i++) {
+ offset += this.lYearDays(i)
+ var leap = 0; var isAdd = false
+ for (var i = 1; i < m; i++) {
+ leap = this.leapMonth(y)
+ if (!isAdd) { // 处理闰月
+ if (leap <= i && leap > 0) {
+ offset += this.leapDays(y); isAdd = true
+ offset += this.monthDays(y, i)
+ // 转换闰月农历 需补充该年闰月的前一个月的时差
+ if (isLeapMonth) { offset += day }
+ // 1900年农历正月一日的公历时间为1900年1月30日0时0分0秒(该时间也是本农历的最开始起始点)
+ var stmap = Date.UTC(1900, 1, 30, 0, 0, 0)
+ var calObj = new Date((offset + d - 31) * 86400000 + stmap)
+ var cY = calObj.getUTCFullYear()
+ var cM = calObj.getUTCMonth() + 1
+ var cD = calObj.getUTCDate()
+ return this.solar2lunar(cY, cM, cD)
+export default calendar
@@ -0,0 +1,12 @@
+ "uni-calender.ok": "ok",
+ "uni-calender.cancel": "cancel",
+ "uni-calender.today": "today",
+ "uni-calender.MON": "MON",
+ "uni-calender.TUE": "TUE",
+ "uni-calender.WED": "WED",
+ "uni-calender.THU": "THU",
+ "uni-calender.FRI": "FRI",
+ "uni-calender.SAT": "SAT",
+ "uni-calender.SUN": "SUN"
@@ -0,0 +1,8 @@
+import en from './en.json'
+import zhHans from './zh-Hans.json'
+import zhHant from './zh-Hant.json'
+ en,
+ 'zh-Hans': zhHans,
+ 'zh-Hant': zhHant
+ "uni-calender.ok": "确定",
+ "uni-calender.cancel": "取消",
+ "uni-calender.today": "今日",
+ "uni-calender.SUN": "日",
+ "uni-calender.MON": "一",
+ "uni-calender.TUE": "二",
+ "uni-calender.WED": "三",
+ "uni-calender.THU": "四",
+ "uni-calender.FRI": "五",
+ "uni-calender.SAT": "六"
+ "uni-calender.ok": "確定",
@@ -0,0 +1,187 @@
+ <view class="uni-calendar-item__weeks-box" :class="{
+ 'uni-calendar-item--disable':weeks.disable,
+ 'uni-calendar-item--isDay':calendar.fullDate === weeks.fullDate && weeks.isDay,
+ 'uni-calendar-item--checked':(calendar.fullDate === weeks.fullDate && !weeks.isDay) ,
+ 'uni-calendar-item--before-checked':weeks.beforeMultiple,
+ 'uni-calendar-item--multiple': weeks.multiple,
+ 'uni-calendar-item--after-checked':weeks.afterMultiple,
+ }"
+ @click="choiceDate(weeks)">
+ <view class="uni-calendar-item__weeks-box-item">
+ <text v-if="selected&&weeks.extraInfo" class="uni-calendar-item__weeks-box-circle"></text>
+ <text class="uni-calendar-item__weeks-box-text" :class="{
+ 'uni-calendar-item--isDay-text': weeks.isDay,
+ 'uni-calendar-item--checked':calendar.fullDate === weeks.fullDate && !weeks.isDay,
+ }">{{weeks.date}}</text>
+ <text v-if="!lunar&&!weeks.extraInfo && weeks.isDay" class="uni-calendar-item__weeks-lunar-text" :class="{
+ 'uni-calendar-item--isDay-text':weeks.isDay,
+ }">{{todayText}}</text>
+ <text v-if="lunar&&!weeks.extraInfo" class="uni-calendar-item__weeks-lunar-text" :class="{
+ }">{{weeks.isDay ? todayText : (weeks.lunar.IDayCn === '初一'?weeks.lunar.IMonthCn:weeks.lunar.IDayCn)}}</text>
+ <text v-if="weeks.extraInfo&&weeks.extraInfo.info" class="uni-calendar-item__weeks-lunar-text" :class="{
+ 'uni-calendar-item--extra':weeks.extraInfo.info,
+ }">{{weeks.extraInfo.info}}</text>
+ import { initVueI18n } from '@dcloudio/uni-i18n'
+ import i18nMessages from './i18n/index.js'
+ const { t } = initVueI18n(i18nMessages)
+ emits:['change'],
+ weeks: {
+ calendar: {
+ default: () => {
+ selected: {
+ return []
+ lunar: {
+ todayText() {
+ return t("uni-calender.today")
+ choiceDate(weeks) {
+ this.$emit('change', weeks)
+<style lang="scss" scoped>
+ $uni-font-size-base:14px;
+ $uni-text-color:#333;
+ $uni-font-size-sm:12px;
+ $uni-color-error: #e43d33;
+ $uni-opacity-disabled: 0.3;
+ $uni-text-color-disable:#c0c0c0;
+ .uni-calendar-item__weeks-box {
+ flex: 1;
+ flex-direction: column;
+ .uni-calendar-item__weeks-box-text {
+ font-size: $uni-font-size-base;
+ color: $uni-text-color;
+ .uni-calendar-item__weeks-lunar-text {
+ font-size: $uni-font-size-sm;
+ .uni-calendar-item__weeks-box-item {
+ width: 100rpx;
+ height: 100rpx;
+ .uni-calendar-item__weeks-box-circle {
+ top: 5px;
+ right: 5px;
+ width: 8px;
+ height: 8px;
+ border-radius: 8px;
+ background-color: $uni-color-error;
+ .uni-calendar-item--disable {
+ background-color: rgba(249, 249, 249, $uni-opacity-disabled);
+ color: $uni-text-color-disable;
+ .uni-calendar-item--isDay-text {
+ .uni-calendar-item--isDay {
+ opacity: 0.8;
+ .uni-calendar-item--extra {
+ color: $uni-color-error;
+ .uni-calendar-item--checked {
+ .uni-calendar-item--multiple {
+ .uni-calendar-item--before-checked {
+ background-color: #ff5a5f;
+ .uni-calendar-item--after-checked {
@@ -0,0 +1,566 @@
+ <view class="uni-calendar">
+ <view v-if="!insert&&show" class="uni-calendar__mask" :class="{'uni-calendar--mask-show':aniMaskShow}" @click="clean"></view>
+ <view v-if="insert || show" class="uni-calendar__content" :class="{'uni-calendar--fixed':!insert,'uni-calendar--ani-show':aniMaskShow}">
+ <view v-if="!insert" class="uni-calendar__header uni-calendar--fixed-top">
+ <view class="uni-calendar__header-btn-box" @click="close">
+ <text class="uni-calendar__header-text uni-calendar--fixed-width">{{cancelText}}</text>
+ <view class="uni-calendar__header-btn-box" @click="confirm">
+ <text class="uni-calendar__header-text uni-calendar--fixed-width">{{okText}}</text>
+ <view class="uni-calendar__header">
+ <view class="uni-calendar__header-btn-box" @click.stop="pre">
+ <view class="uni-calendar__header-btn uni-calendar--left"></view>
+ <picker mode="date" :value="date" fields="month" @change="bindDateChange">
+ <text class="uni-calendar__header-text">{{ (nowDate.year||'') +' / '+( nowDate.month||'')}}</text>
+ </picker>
+ <view class="uni-calendar__header-btn-box" @click.stop="next">
+ <view class="uni-calendar__header-btn uni-calendar--right"></view>
+ <text class="uni-calendar__backtoday" @click="backToday">{{todayText}}</text>
+ <view class="uni-calendar__box">
+ <view v-if="showMonth" class="uni-calendar__box-bg">
+ <text class="uni-calendar__box-bg-text">{{nowDate.month}}</text>
+ <view class="uni-calendar__weeks">
+ <view class="uni-calendar__weeks-day">
+ <text class="uni-calendar__weeks-day-text">{{SUNText}}</text>
+ <text class="uni-calendar__weeks-day-text">{{monText}}</text>
+ <text class="uni-calendar__weeks-day-text">{{TUEText}}</text>
+ <text class="uni-calendar__weeks-day-text">{{WEDText}}</text>
+ <text class="uni-calendar__weeks-day-text">{{THUText}}</text>
+ <text class="uni-calendar__weeks-day-text">{{FRIText}}</text>
+ <text class="uni-calendar__weeks-day-text">{{SATText}}</text>
+ <view class="uni-calendar__weeks" v-for="(item,weekIndex) in weeks" :key="weekIndex">
+ <view class="uni-calendar__weeks-item" v-for="(weeks,weeksIndex) in item" :key="weeksIndex">
+ <calendar-item class="uni-calendar-item--hook" :weeks="weeks" :calendar="calendar" :selected="selected" :lunar="lunar" @change="choiceDate"></calendar-item>
+ import Calendar from './util.js';
+ import CalendarItem from './uni-calendar-item.vue'
+ * Calendar 日历
+ * @description 日历组件可以查看日期,选择任意范围内的日期,打点操作。常用场景如:酒店日期预订、火车机票选择购买日期、上下班打卡等
+ * @tutorial https://ext.dcloud.net.cn/plugin?id=56
+ * @property {String} date 自定义当前时间,默认为今天
+ * @property {Boolean} lunar 显示农历
+ * @property {String} startDate 日期选择范围-开始日期
+ * @property {String} endDate 日期选择范围-结束日期
+ * @property {Boolean} range 范围选择
+ * @property {Boolean} insert = [true|false] 插入模式,默认为false
+ * @value true 弹窗模式
+ * @value false 插入模式
+ * @property {Boolean} clearDate = [true|false] 弹窗模式是否清空上次选择内容
+ * @property {Array} selected 打点,期待格式[{date: '2019-06-27', info: '签到', data: { custom: '自定义信息', name: '自定义消息头',xxx:xxx... }}]
+ * @property {Boolean} showMonth 是否选择月份为背景
+ * @event {Function} change 日期改变,`insert :ture` 时生效
+ * @event {Function} confirm 确认选择`insert :false` 时生效
+ * @event {Function} monthSwitch 切换月份时触发
+ * @example <uni-calendar :insert="true":lunar="true" :start-date="'2019-3-2'":end-date="'2019-5-20'"@change="change" />
+ components: {
+ CalendarItem
+ emits:['close','confirm','change','monthSwitch'],
+ date: {
+ startDate: {
+ endDate: {
+ range: {
+ insert: {
+ default: true
+ showMonth: {
+ clearDate: {
+ show: false,
+ weeks: [],
+ calendar: {},
+ nowDate: '',
+ aniMaskShow: false
+ computed:{
+ * for i18n
+ okText() {
+ return t("uni-calender.ok")
+ cancelText() {
+ return t("uni-calender.cancel")
+ monText() {
+ return t("uni-calender.MON")
+ TUEText() {
+ return t("uni-calender.TUE")
+ WEDText() {
+ return t("uni-calender.WED")
+ THUText() {
+ return t("uni-calender.THU")
+ FRIText() {
+ return t("uni-calender.FRI")
+ SATText() {
+ return t("uni-calender.SAT")
+ SUNText() {
+ return t("uni-calender.SUN")
+ watch: {
+ date(newVal) {
+ // this.cale.setDate(newVal)
+ this.init(newVal)
+ startDate(val){
+ this.cale.resetSatrtDate(val)
+ this.cale.setDate(this.nowDate.fullDate)
+ this.weeks = this.cale.weeks
+ endDate(val){
+ this.cale.resetEndDate(val)
+ selected(newVal) {
+ this.cale.setSelectInfo(this.nowDate.fullDate, newVal)
+ created() {
+ this.cale = new Calendar({
+ selected: this.selected,
+ startDate: this.startDate,
+ endDate: this.endDate,
+ range: this.range,
+ this.init(this.date)
+ // 取消穿透
+ clean() {},
+ bindDateChange(e) {
+ const value = e.detail.value + '-1'
+ this.setDate(value)
+ const { year,month } = this.cale.getDate(value)
+ this.$emit('monthSwitch', {
+ year,
+ month
+ * 初始化日期显示
+ * @param {Object} date
+ init(date) {
+ this.cale.setDate(date)
+ this.nowDate = this.calendar = this.cale.getInfo(date)
+ * 打开日历弹窗
+ open() {
+ // 弹窗模式并且清理数据
+ if (this.clearDate && !this.insert) {
+ this.cale.cleanMultipleStatus()
+ // this.cale.setDate(this.date)
+ this.show = true
+ this.$nextTick(() => {
+ setTimeout(() => {
+ this.aniMaskShow = true
+ }, 50)
+ * 关闭日历弹窗
+ close() {
+ this.aniMaskShow = false
+ this.show = false
+ this.$emit('close')
+ }, 300)
+ * 确认按钮
+ confirm() {
+ this.setEmit('confirm')
+ this.close()
+ * 变化触发
+ change() {
+ if (!this.insert) return
+ this.setEmit('change')
+ * 选择月份触发
+ monthSwitch() {
+ let {
+ } = this.nowDate
+ month: Number(month)
+ * 派发事件
+ * @param {Object} name
+ setEmit(name) {
+ month,
+ date,
+ fullDate,
+ lunar,
+ extraInfo
+ } = this.calendar
+ this.$emit(name, {
+ range: this.cale.multipleStatus,
+ fulldate: fullDate,
+ extraInfo: extraInfo || {}
+ * 选择天触发
+ * @param {Object} weeks
+ if (weeks.disable) return
+ this.calendar = weeks
+ // 设置多选
+ this.cale.setMultiple(this.calendar.fullDate)
+ this.change()
+ * 回到今天
+ backToday() {
+ const nowYearMonth = `${this.nowDate.year}-${this.nowDate.month}`
+ const date = this.cale.getDate(new Date())
+ const todayYearMonth = `${date.year}-${date.month}`
+ if(nowYearMonth !== todayYearMonth) {
+ this.monthSwitch()
+ this.init(date.fullDate)
+ * 上个月
+ pre() {
+ const preDate = this.cale.getDate(this.nowDate.fullDate, -1, 'month').fullDate
+ this.setDate(preDate)
+ * 下个月
+ next() {
+ const nextDate = this.cale.getDate(this.nowDate.fullDate, +1, 'month').fullDate
+ this.setDate(nextDate)
+ * 设置日期
+ setDate(date) {
+ this.nowDate = this.cale.getInfo(date)
+ $uni-bg-color-mask: rgba($color: #000000, $alpha: 0.4);
+ $uni-border-color: #EDEDED;
+ $uni-text-color: #333;
+ $uni-bg-color-hover:#f1f1f1;
+ $uni-text-color-placeholder: #808080;
+ $uni-color-subtitle: #555555;
+ $uni-text-color-grey:#999;
+ .uni-calendar {
+ .uni-calendar__mask {
+ position: fixed;
+ bottom: 0;
+ top: 0;
+ left: 0;
+ right: 0;
+ background-color: $uni-bg-color-mask;
+ transition-property: opacity;
+ transition-duration: 0.3s;
+ opacity: 0;
+ z-index: 99;
+ .uni-calendar--mask-show {
+ opacity: 1
+ .uni-calendar--fixed {
+ transition-property: transform;
+ transform: translateY(460px);
+ bottom: calc(var(--window-bottom));
+ .uni-calendar--ani-show {
+ transform: translateY(0);
+ .uni-calendar__content {
+ background-color: #fff;
+ .uni-calendar__header {
+ height: 50px;
+ border-bottom-color: $uni-border-color;
+ border-bottom-style: solid;
+ border-bottom-width: 1px;
+ .uni-calendar--fixed-top {
+ justify-content: space-between;
+ border-top-color: $uni-border-color;
+ border-top-style: solid;
+ border-top-width: 1px;
+ .uni-calendar--fixed-width {
+ width: 50px;
+ .uni-calendar__backtoday {
+ top: 25rpx;
+ padding: 0 5px;
+ padding-left: 10px;
+ height: 25px;
+ line-height: 25px;
+ border-top-left-radius: 25px;
+ border-bottom-left-radius: 25px;
+ background-color: $uni-bg-color-hover;
+ .uni-calendar__header-text {
+ width: 100px;
+ .uni-calendar__header-btn-box {
+ .uni-calendar__header-btn {
+ width: 10px;
+ height: 10px;
+ border-left-color: $uni-text-color-placeholder;
+ border-left-style: solid;
+ border-left-width: 2px;
+ border-top-color: $uni-color-subtitle;
+ border-top-width: 2px;
+ .uni-calendar--left {
+ transform: rotate(-45deg);
+ .uni-calendar--right {
+ transform: rotate(135deg);
+ .uni-calendar__weeks {
+ .uni-calendar__weeks-item {
+ .uni-calendar__weeks-day {
+ height: 45px;
+ border-bottom-color: #F5F5F5;
+ .uni-calendar__weeks-day-text {
+ .uni-calendar__box {
+ .uni-calendar__box-bg {
+ .uni-calendar__box-bg-text {
+ font-size: 200px;
+ color: $uni-text-color-grey;
+ opacity: 0.1;
+ line-height: 1;
@@ -0,0 +1,360 @@
+import CALENDAR from './calendar.js'
+class Calendar {
+ constructor({
+ selected,
+ startDate,
+ endDate,
+ range
+ } = {}) {
+ // 当前日期
+ this.date = this.getDate(new Date()) // 当前初入日期
+ // 打点信息
+ this.selected = selected || [];
+ // 范围开始
+ this.startDate = startDate
+ // 范围结束
+ this.endDate = endDate
+ this.range = range
+ // 多选状态
+ this.cleanMultipleStatus()
+ // 每周日期
+ this.weeks = {}
+ // this._getWeek(this.date.fullDate)
+ this.selectDate = this.getDate(date)
+ this._getWeek(this.selectDate.fullDate)
+ * 清理多选状态
+ cleanMultipleStatus() {
+ this.multipleStatus = {
+ before: '',
+ after: '',
+ data: []
+ * 重置开始日期
+ resetSatrtDate(startDate) {
+ * 重置结束日期
+ resetEndDate(endDate) {
+ * 获取任意时间
+ getDate(date, AddDayCount = 0, str = 'day') {
+ if (!date) {
+ date = new Date()
+ if (typeof date !== 'object') {
+ date = date.replace(/-/g, '/')
+ const dd = new Date(date)
+ switch (str) {
+ case 'day':
+ dd.setDate(dd.getDate() + AddDayCount) // 获取AddDayCount天后的日期
+ case 'month':
+ if (dd.getDate() === 31 && AddDayCount>0) {
+ dd.setDate(dd.getDate() + AddDayCount)
+ const preMonth = dd.getMonth()
+ dd.setMonth(preMonth + AddDayCount) // 获取AddDayCount天后的日期
+ const nextMonth = dd.getMonth()
+ // 处理 pre 切换月份目标月份为2月没有当前日(30 31) 切换错误问题
+ if(AddDayCount<0 && preMonth!==0 && nextMonth-preMonth>AddDayCount){
+ dd.setMonth(nextMonth+(nextMonth-preMonth+AddDayCount))
+ // 处理 next 切换月份目标月份为2月没有当前日(30 31) 切换错误问题
+ if(AddDayCount>0 && nextMonth-preMonth>AddDayCount){
+ dd.setMonth(nextMonth-(nextMonth-preMonth-AddDayCount))
+ case 'year':
+ dd.setFullYear(dd.getFullYear() + AddDayCount) // 获取AddDayCount天后的日期
+ const y = dd.getFullYear()
+ const m = dd.getMonth() + 1 < 10 ? '0' + (dd.getMonth() + 1) : dd.getMonth() + 1 // 获取当前月份的日期,不足10补0
+ const d = dd.getDate() < 10 ? '0' + dd.getDate() : dd.getDate() // 获取当前几号,不足10补0
+ fullDate: y + '-' + m + '-' + d,
+ year: y,
+ month: m,
+ date: d,
+ day: dd.getDay()
+ * 获取上月剩余天数
+ _getLastMonthDays(firstDay, full) {
+ let dateArr = []
+ for (let i = firstDay; i > 0; i--) {
+ const beforeDate = new Date(full.year, full.month - 1, -i + 1).getDate()
+ dateArr.push({
+ date: beforeDate,
+ month: full.month - 1,
+ lunar: this.getlunar(full.year, full.month - 1, beforeDate),
+ disable: true
+ return dateArr
+ * 获取本月天数
+ _currentMonthDys(dateData, full) {
+ let fullDate = this.date.fullDate
+ for (let i = 1; i <= dateData; i++) {
+ let nowDate = full.year + '-' + (full.month < 10 ?
+ full.month : full.month) + '-' + (i < 10 ?
+ '0' + i : i)
+ let isDay = fullDate === nowDate
+ // 获取打点信息
+ let info = this.selected && this.selected.find((item) => {
+ if (this.dateEqual(nowDate, item.date)) {
+ return item
+ // 日期禁用
+ let disableBefore = true
+ let disableAfter = true
+ if (this.startDate) {
+ // let dateCompBefore = this.dateCompare(this.startDate, fullDate)
+ // disableBefore = this.dateCompare(dateCompBefore ? this.startDate : fullDate, nowDate)
+ disableBefore = this.dateCompare(this.startDate, nowDate)
+ if (this.endDate) {
+ // let dateCompAfter = this.dateCompare(fullDate, this.endDate)
+ // disableAfter = this.dateCompare(nowDate, dateCompAfter ? this.endDate : fullDate)
+ disableAfter = this.dateCompare(nowDate, this.endDate)
+ let multiples = this.multipleStatus.data
+ let checked = false
+ let multiplesStatus = -1
+ if (this.range) {
+ if (multiples) {
+ multiplesStatus = multiples.findIndex((item) => {
+ return this.dateEqual(item, nowDate)
+ if (multiplesStatus !== -1) {
+ checked = true
+ let data = {
+ fullDate: nowDate,
+ year: full.year,
+ date: i,
+ multiple: this.range ? checked : false,
+ beforeMultiple: this.dateEqual(this.multipleStatus.before, nowDate),
+ afterMultiple: this.dateEqual(this.multipleStatus.after, nowDate),
+ month: full.month,
+ lunar: this.getlunar(full.year, full.month, i),
+ disable: !(disableBefore && disableAfter),
+ isDay
+ if (info) {
+ data.extraInfo = info
+ dateArr.push(data)
+ * 获取下月天数
+ _getNextMonthDays(surplus, full) {
+ for (let i = 1; i < surplus + 1; i++) {
+ month: Number(full.month) + 1,
+ lunar: this.getlunar(full.year, Number(full.month) + 1, i),
+ * 获取当前日期详情
+ getInfo(date) {
+ const dateInfo = this.canlender.find(item => item.fullDate === this.getDate(date).fullDate)
+ return dateInfo
+ * 比较时间大小
+ dateCompare(startDate, endDate) {
+ // 计算截止时间
+ startDate = new Date(startDate.replace('-', '/').replace('-', '/'))
+ // 计算详细项的截止时间
+ endDate = new Date(endDate.replace('-', '/').replace('-', '/'))
+ if (startDate <= endDate) {
+ return true
+ return false
+ * 比较时间是否相等
+ dateEqual(before, after) {
+ before = new Date(before.replace('-', '/').replace('-', '/'))
+ after = new Date(after.replace('-', '/').replace('-', '/'))
+ if (before.getTime() - after.getTime() === 0) {
+ * 获取日期范围内所有日期
+ * @param {Object} begin
+ * @param {Object} end
+ geDateAll(begin, end) {
+ var arr = []
+ var ab = begin.split('-')
+ var ae = end.split('-')
+ var db = new Date()
+ db.setFullYear(ab[0], ab[1] - 1, ab[2])
+ var de = new Date()
+ de.setFullYear(ae[0], ae[1] - 1, ae[2])
+ var unixDb = db.getTime() - 24 * 60 * 60 * 1000
+ var unixDe = de.getTime() - 24 * 60 * 60 * 1000
+ for (var k = unixDb; k <= unixDe;) {
+ k = k + 24 * 60 * 60 * 1000
+ arr.push(this.getDate(new Date(parseInt(k))).fullDate)
+ return arr
+ * 计算阴历日期显示
+ getlunar(year, month, date) {
+ return CALENDAR.solar2lunar(year, month, date)
+ * 设置打点
+ setSelectInfo(data, value) {
+ this.selected = value
+ this._getWeek(data)
+ * 获取多选状态
+ setMultiple(fullDate) {
+ before,
+ after
+ } = this.multipleStatus
+ if (!this.range) return
+ if (before && after) {
+ this.multipleStatus.before = ''
+ this.multipleStatus.after = ''
+ this.multipleStatus.data = []
+ if (!before) {
+ this.multipleStatus.before = fullDate
+ this.multipleStatus.after = fullDate
+ if (this.dateCompare(this.multipleStatus.before, this.multipleStatus.after)) {
+ this.multipleStatus.data = this.geDateAll(this.multipleStatus.before, this.multipleStatus.after);
+ this.multipleStatus.data = this.geDateAll(this.multipleStatus.after, this.multipleStatus.before);
+ this._getWeek(fullDate)
+ * 获取每周数据
+ * @param {Object} dateData
+ _getWeek(dateData) {
+ } = this.getDate(dateData)
+ let firstDay = new Date(year, month - 1, 1).getDay()
+ let currentDay = new Date(year, month, 0).getDate()
+ let dates = {
+ lastMonthDays: this._getLastMonthDays(firstDay, this.getDate(dateData)), // 上个月末尾几天
+ currentMonthDys: this._currentMonthDys(currentDay, this.getDate(dateData)), // 本月天数
+ nextMonthDays: [], // 下个月开始几天
+ weeks: []
+ let canlender = []
+ const surplus = 42 - (dates.lastMonthDays.length + dates.currentMonthDys.length)
+ dates.nextMonthDays = this._getNextMonthDays(surplus, this.getDate(dateData))
+ canlender = canlender.concat(dates.lastMonthDays, dates.currentMonthDys, dates.nextMonthDays)
+ let weeks = {}
+ // 拼接数组 上个月开始几天 + 本月天数+ 下个月开始几天
+ for (let i = 0; i < canlender.length; i++) {
+ if (i % 7 === 0) {
+ weeks[parseInt(i / 7)] = new Array(7)
+ weeks[parseInt(i / 7)][i % 7] = canlender[i]
+ this.canlender = canlender
+ this.weeks = weeks
+ //静态方法
+ // static init(date) {
+ // if (!this.instance) {
+ // this.instance = new Calendar(date);
+ // }
+ // return this.instance;
+export default Calendar
+ "id": "uni-calendar",
+ "displayName": "uni-calendar 日历",
+ "version": "1.4.10",
+ "description": "日历组件",
+ "日历",
+ "打卡",
+ "日历选择"
@@ -0,0 +1,103 @@
+## Calendar 日历
+> **组件名:uni-calendar**
+> 代码块: `uCalendar`
+日历组件
+> **注意事项**
+> 为了避免错误使用,给大家带来不好的开发体验,请在使用组件前仔细阅读下面的注意事项,可以帮你避免一些错误。
+> - 本组件农历转换使用的js是 [@1900-2100区间内的公历、农历互转](https://github.com/jjonline/calendar.js)
+> - 仅支持自定义组件模式
+> - `date`属性传入的应该是一个 String ,如: 2019-06-27 ,而不是 new Date()
+> - 通过 `insert` 属性来确定当前的事件是 @change 还是 @confirm 。理应合并为一个事件,但是为了区分模式,现使用两个事件,这里需要注意
+> - 弹窗模式下无法阻止后面的元素滚动,如有需要阻止,请在弹窗弹出后,手动设置滚动元素为不可滚动
+<view>
+ <uni-calendar
+ :insert="true"
+ :lunar="true"
+ :start-date="'2019-3-2'"
+ :end-date="'2019-5-20'"
+ @change="change"
+ />
+</view>
+### 通过方法打开日历
+需要设置 `insert` 为 `false`
+ ref="calendar"
+ :insert="false"
+ @confirm="confirm"
+ <button @click="open">打开日历</button>
+```javascript
+ open(){
+ this.$refs.calendar.open();
+ confirm(e) {
+ console.log(e);
+};
+### Calendar Props
+| 属性名 | 类型 | 默认值| 说明 |
+| - | - | - | - |
+| date | String |- | 自定义当前时间,默认为今天 |
+| lunar | Boolean | false | 显示农历 |
+| startDate | String |- | 日期选择范围-开始日期 |
+| endDate | String |- | 日期选择范围-结束日期 |
+| range | Boolean | false | 范围选择 |
+| insert | Boolean | false | 插入模式,可选值,ture:插入模式;false:弹窗模式;默认为插入模式 |
+|clearDate |Boolean |true |弹窗模式是否清空上次选择内容 |
+| selected | Array |- | 打点,期待格式[{date: '2019-06-27', info: '签到', data: { custom: '自定义信息', name: '自定义消息头',xxx:xxx... }}] |
+|showMonth | Boolean | true | 是否显示月份为背景 |
+### Calendar Events
+| 事件名 | 说明 |返回值|
+| - | - | - |
+| open | 弹出日历组件,`insert :false` 时生效|- |
+点击查看:[https://hellouniapp.dcloud.net.cn/pages/extUI/calendar/calendar](https://hellouniapp.dcloud.net.cn/pages/extUI/calendar/calendar)
+## 1.3.1(2021-12-20)
+- 修复 在vue页面下略缩图显示不正常的bug
+## 1.3.0(2021-11-19)
+- 重构插槽的用法 ,header 替换为 title
+- 新增 actions 插槽
+- 新增 cover 封面图属性和插槽
+- 新增 padding 内容默认内边距离
+- 新增 margin 卡片默认外边距离
+- 新增 spacing 卡片默认内边距
+- 新增 shadow 卡片阴影属性
+- 取消 mode 属性,可使用组合插槽代替
+- 取消 note 属性 ,使用actions插槽代替
+- 文档迁移,详见:[https://uniapp.dcloud.io/component/uniui/uni-card](https://uniapp.dcloud.io/component/uniui/uni-card)
+## 1.2.1(2021-07-30)
+- 优化 vue3下事件警告的问题
+## 1.2.0(2021-07-13)
+- 组件兼容 vue3,如何创建vue3项目详见 [uni-app 项目支持 vue3 介绍](https://ask.dcloud.net.cn/article/37834)
+## 1.1.8(2021-07-01)
+- 优化 图文卡片无图片加载时,提供占位图标
+- 新增 header 插槽,自定义卡片头部( 图文卡片 mode="style" 时,不支持)
+- 修复 thumbnail 不存在仍然占位的 bug
+## 1.1.7(2021-05-12)
+## 1.1.6(2021-02-04)
@@ -0,0 +1,272 @@
+ <view class="uni-card" :class="{ 'uni-card--full': isFull, 'uni-card--shadow': isShadow,'uni-card--border':border}"
+ :style="{'margin':isFull?0:margin,'padding':spacing,'box-shadow':isShadow?shadow:''}">
+ <!-- 封面 -->
+ <slot name="cover">
+ <view v-if="cover" class="uni-card__cover">
+ <image class="uni-card__cover-image" mode="widthFix" @click="onClick('cover')" :src="cover"></image>
+ </slot>
+ <slot name="title">
+ <view v-if="title || extra" class="uni-card__header">
+ <!-- 卡片标题 -->
+ <view class="uni-card__header-box" @click="onClick('title')">
+ <view v-if="thumbnail" class="uni-card__header-avatar">
+ <image class="uni-card__header-avatar-image" :src="thumbnail" mode="aspectFit" />
+ <view class="uni-card__header-content">
+ <text class="uni-card__header-content-title uni-ellipsis">{{ title }}</text>
+ <text v-if="title&&subTitle"
+ class="uni-card__header-content-subtitle uni-ellipsis">{{ subTitle }}</text>
+ <view class="uni-card__header-extra" @click="onClick('extra')">
+ <slot name="extra">
+ <text class="uni-card__header-extra-text">{{ extra }}</text>
+ <!-- 卡片内容 -->
+ <view class="uni-card__content" :style="{padding:padding}" @click="onClick('content')">
+ <slot></slot>
+ <view class="uni-card__actions" @click="onClick('actions')">
+ <slot name="actions"></slot>
+ * Card 卡片
+ * @description 卡片视图组件
+ * @tutorial https://ext.dcloud.net.cn/plugin?id=22
+ * @property {String} title 标题文字
+ * @property {String} subTitle 副标题
+ * @property {Number} padding 内容内边距
+ * @property {Number} margin 卡片外边距
+ * @property {Number} spacing 卡片内边距
+ * @property {String} extra 标题额外信息
+ * @property {String} cover 封面图(本地路径需要引入)
+ * @property {String} thumbnail 标题左侧缩略图
+ * @property {Boolean} is-full = [true | false] 卡片内容是否通栏,为 true 时将去除padding值
+ * @property {Boolean} is-shadow = [true | false] 卡片内容是否开启阴影
+ * @property {String} shadow 卡片阴影
+ * @property {Boolean} border 卡片边框
+ * @event {Function} click 点击 Card 触发事件
+ name: 'UniCard',
+ title: {
+ subTitle: {
+ padding: {
+ default: '10px'
+ margin: {
+ default: '15px'
+ spacing: {
+ default: '0 10px'
+ extra: {
+ cover: {
+ thumbnail: {
+ isFull: {
+ // 内容区域是否通栏
+ isShadow: {
+ // 是否开启阴影
+ shadow: {
+ default: '0px 0px 3px 1px rgba(0, 0, 0, 0.08)'
+ border: {
+ onClick(type) {
+ this.$emit('click', type)
+ $uni-border-3: #EBEEF5 !default;
+ $uni-shadow-base:0 0px 6px 1px rgba($color: #a5a5a5, $alpha: 0.2) !default;
+ $uni-secondary-color: #909399 !default;
+ $uni-spacing-sm: 8px !default;
+ $uni-border-color:$uni-border-3;
+ $uni-shadow: $uni-shadow-base;
+ $uni-card-title: 15px;
+ $uni-cart-title-color:$uni-main-color;
+ $uni-card-subtitle: 12px;
+ $uni-cart-subtitle-color:$uni-secondary-color;
+ $uni-card-spacing: 10px;
+ $uni-card-content-color: $uni-base-color;
+ .uni-card {
+ margin: $uni-card-spacing;
+ padding: 0 $uni-spacing-sm;
+ border-radius: 4px;
+ font-family: Helvetica Neue, Helvetica, PingFang SC, Hiragino Sans GB, Microsoft YaHei, SimSun, sans-serif;
+ .uni-card__cover {
+ margin-top: $uni-card-spacing;
+ .uni-card__cover-image {
+ // width: 100%;
+ /* #ifndef APP-PLUS */
+ vertical-align: middle;
+ .uni-card__header {
+ border-bottom: 1px $uni-border-color solid;
+ padding: $uni-card-spacing;
+ .uni-card__header-box {
+ .uni-card__header-avatar {
+ width: 40px;
+ height: 40px;
+ border-radius: 5px;
+ margin-right: $uni-card-spacing;
+ .uni-card__header-avatar-image {
+ .uni-card__header-content {
+ // height: 40px;
+ .uni-card__header-content-title {
+ font-size: $uni-card-title;
+ color: $uni-cart-title-color;
+ // line-height: 22px;
+ .uni-card__header-content-subtitle {
+ font-size: $uni-card-subtitle;
+ margin-top: 5px;
+ color: $uni-cart-subtitle-color;
+ .uni-card__header-extra {
+ line-height: 12px;
+ .uni-card__header-extra-text {
+ .uni-card__content {
+ color: $uni-card-content-color;
+ line-height: 22px;
+ .uni-card__actions {
+ .uni-card--border {
+ border: 1px solid $uni-border-color;
+ .uni-card--shadow {
+ box-shadow: $uni-shadow;
+ .uni-card--full {
+ margin: 0;
+ border-left-width: 0;
+ border-radius: 0;
+ .uni-card--full:after {
+ .uni-ellipsis {
+ text-overflow: ellipsis;
+ lines: 1;
@@ -0,0 +1,90 @@
+ "id": "uni-card",
+ "displayName": "uni-card 卡片",
+ "version": "1.3.1",
+ "description": "Card 组件,提供常见的卡片样式。",
+ "card",
+ "卡片"
+ "npmurl": "https://www.npmjs.com/package/@dcloudio/uni-ui"
+ "dependencies": [
+ "uni-icons",
+ "uni-scss"
+## Card 卡片
+> **组件名:uni-card**
+> 代码块: `uCard`
+卡片视图组件。
+### [查看文档](https://uniapp.dcloud.io/component/uniui/uni-card)
@@ -0,0 +1,36 @@
+## 1.4.3(2022-01-25)
+- 修复 初始化的时候 ,open 属性失效的bug
+## 1.4.2(2022-01-21)
+- 修复 微信小程序resize后组件收起的bug
+## 1.4.1(2021-11-22)
+- 修复 vue3中个别scss变量无法找到的问题
+## 1.4.0(2021-11-19)
+- 文档迁移,详见:[https://uniapp.dcloud.io/component/uniui/uni-collapse](https://uniapp.dcloud.io/component/uniui/uni-collapse)
+## 1.3.3(2021-08-17)
+- 优化 show-arrow 属性默认为true
+## 1.3.2(2021-08-17)
+- 新增 show-arrow 属性,控制是否显示右侧箭头
+## 1.3.1(2021-07-30)
+- 优化 vue3下小程序事件警告的问题
+## 1.3.0(2021-07-30)
+## 1.2.2(2021-07-21)
+- 修复 由1.2.0版本引起的 change 事件返回 undefined 的Bug
+## 1.2.1(2021-07-21)
+- 优化 组件示例
+## 1.2.0(2021-07-21)
+- 新增 组件折叠动画
+- 新增 value\v-model 属性 ,动态修改面板折叠状态
+- 新增 title 插槽 ,可定义面板标题
+- 新增 border 属性 ,显示隐藏面板内容分隔线
+- 新增 title-border 属性 ,显示隐藏面板标题分隔线
+- 修复 resize 方法失效的Bug
+- 修复 change 事件返回参数不正确的Bug
+- 优化 H5、App 平台自动更具内容更新高度,无需调用 reszie() 方法
+## 1.1.6(2021-02-05)
+- 优化 组件引用关系,通过uni_modules引用组件
+## 1.1.5(2021-02-05)
@@ -0,0 +1,402 @@
+ <view class="uni-collapse-item">
+ <!-- onClick(!isOpen) -->
+ <view @click="onClick(!isOpen)" class="uni-collapse-item__title"
+ :class="{'is-open':isOpen &&titleBorder === 'auto' ,'uni-collapse-item-border':titleBorder !== 'none'}">
+ <view class="uni-collapse-item__title-wrap">
+ <view class="uni-collapse-item__title-box" :class="{'is-disabled':disabled}">
+ <image v-if="thumb" :src="thumb" class="uni-collapse-item__title-img" />
+ <text class="uni-collapse-item__title-text">{{ title }}</text>
+ <view v-if="showArrow"
+ :class="{ 'uni-collapse-item__title-arrow-active': isOpen, 'uni-collapse-item--animation': showAnimation === true }"
+ class="uni-collapse-item__title-arrow">
+ <uni-icons :color="disabled?'#ddd':'#bbb'" size="14" type="bottom" />
+ <view class="uni-collapse-item__wrap" :class="{'is--transition':showAnimation}"
+ :style="{height: (isOpen?height:0) +'px'}">
+ <view :id="elId" ref="collapse--hook" class="uni-collapse-item__wrap-content"
+ :class="{open:isheight,'uni-collapse-item--border':border&&isOpen}">
+ // #ifdef APP-NVUE
+ const dom = weex.requireModule('dom')
+ // #endif
+ * CollapseItem 折叠面板子组件
+ * @description 折叠面板子组件
+ * @property {String} thumb 标题左侧缩略图
+ * @property {String} name 唯一标志符
+ * @property {Boolean} open = [true|false] 是否展开组件
+ * @property {Boolean} titleBorder = [true|false] 是否显示标题分隔线
+ * @property {Boolean} border = [true|false] 是否显示分隔线
+ * @property {Boolean} disabled = [true|false] 是否展开面板
+ * @property {Boolean} showAnimation = [true|false] 开启动画
+ * @property {Boolean} showArrow = [true|false] 是否显示右侧箭头
+ name: 'uniCollapseItem',
+ // 列表标题
+ name: {
+ type: [Number, String],
+ // 是否禁用
+ disabled: {
+ // #ifdef APP-PLUS
+ // 是否显示动画,app 端默认不开启动画,卡顿严重
+ showAnimation: {
+ // #ifndef APP-PLUS
+ // 是否显示动画
+ // 是否展开
+ open: {
+ // 缩略图
+ thumb: {
+ // 标题分隔线显示类型
+ titleBorder: {
+ default: 'auto'
+ showArrow: {
+ // TODO 随机生生元素ID,解决百度小程序获取同一个元素位置信息的bug
+ const elId = `Uni_${Math.ceil(Math.random() * 10e5).toString(36)}`
+ isOpen: false,
+ isheight: null,
+ height: 0,
+ elId,
+ nameSync: 0
+ open(val) {
+ this.isOpen = val
+ this.onClick(val, 'init')
+ updated(e) {
+ this.init(true)
+ this.collapse = this.getCollapse()
+ this.oldHeight = 0
+ this.onClick(this.open, 'init')
+ // #ifndef VUE3
+ // TODO vue2
+ destroyed() {
+ if (this.__isUnmounted) return
+ this.uninstall()
+ // #ifdef VUE3
+ // TODO vue3
+ unmounted() {
+ this.__isUnmounted = true
+ mounted() {
+ if (!this.collapse) return
+ if (this.name !== '') {
+ this.nameSync = this.name
+ this.nameSync = this.collapse.childrens.length + ''
+ if (this.collapse.names.indexOf(this.nameSync) === -1) {
+ this.collapse.names.push(this.nameSync)
+ console.warn(`name 值 ${this.nameSync} 重复`);
+ if (this.collapse.childrens.indexOf(this) === -1) {
+ this.collapse.childrens.push(this)
+ this.init()
+ init(type) {
+ // #ifndef APP-NVUE
+ this.getCollapseHeight(type)
+ this.getNvueHwight(type)
+ uninstall() {
+ if (this.collapse) {
+ this.collapse.childrens.forEach((item, index) => {
+ if (item === this) {
+ this.collapse.childrens.splice(index, 1)
+ this.collapse.names.forEach((item, index) => {
+ if (item === this.nameSync) {
+ this.collapse.names.splice(index, 1)
+ onClick(isOpen, type) {
+ if (this.disabled) return
+ this.isOpen = isOpen
+ if (this.isOpen && this.collapse) {
+ this.collapse.setAccordion(this)
+ if (type !== 'init') {
+ this.collapse.onChange(isOpen, this)
+ getCollapseHeight(type, index = 0) {
+ const views = uni.createSelectorQuery().in(this)
+ views
+ .select(`#${this.elId}`)
+ .fields({
+ size: true
+ }, data => {
+ // TODO 百度中可能获取不到节点信息 ,需要循环获取
+ if (index >= 10) return
+ if (!data) {
+ index++
+ this.getCollapseHeight(false, index)
+ this.height = data.height + 1
+ this.height = data.height
+ this.isheight = true
+ if (type) return
+ this.onClick(this.isOpen, 'init')
+ .exec()
+ getNvueHwight(type) {
+ const result = dom.getComponentRect(this.$refs['collapse--hook'], option => {
+ if (option && option.result && option.size) {
+ this.height = option.size.height + 1
+ this.height = option.size.height
+ * 获取父元素实例
+ getCollapse(name = 'uniCollapse') {
+ let parent = this.$parent;
+ let parentName = parent.$options.name;
+ while (parentName !== name) {
+ parent = parent.$parent;
+ if (!parent) return false;
+ parentName = parent.$options.name;
+ return parent;
+ .uni-collapse-item {
+ &__title {
+ width: 100%;
+ transition: border-bottom-color .3s;
+ // transition-property: border-bottom-color;
+ // transition-duration: 5s;
+ &-wrap {
+ &-box {
+ padding: 0 15px;
+ height: 48px;
+ line-height: 48px;
+ color: #303133;
+ font-size: 13px;
+ font-weight: 500;
+ outline: none;
+ &.is-disabled {
+ .uni-collapse-item__title-text {
+ color: #999;
+ &.uni-collapse-item-border {
+ border-bottom: 1px solid #ebeef5;
+ &.is-open {
+ border-bottom-color: transparent;
+ &-img {
+ height: 22px;
+ width: 22px;
+ margin-right: 10px;
+ &-text {
+ color: inherit;
+ &-arrow {
+ width: 20px;
+ transform: rotate(0deg);
+ &-active {
+ transform: rotate(-180deg);
+ &__wrap {
+ will-change: height;
+ height: 0;
+ &.is--transition {
+ // transition: all 0.3s;
+ transition-property: height, border-bottom-width;
+ &-content {
+ // transition: height 0.3s;
+ border-bottom-width: 0;
+ &.uni-collapse-item--border {
+ border-bottom-color: red;
+ border-bottom-color: #ebeef5;
+ &.open {
+ &--animation {
+ transition-timing-function: ease;
@@ -0,0 +1,147 @@
+ <view class="uni-collapse">
+ * Collapse 折叠面板
+ * @description 展示可以折叠 / 展开的内容区域
+ * @tutorial https://ext.dcloud.net.cn/plugin?id=23
+ * @property {String|Array} value 当前激活面板改变时触发(如果是手风琴模式,参数类型为string,否则为array)
+ * @property {Boolean} accordion = [true|false] 是否开启手风琴效果是否开启手风琴效果
+ * @event {Function} change 切换面板时触发,如果是手风琴模式,返回类型为string,否则为array
+ name: 'uniCollapse',
+ emits:['change','activeItem','input','update:modelValue'],
+ value: {
+ type: [String, Array],
+ modelValue: {
+ accordion: {
+ // 是否开启手风琴效果
+ type: [Boolean, String],
+ // TODO 兼容 vue2 和 vue3
+ dataValue() {
+ let value = (typeof this.value === 'string' && this.value === '') ||
+ (Array.isArray(this.value) && this.value.length === 0)
+ let modelValue = (typeof this.modelValue === 'string' && this.modelValue === '') ||
+ (Array.isArray(this.modelValue) && this.modelValue.length === 0)
+ if (value) {
+ return this.modelValue
+ if (modelValue) {
+ return this.value
+ dataValue(val) {
+ this.setOpen(val)
+ this.childrens = []
+ this.names = []
+ this.$nextTick(()=>{
+ this.setOpen(this.dataValue)
+ setOpen(val) {
+ let str = typeof val === 'string'
+ let arr = Array.isArray(val)
+ this.childrens.forEach((vm, index) => {
+ if (str) {
+ if (val === vm.nameSync) {
+ if (!this.accordion) {
+ console.warn('accordion 属性为 false ,v-model 类型应该为 array')
+ vm.isOpen = true
+ if (arr) {
+ val.forEach(v => {
+ if (v === vm.nameSync) {
+ if (this.accordion) {
+ console.warn('accordion 属性为 true ,v-model 类型应该为 string')
+ this.emit(val)
+ setAccordion(self) {
+ if (!this.accordion) return
+ if (self !== vm) {
+ vm.isOpen = false
+ resize() {
+ vm.getCollapseHeight()
+ vm.getNvueHwight()
+ onChange(isOpen, self) {
+ let activeItem = []
+ activeItem = isOpen ? self.nameSync : ''
+ if (vm.isOpen) {
+ activeItem.push(vm.nameSync)
+ this.$emit('change', activeItem)
+ this.emit(activeItem)
+ emit(val){
+ this.$emit('input', val)
+ this.$emit('update:modelValue', val)
+ .uni-collapse {
@@ -0,0 +1,89 @@
+ "id": "uni-collapse",
+ "displayName": "uni-collapse 折叠面板",
+ "version": "1.4.3",
+ "description": "Collapse 组件,可以折叠 / 展开的内容区域。",
+ "折叠",
+ "折叠面板",
+ "手风琴"
+ "uni-scss",
+ "uni-icons"
+## Collapse 折叠面板
+> **组件名:uni-collapse**
+> 代码块: `uCollapse`
+> 关联组件:`uni-collapse-item`、`uni-icons`。
+折叠面板用来折叠/显示过长的内容或者是列表。通常是在多内容分类项使用,折叠不重要的内容,显示重要内容。点击可以展开折叠部分。
+### [查看文档](https://uniapp.dcloud.io/component/uniui/uni-collapse)
@@ -0,0 +1,15 @@
+## 1.0.1(2021-11-23)
+- 优化 label、label-width 属性
+## 1.0.0(2021-11-19)
+- 文档迁移,详见:[https://uniapp.dcloud.io/component/uniui/uni-combox](https://uniapp.dcloud.io/component/uniui/uni-combox)
+## 0.1.0(2021-07-30)
+## 0.0.6(2021-05-12)
+## 0.0.5(2021-04-21)
+- 优化 添加依赖 uni-icons, 导入后自动下载依赖
+## 0.0.4(2021-02-05)
+## 0.0.3(2021-02-04)
@@ -0,0 +1,294 @@
+ <view class="uni-combox" :class="border ? '' : 'uni-combox__no-border'">
+ <view v-if="label" class="uni-combox__label" :style="labelStyle">
+ <text>{{label}}</text>
+ <view class="uni-combox__input-box">
+ <input class="uni-combox__input" type="text" :placeholder="placeholder"
+ placeholder-class="uni-combox__input-plac" v-model="inputVal" @input="onInput" @focus="onFocus" @blur="onBlur" />
+ <uni-icons :type="showSelector? 'top' : 'bottom'" size="14" color="#999" @click="toggleSelector">
+ </uni-icons>
+ <view class="uni-combox__selector" v-if="showSelector">
+ <view class="uni-popper__arrow"></view>
+ <scroll-view scroll-y="true" class="uni-combox__selector-scroll" @scroll="onScroll">
+ <view class="uni-combox__selector-empty" v-if="filterCandidatesLength === 0">
+ <text>{{emptyTips}}</text>
+ <view class="uni-combox__selector-item" v-for="(item,index) in filterCandidates" :key="index" @click="onSelectorClick(index)">
+ <text>{{item}}</text>
+ </scroll-view>
+ <!-- 新增蒙层,点击蒙层时关闭选项显示 -->
+ <view class="uni-combox__mask" v-show="showSelector" @click="showSelector = false"></view>
+ * Combox 组合输入框
+ * @description 组合输入框一般用于既可以输入也可以选择的场景
+ * @tutorial https://ext.dcloud.net.cn/plugin?id=1261
+ * @property {String} label 左侧文字
+ * @property {String} labelWidth 左侧内容宽度
+ * @property {String} placeholder 输入框占位符
+ * @property {Array} candidates 候选项列表
+ * @property {String} emptyTips 筛选结果为空时显示的文字
+ * @property {String} value 组合框的值
+ name: 'uniCombox',
+ emits: ['input', 'update:modelValue'],
+ label: {
+ labelWidth: {
+ placeholder: {
+ candidates: {
+ emptyTips: {
+ default: '无匹配项'
+ showSelector: false,
+ inputVal: '',
+ blurTimer:null,
+ labelStyle() {
+ if (this.labelWidth === 'auto') {
+ return ""
+ return `width: ${this.labelWidth}`
+ filterCandidates() {
+ if (this.inputVal !== 0 && !this.inputVal) {
+ return this.candidates
+ return this.candidates.filter((item) => {
+ return item.toString().indexOf(this.inputVal) > -1
+ filterCandidatesLength() {
+ return this.filterCandidates.length
+ handler(newVal) {
+ this.inputVal = newVal
+ immediate: true
+ toggleSelector() {
+ this.showSelector = !this.showSelector
+ onFocus() {
+ this.showSelector = true
+ onBlur() {
+ this.blurTimer = setTimeout(() => {
+ this.showSelector = false
+ }, 153)
+ onScroll(){ // 滚动时将blur的定时器关掉
+ if(this.blurTimer) {
+ clearTimeout(this.blurTimer)
+ this.blurTimer = null
+ onSelectorClick(index) {
+ this.inputVal = this.filterCandidates[index]
+ this.$emit('input', this.inputVal)
+ this.$emit('update:modelValue', this.inputVal)
+ onInput() {
+ .uni-combox {
+ border: 1px solid #DCDFE6;
+ padding: 6px 10px;
+ // border-bottom: solid 1px #DDDDDD;
+ .uni-combox__label {
+ font-size: 16px;
+ padding-right: 10px;
+ color: #999999;
+ .uni-combox__input-box {
+ .uni-combox__input {
+ .uni-combox__input-plac {
+ .uni-combox__selector {
+ top: calc(100% + 12px);
+ background-color: #FFFFFF;
+ border: 1px solid #EBEEF5;
+ border-radius: 6px;
+ box-shadow: 0 2px 12px 0 rgba(0, 0, 0, 0.1);
+ z-index: 3;
+ padding: 4px 0;
+ .uni-combox__selector-scroll {
+ max-height: 200px;
+ .uni-combox__selector-empty,
+ .uni-combox__selector-item {
+ line-height: 36px;
+ padding: 0px 10px;
+ .uni-combox__selector-item:hover {
+ background-color: #f9f9f9;
+ .uni-combox__selector-empty:last-child,
+ .uni-combox__selector-item:last-child {
+ border-bottom: none;
+ // picker 弹出层通用的指示小三角
+ .uni-popper__arrow,
+ .uni-popper__arrow::after {
+ display: block;
+ width: 0;
+ border-color: transparent;
+ border-style: solid;
+ border-width: 6px;
+ .uni-popper__arrow {
+ filter: drop-shadow(0 2px 12px rgba(0, 0, 0, 0.03));
+ top: -6px;
+ left: 10%;
+ margin-right: 3px;
+ border-top-width: 0;
+ border-bottom-color: #EBEEF5;
+ content: " ";
+ top: 1px;
+ margin-left: -6px;
+ border-bottom-color: #fff;
+ .uni-combox__no-border {
+ border: none;
+ .uni-combox__mask {
+ width:100%;
+ height:100%;
+ z-index: 1;
+ "id": "uni-combox",
+ "displayName": "uni-combox 组合框",
+ "version": "1.0.1",
+ "description": "可以选择也可以输入的表单项 ",
+ "combox",
+ "组合框",
+ "select"
@@ -0,0 +1,11 @@
+## Combox 组合框
+> **组件名:uni-combox**
+> 代码块: `uCombox`
+组合框组件。
+### [查看文档](https://uniapp.dcloud.io/component/uniui/uni-combox)
@@ -0,0 +1,24 @@
+## 1.2.2(2022-01-19)
+- 修复 在微信小程序中样式不生效的bug
+## 1.2.1(2022-01-18)
+- 新增 update 方法 ,在动态更新时间后,刷新组件
+- 文档迁移,详见:[https://uniapp.dcloud.io/component/uniui/uni-countdown](https://uniapp.dcloud.io/component/uniui/uni-countdown)
+## 1.1.3(2021-10-18)
+- 重构
+- 新增 font-size 支持自定义字体大小
+## 1.1.2(2021-08-24)
+## 1.1.1(2021-07-30)
+## 1.1.0(2021-07-30)
+## 1.0.5(2021-06-18)
+- 修复 uni-countdown 重复赋值跳两秒的 bug
+## 1.0.4(2021-05-12)
+## 1.0.3(2021-05-08)
+- 修复 uni-countdown 不能控制倒计时的 bug
+## 1.0.2(2021-02-04)
+ "uni-countdown.day": "day",
+ "uni-countdown.h": "h",
+ "uni-countdown.m": "m",
+ "uni-countdown.s": "s"
+ "uni-countdown.day": "天",
+ "uni-countdown.h": "时",
+ "uni-countdown.m": "分",
+ "uni-countdown.s": "秒"
+ "uni-countdown.h": "時",
@@ -0,0 +1,267 @@
+ <view class="uni-countdown">
+ <text v-if="showDay" :style="[timeStyle]" class="uni-countdown__number">{{ d }}</text>
+ <text v-if="showDay" :style="[splitorStyle]" class="uni-countdown__splitor">{{dayText}}</text>
+ <text :style="[timeStyle]" class="uni-countdown__number">{{ h }}</text>
+ <text :style="[splitorStyle]" class="uni-countdown__splitor">{{ showColon ? ':' : hourText }}</text>
+ <text :style="[timeStyle]" class="uni-countdown__number">{{ i }}</text>
+ <text :style="[splitorStyle]" class="uni-countdown__splitor">{{ showColon ? ':' : minuteText }}</text>
+ <text :style="[timeStyle]" class="uni-countdown__number">{{ s }}</text>
+ <text v-if="!showColon" :style="[splitorStyle]" class="uni-countdown__splitor">{{secondText}}</text>
+ import {
+ initVueI18n
+ } from '@dcloudio/uni-i18n'
+ import messages from './i18n/index.js'
+ t
+ } = initVueI18n(messages)
+ * Countdown 倒计时
+ * @description 倒计时组件
+ * @tutorial https://ext.dcloud.net.cn/plugin?id=25
+ * @property {String} backgroundColor 背景色
+ * @property {String} color 文字颜色
+ * @property {Number} day 天数
+ * @property {Number} hour 小时
+ * @property {Number} minute 分钟
+ * @property {Number} second 秒
+ * @property {Number} timestamp 时间戳
+ * @property {Boolean} showDay = [true|false] 是否显示天数
+ * @property {Boolean} show-colon = [true|false] 是否以冒号为分隔符
+ * @property {String} splitorColor 分割符号颜色
+ * @event {Function} timeup 倒计时时间到触发事件
+ * @example <uni-countdown :day="1" :hour="1" :minute="12" :second="40"></uni-countdown>
+ name: 'UniCountdown',
+ emits: ['timeup'],
+ showDay: {
+ showColon: {
+ start: {
+ backgroundColor: {
+ color: {
+ default: '#333'
+ fontSize: {
+ default: 14
+ splitorColor: {
+ day: {
+ default: 0
+ hour: {
+ minute: {
+ second: {
+ timestamp: {
+ zeroPad: {
+ timer: null,
+ syncFlag: false,
+ d: '00',
+ h: '00',
+ i: '00',
+ s: '00',
+ leftTime: 0,
+ seconds: 0
+ dayText() {
+ return t("uni-countdown.day")
+ hourText(val) {
+ return t("uni-countdown.h")
+ minuteText(val) {
+ return t("uni-countdown.m")
+ secondText(val) {
+ return t("uni-countdown.s")
+ timeStyle() {
+ color,
+ backgroundColor,
+ fontSize
+ fontSize: `${fontSize}px`,
+ width: `${fontSize * 22 / 14}px`, // 按字体大小为 14px 时的比例缩放
+ lineHeight: `${fontSize * 20 / 14}px`,
+ borderRadius: `${fontSize * 3 / 14}px`,
+ splitorStyle() {
+ const { splitorColor, fontSize, backgroundColor } = this
+ color: splitorColor,
+ fontSize: `${fontSize * 12 / 14}px`,
+ margin: backgroundColor ? `${fontSize * 4 / 14}px` : ''
+ day(val) {
+ this.changeFlag()
+ hour(val) {
+ minute(val) {
+ second(val) {
+ immediate: true,
+ handler(newVal, oldVal) {
+ if (newVal) {
+ this.startData();
+ if (!oldVal) return
+ clearInterval(this.timer)
+ created: function(e) {
+ this.seconds = this.toSeconds(this.timestamp, this.day, this.hour, this.minute, this.second)
+ this.countDown()
+ toSeconds(timestamp, day, hours, minutes, seconds) {
+ if (timestamp) {
+ return timestamp - parseInt(new Date().getTime() / 1000, 10)
+ return day * 60 * 60 * 24 + hours * 60 * 60 + minutes * 60 + seconds
+ timeUp() {
+ this.$emit('timeup')
+ countDown() {
+ let seconds = this.seconds
+ let [day, hour, minute, second] = [0, 0, 0, 0]
+ if (seconds > 0) {
+ day = Math.floor(seconds / (60 * 60 * 24))
+ hour = Math.floor(seconds / (60 * 60)) - (day * 24)
+ minute = Math.floor(seconds / 60) - (day * 24 * 60) - (hour * 60)
+ second = Math.floor(seconds) - (day * 24 * 60 * 60) - (hour * 60 * 60) - (minute * 60)
+ this.timeUp()
+ day = (day < 10 && this.zeroPad) ? `0${day}` : day
+ hour = (hour < 10 && this.zeroPad) ? `0${hour}` : hour
+ minute = (minute < 10 && this.zeroPad) ? `0${minute}` : minute
+ second = (second < 10 && this.zeroPad) ? `0${second}` : second
+ this.d = day
+ this.h = hour
+ this.i = minute
+ this.s = second
+ startData() {
+ if (this.seconds <= 0) {
+ this.seconds = this.toSeconds(0, 0, 0, 0, 0)
+ this.timer = setInterval(() => {
+ this.seconds--
+ if (this.seconds < 0) {
+ }, 1000)
+ update(){
+ changeFlag() {
+ if (!this.syncFlag) {
+ this.syncFlag = true;
+ $font-size: 14px;
+ .uni-countdown {
+ justify-content: flex-start;
+ &__splitor {
+ margin: 0 2px;
+ font-size: $font-size;
+ color: #333;
+ &__number {
+ border-radius: 3px;
@@ -0,0 +1,86 @@
+ "id": "uni-countdown",
+ "displayName": "uni-countdown 倒计时",
+ "description": "CountDown 倒计时组件",
+ "countdown",
+ "倒计时"
+## CountDown 倒计时
+> **组件名:uni-countdown**
+> 代码块: `uCountDown`
+倒计时组件。
+### [查看文档](https://uniapp.dcloud.io/component/uniui/uni-countdown)
@@ -0,0 +1,45 @@
+## 1.0.3(2022-09-16)
+- 可以使用 uni-scss 控制主题色
+## 1.0.2(2022-06-30)
+- 优化 在 uni-forms 中的依赖注入方式
+## 1.0.1(2022-02-07)
+- 修复 multiple 为 true 时,v-model 的值为 null 报错的 bug
+- 文档迁移,详见:[https://uniapp.dcloud.io/component/uniui/uni-data-checkbox](https://uniapp.dcloud.io/component/uniui/uni-data-checkbox)
+## 0.2.5(2021-08-23)
+- 修复 在uni-forms中 modelValue 中不存在当前字段,当前字段必填写也不参与校验的问题
+## 0.2.4(2021-08-17)
+- 修复 单选 list 模式下 ,icon 为 left 时,选中图标不显示的问题
+## 0.2.3(2021-08-11)
+- 修复 在 uni-forms 中重置表单,错误信息无法清除的问题
+## 0.2.2(2021-07-30)
+- 优化 在uni-forms组件,与label不对齐的问题
+## 0.2.1(2021-07-27)
+- 修复 单选默认值为0不能选中的Bug
+## 0.2.0(2021-07-13)
+## 0.1.11(2021-07-06)
+- 优化 删除无用日志
+## 0.1.10(2021-07-05)
+- 修复 由 0.1.9 引起的非 nvue 端图标不显示的问题
+## 0.1.9(2021-07-05)
+- 修复 nvue 黑框样式问题
+## 0.1.8(2021-06-28)
+- 修复 selectedTextColor 属性不生效的Bug
+## 0.1.7(2021-06-02)
+- 新增 map 属性,可以方便映射text/value属性
+## 0.1.6(2021-05-26)
+- 修复 不关联服务空间的情况下组件报错的Bug
+## 0.1.5(2021-05-12)
+## 0.1.4(2021-04-09)
+- 修复 nvue 下无法选中的问题
+## 0.1.3(2021-03-22)
+- 新增 disabled属性
+## 0.1.2(2021-02-24)
+- 优化 默认颜色显示
+## 0.1.1(2021-02-24)
+- 新增 支持nvue
+## 0.1.0(2021-02-18)
+- “暂无数据”显示居中
@@ -0,0 +1,821 @@
+ <view class="uni-data-checklist" :style="{'margin-top':isTop+'px'}">
+ <template v-if="!isLocal">
+ <view class="uni-data-loading">
+ <uni-load-more v-if="!mixinDatacomErrorMessage" status="loading" iconType="snow" :iconSize="18" :content-text="contentText"></uni-load-more>
+ <text v-else>{{mixinDatacomErrorMessage}}</text>
+ </template>
+ <template v-else>
+ <checkbox-group v-if="multiple" class="checklist-group" :class="{'is-list':mode==='list' || wrap}" @change="chagne">
+ <label class="checklist-box" :class="['is--'+mode,item.selected?'is-checked':'',(disabled || !!item.disabled)?'is-disable':'',index!==0&&mode==='list'?'is-list-border':'']"
+ :style="item.styleBackgroud" v-for="(item,index) in dataList" :key="index">
+ <checkbox class="hidden" hidden :disabled="disabled || !!item.disabled" :value="item[map.value]+''" :checked="item.selected" />
+ <view v-if="(mode !=='tag' && mode !== 'list') || ( mode === 'list' && icon === 'left')" class="checkbox__inner" :style="item.styleIcon">
+ <view class="checkbox__inner-icon"></view>
+ <view class="checklist-content" :class="{'list-content':mode === 'list' && icon ==='left'}">
+ <text class="checklist-text" :style="item.styleIconText">{{item[map.text]}}</text>
+ <view v-if="mode === 'list' && icon === 'right'" class="checkobx__list" :style="item.styleBackgroud"></view>
+ </label>
+ </checkbox-group>
+ <radio-group v-else class="checklist-group" :class="{'is-list':mode==='list','is-wrap':wrap}" @change="chagne">
+ <!-- -->
+ <radio class="hidden" hidden :disabled="disabled || item.disabled" :value="item[map.value]+''" :checked="item.selected" />
+ <view v-if="(mode !=='tag' && mode !== 'list') || ( mode === 'list' && icon === 'left')" class="radio__inner"
+ :style="item.styleBackgroud">
+ <view class="radio__inner-icon" :style="item.styleIcon"></view>
+ <view v-if="mode === 'list' && icon === 'right'" :style="item.styleRightIcon" class="checkobx__list"></view>
+ </radio-group>
+ * DataChecklist 数据选择器
+ * @description 通过数据渲染 checkbox 和 radio
+ * @property {String} mode = [default| list | button | tag] 显示模式
+ * @value default 默认横排模式
+ * @value list 列表模式
+ * @value button 按钮模式
+ * @value tag 标签模式
+ * @property {Boolean} multiple = [true|false] 是否多选
+ * @property {Array|String|Number} value 默认值
+ * @property {Array} localdata 本地数据 ,格式 [{text:'',value:''}]
+ * @property {Number|String} min 最小选择个数 ,multiple为true时生效
+ * @property {Number|String} max 最大选择个数 ,multiple为true时生效
+ * @property {Boolean} wrap 是否换行显示
+ * @property {String} icon = [left|right] list 列表模式下icon显示位置
+ * @property {Boolean} selectedColor 选中颜色
+ * @property {Boolean} emptyText 没有数据时显示的文字 ,本地数据无效
+ * @property {Boolean} selectedTextColor 选中文本颜色,如不填写则自动显示
+ * @property {Object} map 字段映射, 默认 map={text:'text',value:'value'}
+ * @value left 左侧显示
+ * @value right 右侧显示
+ * @event {Function} change 选中发生变化触发
+ name: 'uniDataChecklist',
+ mixins: [uniCloud.mixinDatacom || {}],
+ emits:['input','update:modelValue','change'],
+ mode: {
+ default: 'default'
+ multiple: {
+ type: [Array, String, Number],
+ return ''
+ default() {
+ return '';
+ localdata: {
+ min: {
+ max: {
+ wrap: {
+ icon: {
+ default: 'left'
+ selectedColor: {
+ selectedTextColor: {
+ emptyText:{
+ default: '暂无数据'
+ disabled:{
+ map:{
+ default(){
+ text:'text',
+ value:'value'
+ this.range = newVal
+ this.dataList = this.getDataList(this.getSelectedValue(newVal))
+ deep: true
+ mixinDatacomResData(newVal) {
+ value(newVal) {
+ this.dataList = this.getDataList(newVal)
+ // fix by mehaotian is_reset 在 uni-forms 中定义
+ // if(!this.is_reset){
+ // this.is_reset = false
+ // this.formItem && this.formItem.setValue(newVal)
+ modelValue(newVal) {
+ this.dataList = this.getDataList(newVal);
+ dataList: [],
+ range: [],
+ contentText: {
+ contentdown: '查看更多',
+ contentrefresh: '加载中',
+ contentnomore: '没有更多'
+ isLocal:true,
+ styles: {
+ selectedColor: '#2979ff',
+ selectedTextColor: '#666',
+ isTop:0
+ dataValue(){
+ if(this.value === '')return this.modelValue
+ if(this.modelValue === '') return this.value
+ // this.form = this.getForm('uniForms')
+ // this.formItem = this.getForm('uniFormsItem')
+ // this.formItem && this.formItem.setValue(this.value)
+ // if (this.formItem) {
+ // this.isTop = 6
+ // if (this.formItem.name) {
+ // // 如果存在name添加默认值,否则formData 中不存在这个字段不校验
+ // this.formItem.setValue(this.dataValue)
+ // this.rename = this.formItem.name
+ // this.form.inputChildrens.push(this)
+ if (this.localdata && this.localdata.length !== 0) {
+ this.isLocal = true
+ this.range = this.localdata
+ this.dataList = this.getDataList(this.getSelectedValue(this.range))
+ if (this.collection) {
+ this.isLocal = false
+ this.loadData()
+ loadData() {
+ this.mixinDatacomGet().then(res=>{
+ this.mixinDatacomResData = res.result.data
+ if(this.mixinDatacomResData.length === 0){
+ this.mixinDatacomErrorMessage = this.emptyText
+ }).catch(err=>{
+ this.mixinDatacomErrorMessage = err.message
+ getForm(name = 'uniForms') {
+ if (!parent) return false
+ chagne(e) {
+ const values = e.detail.value
+ let detail = {
+ value: [],
+ if (this.multiple) {
+ this.range.forEach(item => {
+ if (values.includes(item[this.map.value] + '')) {
+ detail.value.push(item[this.map.value])
+ detail.data.push(item)
+ const range = this.range.find(item => (item[this.map.value] + '') === values)
+ if (range) {
+ detail = {
+ value: range[this.map.value],
+ data: range
+ // this.formItem && this.formItem.setValue(detail.value)
+ // TODO 兼容 vue2
+ this.$emit('input', detail.value);
+ // // TOTO 兼容 vue3
+ this.$emit('update:modelValue', detail.value);
+ this.$emit('change', {
+ detail
+ // 如果 v-model 没有绑定 ,则走内部逻辑
+ // if (this.value.length === 0) {
+ this.dataList = this.getDataList(detail.value, true)
+ this.dataList = this.getDataList(detail.value)
+ * 获取渲染的新数组
+ * @param {Object} value 选中内容
+ getDataList(value) {
+ // 解除引用关系,破坏原引用关系,避免污染源数据
+ let dataList = JSON.parse(JSON.stringify(this.range))
+ let list = []
+ if (!Array.isArray(value)) {
+ value = []
+ dataList.forEach((item, index) => {
+ item.disabled = item.disable || item.disabled || false
+ if (value.length > 0) {
+ let have = value.find(val => val === item[this.map.value])
+ item.selected = have !== undefined
+ item.selected = false
+ item.selected = value === item[this.map.value]
+ list.push(item)
+ return this.setRange(list)
+ * 处理最大最小值
+ * @param {Object} list
+ setRange(list) {
+ let selectList = list.filter(item => item.selected)
+ let min = Number(this.min) || 0
+ let max = Number(this.max) || ''
+ list.forEach((item, index) => {
+ if (selectList.length <= min) {
+ let have = selectList.find(val => val[this.map.value] === item[this.map.value])
+ if (have !== undefined) {
+ item.disabled = true
+ if (selectList.length >= max && max !== '') {
+ if (have === undefined) {
+ this.setStyles(item, index)
+ list[index] = item
+ return list
+ * 设置 class
+ * @param {Object} item
+ * @param {Object} index
+ setStyles(item, index) {
+ // 设置自定义样式
+ item.styleBackgroud = this.setStyleBackgroud(item)
+ item.styleIcon = this.setStyleIcon(item)
+ item.styleIconText = this.setStyleIconText(item)
+ item.styleRightIcon = this.setStyleRightIcon(item)
+ * 获取选中值
+ * @param {Object} range
+ getSelectedValue(range) {
+ if (!this.multiple) return this.dataValue
+ let selectedArr = []
+ range.forEach((item) => {
+ if (item.selected) {
+ selectedArr.push(item[this.map.value])
+ return this.dataValue.length > 0 ? this.dataValue : selectedArr
+ * 设置背景样式
+ setStyleBackgroud(item) {
+ let styles = {}
+ let selectedColor = this.selectedColor?this.selectedColor:'#2979ff'
+ if (this.selectedColor) {
+ if (this.mode !== 'list') {
+ styles['border-color'] = item.selected?selectedColor:'#DCDFE6'
+ if (this.mode === 'tag') {
+ styles['background-color'] = item.selected? selectedColor:'#f5f5f5'
+ let classles = ''
+ for (let i in styles) {
+ classles += `${i}:${styles[i]};`
+ return classles
+ setStyleIcon(item) {
+ styles['background-color'] = item.selected?selectedColor:'#fff'
+ if(!item.selected && item.disabled){
+ styles['background-color'] = '#F2F6FC'
+ setStyleIconText(item) {
+ styles.color = item.selected?(this.selectedTextColor?this.selectedTextColor:'#fff'):'#666'
+ styles.color = item.selected?(this.selectedTextColor?this.selectedTextColor:selectedColor):'#666'
+ styles.color = '#999'
+ setStyleRightIcon(item) {
+ if (this.mode === 'list') {
+ styles['border-color'] = item.selected?this.styles.selectedColor:'#DCDFE6'
+ $border-color: #DCDFE6;
+ $disable:0.4;
+ @mixin flex {
+ .uni-data-loading {
+ @include flex;
+ height: 36px;
+ .uni-data-checklist {
+ z-index: 0;
+ // 多选样式
+ .checklist-group {
+ flex-wrap: wrap;
+ &.is-list {
+ .checklist-box {
+ margin: 5px 0;
+ margin-right: 25px;
+ .hidden {
+ // 文字样式
+ .checklist-content {
+ .checklist-text {
+ color: #666;
+ margin-left: 5px;
+ line-height: 14px;
+ .checkobx__list {
+ border-right-width: 1px;
+ border-right-color: #007aff;
+ border-right-style: solid;
+ border-bottom-width:1px;
+ border-bottom-color: #007aff;
+ height: 12px;
+ width: 6px;
+ left: -5px;
+ transform-origin: center;
+ transform: rotate(45deg);
+ .checkbox__inner {
+ flex-shrink: 0;
+ width: 16px;
+ height: 16px;
+ border: 1px solid $border-color;
+ .checkbox__inner-icon {
+ top: 2px;
+ left: 5px;
+ width: 4px;
+ border-right-color: #fff;
+ border-bottom-width:1px ;
+ transform: rotate(40deg);
+ // 单选样式
+ .radio__inner {
+ border-radius: 16px;
+ .radio__inner-icon {
+ border-radius: 10px;
+ // 默认样式
+ &.is--default {
+ // 禁用
+ &.is-disable {
+ cursor: not-allowed;
+ background-color: #F2F6FC;
+ border-color: $border-color;
+ // 选中
+ &.is-checked {
+ border-color: $uni-primary;
+ opacity: 1;
+ // 选中禁用
+ opacity: $disable;
+ // 按钮样式
+ &.is--button {
+ padding: 5px 10px;
+ border: 1px $border-color solid;
+ transition: border-color 0.2s;
+ border: 1px #eee solid;
+ // 标签样式
+ &.is--tag {
+ background-color: #f5f5f5;
+ // 列表样式
+ &.is--list {
+ padding: 10px 15px;
+ &.is-list-border {
+ border-top: 1px #eee solid;
@@ -0,0 +1,84 @@
+ "id": "uni-data-checkbox",
+ "displayName": "uni-data-checkbox 数据选择器",
+ "version": "1.0.3",
+ "description": "通过数据驱动的单选框和复选框",
+ "checkbox",
+ "单选",
+ "多选",
+ "单选多选"
+ "HBuilderX": "^3.1.1"
+ "dependencies": ["uni-load-more","uni-scss"],
@@ -0,0 +1,18 @@
+## DataCheckbox 数据驱动的单选复选框
+> **组件名:uni-data-checkbox**
+> 代码块: `uDataCheckbox`
+本组件是基于uni-app基础组件checkbox的封装。本组件要解决问题包括:
+1. 数据绑定型组件:给本组件绑定一个data,会自动渲染一组候选内容。再以往,开发者需要编写不少代码实现类似功能
+2. 自动的表单校验:组件绑定了data,且符合[uni-forms](https://ext.dcloud.net.cn/plugin?id=2773)组件的表单校验规范,搭配使用会自动实现表单校验
+3. 本组件合并了单选多选
+4. 本组件有若干风格选择,如普通的单选多选框、并列button风格、tag风格。开发者可以快速选择需要的风格。但作为一个封装组件,样式代码虽然不用自己写了,却会牺牲一定的样式自定义性
+在uniCloud开发中,`DB Schema`中配置了enum枚举等类型后,在web控制台的[自动生成表单](https://uniapp.dcloud.io/uniCloud/schema?id=autocode)功能中,会自动生成``uni-data-checkbox``组件并绑定好data
+### [查看文档](https://uniapp.dcloud.io/component/uniui/uni-data-checkbox)
@@ -0,0 +1,75 @@
+## 1.1.2(2023-04-11)
+- 修复 更改 modelValue 报错的 bug
+- 修复 v-for 未使用 key 值控制台 warning
+## 1.1.1(2023-02-21)
+- 修复代码合并时引发 value 属性为空时不渲染数据的问题
+## 1.1.0(2023-02-15)
+- 修复 localdata 不支持动态更新的bug
+## 1.0.9(2023-02-15)
+## 1.0.8(2022-09-16)
+## 1.0.7(2022-07-06)
+- 优化 pc端图标位置不正确的问题
+## 1.0.6(2022-07-05)
+- 优化 显示样式
+## 1.0.5(2022-07-04)
+- 修复 uni-data-picker 在 uni-forms-item 中宽度不正确的bug
+## 1.0.4(2022-04-19)
+- 修复 字节小程序 本地数据无法选择下一级的Bug
+## 1.0.3(2022-02-25)
+- 修复 nvue 不支持的 v-show 的 bug
+## 1.0.2(2022-02-25)
+- 修复 条件编译 nvue 不支持的 css 样式
+- 修复 由上个版本引发的map、v-model等属性不生效的bug
+- 优化 组件 UI,并提供设计资源,详见:[https://uniapp.dcloud.io/component/uniui/resource](https://uniapp.dcloud.io/component/uniui/resource)
+- 文档迁移,详见:[https://uniapp.dcloud.io/component/uniui/uni-data-picker](https://uniapp.dcloud.io/component/uniui/uni-data-picker)
+## 0.4.9(2021-10-28)
+- 修复 VUE2 v-model 概率无效的 bug
+## 0.4.8(2021-10-27)
+- 修复 v-model 概率无效的 bug
+## 0.4.7(2021-10-25)
+- 新增 属性 spaceInfo 服务空间配置 HBuilderX 3.2.11+
+- 修复 树型 uniCloud 数据类型为 int 时报错的 bug
+## 0.4.6(2021-10-19)
+- 修复 非 VUE3 v-model 为 0 时无法选中的 bug
+## 0.4.5(2021-09-26)
+- 新增 清除已选项的功能(通过 clearIcon 属性配置是否显示按钮),同时提供 clear 方法以供调用,二者等效
+- 修复 readonly 为 true 时报错的 bug
+## 0.4.4(2021-09-26)
+- 修复 上一版本造成的 map 属性失效的 bug
+- 新增 ellipsis 属性,支持配置 tab 选项长度过长时是否自动省略
+## 0.4.3(2021-09-24)
+- 修复 某些情况下级联未触发的 bug
+## 0.4.2(2021-09-23)
+- 新增 提供 show 和 hide 方法,开发者可以通过 ref 调用
+- 新增 选项内容过长自动添加省略号
+## 0.4.1(2021-09-15)
+- 新增 map 属性 字段映射,将 text/value 映射到数据中的其他字段
+## 0.4.0(2021-07-13)
+- 组件兼容 vue3,如何创建 vue3 项目,详见 [uni-app 项目支持 vue3 介绍](https://ask.dcloud.net.cn/article/37834)
+## 0.3.5(2021-06-04)
+- 修复 无法加载云端数据的问题
+## 0.3.4(2021-05-28)
+- 修复 v-model 无效问题
+- 修复 loaddata 为空数据组时加载时间过长问题
+- 修复 上个版本引出的本地数据无法选择带有 children 的 2 级节点
+## 0.3.3(2021-05-12)
+## 0.3.2(2021-04-22)
+- 修复 非树形数据有 where 属性查询报错的问题
+## 0.3.1(2021-04-15)
+- 修复 本地数据概率无法回显时问题
+## 0.3.0(2021-04-07)
+- 新增 支持云端非树形表结构数据
+- 修复 根节点 parent_field 字段等于 null 时选择界面错乱问题
+## 0.2.0(2021-03-15)
+- 修复 nodeclick、popupopened、popupclosed 事件无法触发的问题
+## 0.1.9(2021-03-09)
+- 修复 微信小程序某些情况下无法选择的问题
+## 0.1.8(2021-02-05)
+- 优化 部分样式在 nvue 上的兼容表现
+## 0.1.7(2021-02-05)
+- 调整为 uni_modules 目录规范
+// #ifdef H5
+ name: 'Keypress',
+ disable: {
+ mounted () {
+ const keyNames = {
+ esc: ['Esc', 'Escape'],
+ tab: 'Tab',
+ enter: 'Enter',
+ space: [' ', 'Spacebar'],
+ up: ['Up', 'ArrowUp'],
+ left: ['Left', 'ArrowLeft'],
+ right: ['Right', 'ArrowRight'],
+ down: ['Down', 'ArrowDown'],
+ delete: ['Backspace', 'Delete', 'Del']
+ const listener = ($event) => {
+ if (this.disable) {
+ const keyName = Object.keys(keyNames).find(key => {
+ const keyName = $event.key
+ const value = keyNames[key]
+ return value === keyName || (Array.isArray(value) && value.includes(keyName))
+ if (keyName) {
+ // 避免和其他按键事件冲突
+ this.$emit(keyName, {})
+ }, 0)
+ document.addEventListener('keyup', listener)
+ this.$once('hook:beforeDestroy', () => {
+ document.removeEventListener('keyup', listener)
+ render: () => {}
+// #endif
@@ -0,0 +1,551 @@
+ <view class="uni-data-tree">
+ <view class="uni-data-tree-input" @click="handleInput">
+ <slot :options="options" :data="inputSelected" :error="errorMessage">
+ <view class="input-value" :class="{'input-value-border': border}">
+ <text v-if="errorMessage" class="selected-area error-text">{{errorMessage}}</text>
+ <view v-else-if="loading && !isOpened" class="selected-area">
+ <uni-load-more class="load-more" :contentText="loadMore" status="loading"></uni-load-more>
+ <scroll-view v-else-if="inputSelected.length" class="selected-area" scroll-x="true">
+ <view class="selected-list">
+ <view class="selected-item" v-for="(item,index) in inputSelected" :key="index">
+ <text class="text-color">{{item.text}}</text><text v-if="index<inputSelected.length-1"
+ class="input-split-line">{{split}}</text>
+ <text v-else class="selected-area placeholder">{{placeholder}}</text>
+ <view v-if="clearIcon && !readonly && inputSelected.length" class="icon-clear" @click.stop="clear">
+ <uni-icons type="clear" color="#c0c4cc" size="24"></uni-icons>
+ <view class="arrow-area" v-if="(!clearIcon || !inputSelected.length) && !readonly ">
+ <view class="input-arrow"></view>
+ <view class="uni-data-tree-cover" v-if="isOpened" @click="handleClose"></view>
+ <view class="uni-data-tree-dialog" v-if="isOpened">
+ <view class="dialog-caption">
+ <view class="title-area">
+ <text class="dialog-title">{{popupTitle}}</text>
+ <view class="dialog-close" @click="handleClose">
+ <view class="dialog-close-plus" data-id="close"></view>
+ <view class="dialog-close-plus dialog-close-rotate" data-id="close"></view>
+ <data-picker-view class="picker-view" ref="pickerView" v-model="dataValue" :localdata="localdata"
+ :preload="preload" :collection="collection" :field="field" :orderby="orderby" :where="where"
+ :step-searh="stepSearh" :self-field="selfField" :parent-field="parentField" :managed-mode="true" :map="map"
+ :ellipsis="ellipsis" @change="onchange" @datachange="ondatachange" @nodeclick="onnodeclick">
+ </data-picker-view>
+ import dataPicker from "../uni-data-pickerview/uni-data-picker.js"
+ import DataPickerView from "../uni-data-pickerview/uni-data-pickerview.vue"
+ * DataPicker 级联选择
+ * @description 支持单列、和多列级联选择。列数没有限制,如果屏幕显示不全,顶部tab区域会左右滚动。
+ * @tutorial https://ext.dcloud.net.cn/plugin?id=3796
+ * @property {String} popup-title 弹出窗口标题
+ * @property {Array} localdata 本地数据,参考
+ * @property {Boolean} border = [true|false] 是否有边框
+ * @property {Boolean} readonly = [true|false] 是否仅读
+ * @property {Boolean} preload = [true|false] 是否预加载数据
+ * @value true 开启预加载数据,点击弹出窗口后显示已加载数据
+ * @value false 关闭预加载数据,点击弹出窗口后开始加载数据
+ * @property {Boolean} step-searh = [true|false] 是否分布查询
+ * @value true 启用分布查询,仅查询当前选中节点
+ * @value false 关闭分布查询,一次查询出所有数据
+ * @property {String|DBFieldString} self-field 分布查询当前字段名称
+ * @property {String|DBFieldString} parent-field 分布查询父字段名称
+ * @property {String|DBCollectionString} collection 表名
+ * @property {String|DBFieldString} field 查询字段,多个字段用 `,` 分割
+ * @property {String} orderby 排序字段及正序倒叙设置
+ * @property {String|JQLString} where 查询条件
+ * @event {Function} popupshow 弹出的选择窗口打开时触发此事件
+ * @event {Function} popuphide 弹出的选择窗口关闭时触发此事件
+ name: 'UniDataPicker',
+ emits: ['popupopened', 'popupclosed', 'nodeclick', 'input', 'change', 'update:modelValue','inputclick'],
+ mixins: [dataPicker],
+ DataPickerView
+ type: [Object, Array],
+ popupTitle: {
+ default: '请选择'
+ heightMobile: {
+ readonly: {
+ clearIcon: {
+ split: {
+ ellipsis: {
+ isOpened: false,
+ inputSelected: []
+ this.load();
+ handler() {
+ this.load()
+ clear() {
+ this._dispatchEvent([]);
+ onPropsChange() {
+ this._treeData = [];
+ this.selectedIndex = 0;
+ load() {
+ if (this.readonly) {
+ this._processReadonly(this.localdata, this.dataValue);
+ return;
+ // 回显本地数据
+ if (this.isLocalData) {
+ this.loadData();
+ this.inputSelected = this.selected.slice(0);
+ } else if (this.isCloudDataList || this.isCloudDataTree) { // 回显 Cloud 数据
+ this.loading = true;
+ this.getCloudDataValue().then((res) => {
+ this.loading = false;
+ this.inputSelected = res;
+ }).catch((err) => {
+ this.errorMessage = err;
+ show() {
+ this.isOpened = true
+ this.$refs.pickerView.updateData({
+ treeData: this._treeData,
+ selectedIndex: this.selectedIndex
+ }, 200)
+ this.$emit('popupopened')
+ hide() {
+ this.isOpened = false
+ this.$emit('popupclosed')
+ handleInput() {
+ this.$emit('inputclick')
+ this.show()
+ handleClose(e) {
+ this.hide()
+ onnodeclick(e) {
+ this.$emit('nodeclick', e)
+ ondatachange(e) {
+ this._treeData = this.$refs.pickerView._treeData
+ onchange(e) {
+ this.inputSelected = e;
+ this._dispatchEvent(e)
+ _processReadonly(dataList, value) {
+ var isTree = dataList.findIndex((item) => {
+ return item.children
+ if (isTree > -1) {
+ let inputValue
+ if (Array.isArray(value)) {
+ inputValue = value[value.length - 1]
+ if (typeof inputValue === 'object' && inputValue.value) {
+ inputValue = inputValue.value
+ inputValue = value
+ this.inputSelected = this._findNodePath(inputValue, this.localdata)
+ if (!this.hasValue) {
+ this.inputSelected = []
+ let result = []
+ for (let i = 0; i < value.length; i++) {
+ var val = value[i]
+ var item = dataList.find((v) => {
+ return v.value == val
+ if (item) {
+ result.push(item)
+ if (result.length) {
+ this.inputSelected = result
+ _filterForArray(data, valueArray) {
+ var result = []
+ for (let i = 0; i < valueArray.length; i++) {
+ var value = valueArray[i]
+ var found = data.find((item) => {
+ return item.value == value
+ if (found) {
+ result.push(found)
+ return result
+ _dispatchEvent(selected) {
+ let item = {}
+ if (selected.length) {
+ var value = new Array(selected.length)
+ for (var i = 0; i < selected.length; i++) {
+ value[i] = selected[i].value
+ item = selected[selected.length - 1]
+ item.value = ''
+ if (this.formItem) {
+ this.formItem.setValue(item.value)
+ this.$emit('input', item.value)
+ this.$emit('update:modelValue', item.value)
+ detail: {
+ value: selected
+<style>
+ .uni-data-tree {
+ .error-text {
+ color: #DD524D;
+ .input-value {
+ flex-wrap: nowrap;
+ /* line-height: 35px; */
+ padding-right: 5px;
+ height: 35px;
+ .input-value-border {
+ border: 1px solid #e5e5e5;
+ .selected-area {
+ .load-more {
+ margin-right: auto;
+ .selected-list {
+ /* padding: 0 5px; */
+ .selected-item {
+ /* padding: 0 1px; */
+ .text-color {
+ .placeholder {
+ color: grey;
+ .input-split-line {
+ opacity: .5;
+ .arrow-area {
+ margin-bottom: 5px;
+ margin-left: auto;
+ .input-arrow {
+ width: 7px;
+ height: 7px;
+ border-left: 1px solid #999;
+ border-bottom: 1px solid #999;
+ .uni-data-tree-cover {
+ background-color: rgba(0, 0, 0, .4);
+ z-index: 100;
+ .uni-data-tree-dialog {
+ top: 20%;
+ top: 200px;
+ border-top-left-radius: 10px;
+ border-top-right-radius: 10px;
+ z-index: 102;
+ width: 750rpx;
+ .dialog-caption {
+ /* border-bottom: 1px solid #f0f0f0; */
+ .title-area {
+ margin: auto;
+ .dialog-title {
+ /* font-weight: bold; */
+ line-height: 44px;
+ .dialog-close {
+ .dialog-close-plus {
+ height: 2px;
+ background-color: #666;
+ border-radius: 2px;
+ .dialog-close-rotate {
+ .picker-view {
+ .icon-clear {
+ @media all and (min-width: 768px) {
+ top: 55px;
+ height: auto;
+ min-height: 400px;
+ max-height: 50vh;
+ overflow: unset;
+ /* margin-right: 5px; */
+ /* picker 弹出层通用的指示小三角, todo:扩展至上下左右方向定位 */
@@ -0,0 +1,622 @@
+ type: [Array, Object],
+ spaceInfo: {
+ collection: {
+ action: {
+ field: {
+ orderby: {
+ where: {
+ type: [String, Object],
+ pageData: {
+ default: 'add'
+ pageCurrent: {
+ default: 1
+ pageSize: {
+ default: 500
+ getcount: {
+ getone: {
+ gettree: {
+ manual: {
+ preload: {
+ stepSearh: {
+ selfField: {
+ parentField: {
+ map: {
+ text: "text",
+ value: "value"
+ loading: false,
+ errorMessage: '',
+ loadMore: {
+ contentdown: '',
+ contentrefresh: '',
+ contentnomore: ''
+ selected: [],
+ selectedIndex: 0,
+ page: {
+ current: this.pageCurrent,
+ size: this.pageSize,
+ count: 0
+ isLocalData() {
+ return !this.collection.length;
+ isCloudData() {
+ return this.collection.length > 0;
+ isCloudDataList() {
+ return (this.isCloudData && (!this.parentField && !this.selfField));
+ isCloudDataTree() {
+ return (this.isCloudData && this.parentField && this.selfField);
+ let isModelValue = Array.isArray(this.modelValue) ? (this.modelValue.length > 0) : (this.modelValue !== null ||
+ this.modelValue !== undefined);
+ return isModelValue ? this.modelValue : this.value;
+ hasValue() {
+ if (typeof this.dataValue === 'number') {
+ return (this.dataValue != null) && (this.dataValue.length > 0)
+ this.$watch(() => {
+ var al = [];
+ ['pageCurrent',
+ 'pageSize',
+ 'spaceInfo',
+ 'value',
+ 'modelValue',
+ 'localdata',
+ 'collection',
+ 'action',
+ 'field',
+ 'orderby',
+ 'where',
+ 'getont',
+ 'getcount',
+ 'gettree'
+ ].forEach(key => {
+ al.push(this[key])
+ });
+ return al
+ }, (newValue, oldValue) => {
+ let needReset = false
+ for (let i = 2; i < newValue.length; i++) {
+ if (newValue[i] != oldValue[i]) {
+ needReset = true
+ if (newValue[0] != oldValue[0]) {
+ this.page.current = this.pageCurrent
+ this.page.size = this.pageSize
+ this.onPropsChange()
+ this._treeData = []
+ // 填充 pickview 数据
+ async loadData() {
+ this.loadLocalData();
+ } else if (this.isCloudDataList) {
+ this.loadCloudDataList();
+ } else if (this.isCloudDataTree) {
+ this.loadCloudDataTree();
+ // 加载本地数据
+ async loadLocalData() {
+ this._extractTree(this.localdata, this._treeData);
+ let inputValue = this.dataValue;
+ if (inputValue === undefined) {
+ if (Array.isArray(inputValue)) {
+ inputValue = inputValue[inputValue.length - 1];
+ if (typeof inputValue === 'object' && inputValue[this.map.value]) {
+ inputValue = inputValue[this.map.value];
+ this.selected = this._findNodePath(inputValue, this.localdata);
+ // 加载 Cloud 数据 (单列)
+ async loadCloudDataList() {
+ if (this.loading) {
+ try {
+ let response = await this.getCommand();
+ let responseData = response.result.data;
+ this._treeData = responseData;
+ this._updateBindData();
+ this._updateSelected();
+ this.onDataChange();
+ } catch (e) {
+ this.errorMessage = e;
+ } finally {
+ // 加载 Cloud 数据 (树形)
+ async loadCloudDataTree() {
+ let commandOptions = {
+ field: this._cloudDataPostField(),
+ where: this._cloudDataTreeWhere()
+ if (this.gettree) {
+ commandOptions.startwith = `${this.selfField}=='${this.dataValue}'`;
+ let response = await this.getCommand(commandOptions);
+ // 加载 Cloud 数据 (节点)
+ async loadCloudDataNode(callback) {
+ where: this._cloudDataNodeWhere()
+ callback(responseData);
+ // 回显 Cloud 数据
+ getCloudDataValue() {
+ if (this.isCloudDataList) {
+ return this.getCloudDataListValue();
+ if (this.isCloudDataTree) {
+ return this.getCloudDataTreeValue();
+ // 回显 Cloud 数据 (单列)
+ getCloudDataListValue() {
+ // 根据 field's as value标识匹配 where 条件
+ let where = [];
+ let whereField = this._getForeignKeyByField();
+ if (whereField) {
+ where.push(`${whereField} == '${this.dataValue}'`)
+ where = where.join(' || ');
+ if (this.where) {
+ where = `(${this.where}) && (${where})`
+ return this.getCommand({
+ where
+ }).then((res) => {
+ this.selected = res.result.data;
+ return res.result.data;
+ // 回显 Cloud 数据 (树形)
+ getCloudDataTreeValue() {
+ getTreePath: {
+ startWith: `${this.selfField}=='${this.dataValue}'`
+ let treePath = [];
+ this._extractTreePath(res.result.data, treePath);
+ this.selected = treePath;
+ return treePath;
+ getCommand(options = {}) {
+ /* eslint-disable no-undef */
+ let db = uniCloud.database(this.spaceInfo)
+ const action = options.action || this.action
+ if (action) {
+ db = db.action(action)
+ const collection = options.collection || this.collection
+ db = db.collection(collection)
+ const where = options.where || this.where
+ if (!(!where || !Object.keys(where).length)) {
+ db = db.where(where)
+ const field = options.field || this.field
+ if (field) {
+ db = db.field(field)
+ const orderby = options.orderby || this.orderby
+ if (orderby) {
+ db = db.orderBy(orderby)
+ const current = options.pageCurrent !== undefined ? options.pageCurrent : this.page.current
+ const size = options.pageSize !== undefined ? options.pageSize : this.page.size
+ const getCount = options.getcount !== undefined ? options.getcount : this.getcount
+ const getTree = options.gettree !== undefined ? options.gettree : this.gettree
+ const getOptions = {
+ getCount,
+ getTree
+ if (options.getTreePath) {
+ getOptions.getTreePath = options.getTreePath
+ db = db.skip(size * (current - 1)).limit(size).get(getOptions)
+ return db
+ _cloudDataPostField() {
+ let fields = [this.field];
+ if (this.parentField) {
+ fields.push(`${this.parentField} as parent_value`);
+ return fields.join(',');
+ _cloudDataTreeWhere() {
+ let selected = this.selected
+ let parentField = this.parentField
+ if (parentField) {
+ result.push(`${parentField} == null || ${parentField} == ""`)
+ for (var i = 0; i < selected.length - 1; i++) {
+ result.push(`${parentField} == '${selected[i].value}'`)
+ let where = []
+ where.push(`(${this.where})`)
+ where.push(`(${result.join(' || ')})`)
+ return where.join(' && ')
+ _cloudDataNodeWhere() {
+ let selected = this.selected;
+ where.push(`${this.parentField} == '${selected[selected.length - 1].value}'`);
+ return `(${this.where}) && (${where})`
+ return where
+ _getWhereByForeignKey() {
+ result.push(`${whereField} == '${this.dataValue}'`)
+ return `(${this.where}) && (${result.join(' || ')})`
+ return result.join(' || ')
+ _getForeignKeyByField() {
+ let fields = this.field.split(',');
+ let whereField = null;
+ for (let i = 0; i < fields.length; i++) {
+ const items = fields[i].split('as');
+ if (items.length < 2) {
+ continue;
+ if (items[1].trim() === 'value') {
+ whereField = items[0].trim();
+ break;
+ return whereField;
+ _updateBindData(node) {
+ dataList,
+ hasNodes
+ } = this._filterData(this._treeData, this.selected)
+ let isleaf = this._stepSearh === false && !hasNodes
+ if (node) {
+ node.isleaf = isleaf
+ this.dataList = dataList
+ this.selectedIndex = dataList.length - 1
+ if (!isleaf && this.selected.length < dataList.length) {
+ this.selected.push({
+ value: null,
+ text: "请选择"
+ isleaf,
+ _updateSelected() {
+ let dl = this.dataList
+ let sl = this.selected
+ let textField = this.map.text
+ let valueField = this.map.value
+ for (let i = 0; i < sl.length; i++) {
+ let value = sl[i].value
+ let dl2 = dl[i]
+ for (let j = 0; j < dl2.length; j++) {
+ let item2 = dl2[j]
+ if (item2[valueField] === value) {
+ sl[i].text = item2[textField]
+ _filterData(data, paths) {
+ let dataList = []
+ let hasNodes = true
+ dataList.push(data.filter((item) => {
+ return (item.parent_value === null || item.parent_value === undefined || item.parent_value === '')
+ }))
+ for (let i = 0; i < paths.length; i++) {
+ let value = paths[i].value
+ let nodes = data.filter((item) => {
+ return item.parent_value === value
+ if (nodes.length) {
+ dataList.push(nodes)
+ hasNodes = false
+ _extractTree(nodes, result, parent_value) {
+ let list = result || []
+ for (let i = 0; i < nodes.length; i++) {
+ let node = nodes[i]
+ let child = {}
+ for (let key in node) {
+ if (key !== 'children') {
+ child[key] = node[key]
+ if (parent_value !== null && parent_value !== undefined && parent_value !== '') {
+ child.parent_value = parent_value
+ result.push(child)
+ let children = node.children
+ if (children) {
+ this._extractTree(children, result, node[valueField])
+ _extractTreePath(nodes, result) {
+ this._extractTreePath(children, result)
+ _findNodePath(key, nodes, path = []) {
+ let text = node[textField]
+ let value = node[valueField]
+ path.push({
+ value,
+ text
+ if (value === key) {
+ return path
+ const p = this._findNodePath(key, children, path)
+ if (p.length) {
+ return p
+ path.pop()
@@ -0,0 +1,323 @@
+ <view class="uni-data-pickerview">
+ <scroll-view v-if="!isCloudDataList" class="selected-area" scroll-x="true">
+ <view
+ class="selected-item"
+ v-for="(item,index) in selected"
+ :key="index"
+ :class="{
+ 'selected-item-active':index == selectedIndex
+ @click="handleSelect(index)"
+ >
+ <text>{{item.text || ''}}</text>
+ <view class="tab-c">
+ <scroll-view class="list" :scroll-y="true">
+ <view class="item" :class="{'is-disabled': !!item.disable}" v-for="(item, j) in dataList[selectedIndex]" :key="j"
+ @click="handleNodeClick(item, selectedIndex, j)">
+ <text class="item-text">{{item[map.text]}}</text>
+ <view class="check" v-if="selected.length > selectedIndex && item[map.value] == selected[selectedIndex].value"></view>
+ <view class="loading-cover" v-if="loading">
+ <view class="error-message" v-if="errorMessage">
+ <text class="error-text">{{errorMessage}}</text>
+ import dataPicker from "./uni-data-picker.js"
+ * DataPickerview
+ * @description uni-data-pickerview
+ name: 'UniDataPickerView',
+ emits: ['nodeclick', 'change', 'datachange', 'update:modelValue'],
+ managedMode: {
+ if (!this.managedMode) {
+ handleSelect(index) {
+ this.selectedIndex = index;
+ handleNodeClick(item, i, j) {
+ if (item.disable) {
+ const node = this.dataList[i][j];
+ const text = node[this.map.text];
+ const value = node[this.map.value];
+ if (i < this.selected.length - 1) {
+ this.selected.splice(i, this.selected.length - i)
+ value
+ } else if (i === this.selected.length - 1) {
+ this.selected.splice(i, 1, {
+ if (node.isleaf) {
+ this.onSelectedChange(node, node.isleaf)
+ } = this._updateBindData()
+ // 本地数据
+ this.onSelectedChange(node, (!hasNodes || isleaf))
+ } else if (this.isCloudDataList) { // Cloud 数据 (单列)
+ this.onSelectedChange(node, true)
+ } else if (this.isCloudDataTree) { // Cloud 数据 (树形)
+ if (isleaf) {
+ } else if (!hasNodes) { // 请求一次服务器以确定是否为叶子节点
+ this.loadCloudDataNode((data) => {
+ if (!data.length) {
+ node.isleaf = true
+ this._treeData.push(...data)
+ this._updateBindData(node)
+ updateData(data) {
+ this._treeData = data.treeData
+ this.selected = data.selected
+ if (!this._treeData.length) {
+ //this.selected = data.selected
+ this._updateBindData()
+ onDataChange() {
+ this.$emit('datachange');
+ onSelectedChange(node, isleaf) {
+ this._dispatchEvent()
+ this.$emit('nodeclick', node)
+ _dispatchEvent() {
+ this.$emit('change', this.selected.slice(0))
+ $uni-primary: #007aff !default;
+ .uni-data-pickerview {
+ height: 100%;
+ .loading-cover {
+ background-color: rgba(255, 255, 255, .5);
+ z-index: 1001;
+ .error-message {
+ padding: 15px;
+ opacity: .9;
+ border-bottom: 1px solid #f8f8f8;
+ margin-left: 10px;
+ padding: 12px 0;
+ .selected-item-text-overflow {
+ width: 168px;
+ /* fix nvue */
+ width: 6em;
+ -o-text-overflow: ellipsis;
+ .selected-item-active {
+ border-bottom: 2px solid $uni-primary;
+ .selected-item-text {
+ .tab-c {
+ .list {
+ .item {
+ padding: 12px 15px;
+ .is-disabled {
+ .item-text {
+ /* flex: 1; */
+ color: #333333;
+ .item-text-overflow {
+ width: 280px;
+ width: 20em;
+ .check {
+ margin-right: 5px;
+ border: 2px solid $uni-primary;
+ border-left: 0;
+ border-top: 0;
+ transition: all 0.3s;
+ "id": "uni-data-picker",
+ "displayName": "uni-data-picker 数据驱动的picker选择器",
+ "version": "1.1.2",
+ "description": "单列、多列级联选择器,常用于省市区城市选择、公司部门选择、多级分类等场景",
+ "picker",
+ "级联",
+ "省市区",
+ ""
+ "uni-load-more",
+ "app-nvue": "u"
+ "QQ": "y",
@@ -0,0 +1,22 @@
+## DataPicker 级联选择
+> **组件名:uni-data-picker**
+> 代码块: `uDataPicker`
+> 关联组件:`uni-data-pickerview`、`uni-load-more`。
+`<uni-data-picker>` 是一个选择类[datacom组件](https://uniapp.dcloud.net.cn/component/datacom)。
+支持单列、和多列级联选择。列数没有限制,如果屏幕显示不全,顶部tab区域会左右滚动。
+候选数据支持一次性加载完毕,也支持懒加载,比如示例图中,选择了“北京”后,动态加载北京的区县数据。
+`<uni-data-picker>` 组件尤其适用于地址选择、分类选择等选择类。
+`<uni-data-picker>` 支持本地数据、云端静态数据(json),uniCloud云数据库数据。
+`<uni-data-picker>` 可以通过JQL直连uniCloud云数据库,配套[DB Schema](https://uniapp.dcloud.net.cn/uniCloud/schema),可在schema2code中自动生成前端页面,还支持服务器端校验。
+在uniCloud数据表中新建表“uni-id-address”和“opendb-city-china”,这2个表的schema自带foreignKey关联。在“uni-id-address”表的表结构页面使用schema2code生成前端页面,会自动生成地址管理的维护页面,自动从“opendb-city-china”表包含的中国所有省市区信息里选择地址。
+### [查看文档](https://uniapp.dcloud.io/component/uniui/uni-data-picker)
@@ -0,0 +1,35 @@
+## 1.0.6(2023-04-12)
+- 修复 微信小程序点击时会改变背景颜色的 bug
+## 1.0.5(2023-02-03)
+- 修复 禁用时会显示清空按钮
+## 1.0.4(2023-02-02)
+- 优化 查询条件短期内多次变更只查询最后一次变更后的结果
+- 调整 内部缓存键名调整为 uni-data-select-lastSelectedValue
+## 1.0.3(2023-01-16)
+- 修复 不关联服务空间报错的问题
+## 1.0.2(2023-01-14)
+- 新增 属性 `format` 可用于格式化显示选项内容
+## 1.0.1(2022-12-06)
+- 修复 当where变化时,数据不会自动更新的问题
+## 0.1.9(2022-09-05)
+- 修复 微信小程序下拉框出现后选择会点击到蒙板后面的输入框
+## 0.1.8(2022-08-29)
+- 修复 点击的位置不准确
+## 0.1.7(2022-08-12)
+- 新增 支持 disabled 属性
+## 0.1.6(2022-07-06)
+- 修复 pc端宽度异常的bug
+## 0.1.5
+## 0.1.4(2022-07-05)
+## 0.1.3(2022-06-02)
+- 修复 localdata 赋值不生效的 bug
+- 新增 支持选项禁用(数据选项设置 disabled: true 即禁用)
+## 0.1.2(2022-05-08)
+- 修复 当 value 为 0 时选择不生效的 bug
+## 0.1.1(2022-05-07)
+- 新增 记住上次的选项(仅 collection 存在时有效)
+## 0.1.0(2022-04-22)
@@ -0,0 +1,517 @@
+ <view class="uni-stat__select">
+ <span v-if="label" class="uni-label-text hide-on-phone">{{label + ':'}}</span>
+ <view class="uni-stat-box" :class="{'uni-stat__actived': current}">
+ <view class="uni-select" :class="{'uni-select--disabled':disabled}">
+ <view class="uni-select__input-box" @click="toggleSelector">
+ <view v-if="current" class="uni-select__input-text">{{current}}</view>
+ <view v-else class="uni-select__input-text uni-select__input-placeholder">{{typePlaceholder}}</view>
+ <view v-if="current && clear && !disabled" @click.stop="clearVal" >
+ <uni-icons type="clear" color="#c0c4cc" size="24"/>
+ <view v-else>
+ <uni-icons :type="showSelector? 'top' : 'bottom'" size="14" color="#999" />
+ <view class="uni-select--mask" v-if="showSelector" @click="toggleSelector" />
+ <view class="uni-select__selector" v-if="showSelector">
+ <scroll-view scroll-y="true" class="uni-select__selector-scroll">
+ <view class="uni-select__selector-empty" v-if="mixinDatacomResData.length === 0">
+ <view v-else class="uni-select__selector-item" v-for="(item,index) in mixinDatacomResData" :key="index"
+ @click="change(item)">
+ <text :class="{'uni-select__selector__disabled': item.disable}">{{formatItemName(item)}}</text>
+ * @description 通过数据渲染的下拉框组件
+ * @tutorial https://uniapp.dcloud.io/component/uniui/uni-data-select
+ * @property {String} value 默认值
+ * @property {Boolean} clear 是否可以清空已选项
+ * @property {String} label 左侧标题
+ * @property {String} placeholder 输入框的提示文字
+ * @property {Boolean} disabled 是否禁用
+ name: "uni-data-select",
+ default: '无选项'
+ clear: {
+ defItem: {
+ // 格式化输出 用法 field="_id as value, version as text, uni_platform as label" format="{label} - {text}"
+ format: {
+ current: '',
+ mixinDatacomResData: [],
+ apps: [],
+ channels: [],
+ cacheKey: "uni-data-select-lastSelectedValue",
+ this.debounceGet = this.debounce(() => {
+ this.query();
+ }, 300);
+ if (this.collection && !this.localdata.length) {
+ this.debounceGet();
+ typePlaceholder() {
+ const text = {
+ 'opendb-stat-app-versions': '版本',
+ 'opendb-app-channels': '渠道',
+ 'opendb-app-list': '应用'
+ const common = this.placeholder
+ const placeholder = text[this.collection]
+ return placeholder ?
+ common + placeholder :
+ common
+ valueCom(){
+ return this.modelValue;
+ return this.value;
+ handler(val, old) {
+ if (Array.isArray(val) && old !== val) {
+ this.mixinDatacomResData = val
+ valueCom(val, old) {
+ this.initDefVal()
+ mixinDatacomResData: {
+ handler(val) {
+ if (val.length) {
+ debounce(fn, time = 100){
+ let timer = null
+ return function(...args) {
+ if (timer) clearTimeout(timer)
+ timer = setTimeout(() => {
+ fn.apply(this, args)
+ }, time)
+ // 执行数据库查询
+ query(){
+ this.mixinDatacomEasyGet();
+ // 监听查询条件变更事件
+ onMixinDatacomPropsChange(){
+ initDefVal() {
+ let defValue = ''
+ if ((this.valueCom || this.valueCom === 0) && !this.isDisabled(this.valueCom)) {
+ defValue = this.valueCom
+ let strogeValue
+ strogeValue = this.getCache()
+ if (strogeValue || strogeValue === 0) {
+ defValue = strogeValue
+ let defItem = ''
+ if (this.defItem > 0 && this.defItem <= this.mixinDatacomResData.length) {
+ defItem = this.mixinDatacomResData[this.defItem - 1].value
+ defValue = defItem
+ if (defValue || defValue === 0) {
+ this.emit(defValue)
+ const def = this.mixinDatacomResData.find(item => item.value === defValue)
+ this.current = def ? this.formatItemName(def) : ''
+ * @param {[String, Number]} value
+ * 判断用户给的 value 是否同时为禁用状态
+ isDisabled(value) {
+ let isDisabled = false;
+ this.mixinDatacomResData.forEach(item => {
+ if (item.value === value) {
+ isDisabled = item.disable
+ return isDisabled;
+ clearVal() {
+ this.emit('')
+ this.removeCache()
+ change(item) {
+ if (!item.disable) {
+ this.current = this.formatItemName(item)
+ this.emit(item.value)
+ emit(val) {
+ this.$emit('change', val)
+ this.setCache(val);
+ if (this.disabled) {
+ formatItemName(item) {
+ channel_code
+ } = item
+ channel_code = channel_code ? `(${channel_code})` : ''
+ if (this.format) {
+ // 格式化输出
+ let str = "";
+ str = this.format;
+ for (let key in item) {
+ str = str.replace(new RegExp(`{${key}}`,"g"),item[key]);
+ return str;
+ return this.collection.indexOf('app-list') > 0 ?
+ `${text}(${value})` :
+ (
+ text ?
+ text :
+ `未命名${channel_code}`
+ )
+ // 获取当前加载的数据
+ getLoadData(){
+ return this.mixinDatacomResData;
+ // 获取当前缓存key
+ getCurrentCacheKey(){
+ return this.collection;
+ // 获取缓存
+ getCache(name=this.getCurrentCacheKey()){
+ let cacheData = uni.getStorageSync(this.cacheKey) || {};
+ return cacheData[name];
+ // 设置缓存
+ setCache(value, name=this.getCurrentCacheKey()){
+ cacheData[name] = value;
+ uni.setStorageSync(this.cacheKey, cacheData);
+ // 删除缓存
+ removeCache(name=this.getCurrentCacheKey()){
+ delete cacheData[name];
+ $uni-main-color: #333 !default;
+ $uni-border-3: #e5e5e5;
+ @media screen and (max-width: 500px) {
+ .hide-on-phone {
+ .uni-stat__select {
+ // padding: 15px;
+ .uni-stat-box {
+ .uni-stat__actived {
+ // outline: 1px solid #2979ff;
+ .uni-label-text {
+ margin: auto 0;
+ .uni-select {
+ border: 1px solid $uni-border-3;
+ user-select: none;
+ border-bottom: solid 1px $uni-border-3;
+ &--disabled {
+ background-color: #f5f7fa;
+ .uni-select__label {
+ color: $uni-secondary-color;
+ .uni-select__input-box {
+ .uni-select__input {
+ .uni-select__input-plac {
+ .uni-select__selector {
+ .uni-select__selector-scroll {
+ @media (min-width: 768px) {
+ max-height: 600px;
+ .uni-select__selector-empty,
+ .uni-select__selector-item {
+ line-height: 35px;
+ /* border-bottom: solid 1px $uni-border-3; */
+ .uni-select__selector-item:hover {
+ .uni-select__selector-empty:last-child,
+ .uni-select__selector-item:last-child {
+ .uni-select__selector__disabled {
+ opacity: 0.4;
+ cursor: default;
+ /* picker 弹出层通用的指示小三角 */
+ .uni-select__input-text {
+ // width: 280px;
+ .uni-select__input-placeholder {
+ .uni-select--mask {
+ z-index: 2;
+ "id": "uni-data-select",
+ "displayName": "uni-data-select 下拉框选择器",
+ "version": "1.0.6",
+ "description": "通过数据驱动的下拉框选择器",
+ "select",
+ "uni-data-select",
+ "下拉框",
+ "下拉选"
+ "dependencies": ["uni-load-more"],
+ "app-vue": "u",
+## DataSelect 下拉框选择器
+> **组件名:uni-data-select**
+> 代码块: `uDataSelect`
+当选项过多时,使用下拉菜单展示并选择内容
+### [查看文档](https://uniapp.dcloud.io/component/uniui/uni-data-select)
+- 文档迁移,详见:[https://uniapp.dcloud.io/component/uniui/uni-dateformat](https://uniapp.dcloud.io/component/uniui/uni-dateformat)
+## 0.0.5(2021-07-08)
+- 调整 默认时间不再是当前时间,而是显示'-'字符
+## 0.0.4(2021-05-12)
+- 修复 iOS 平台日期格式化出错的问题
@@ -0,0 +1,200 @@
+// yyyy-MM-dd hh:mm:ss.SSS 所有支持的类型
+function pad(str, length = 2) {
+ str += ''
+ while (str.length < length) {
+ str = '0' + str
+ return str.slice(-length)
+const parser = {
+ yyyy: (dateObj) => {
+ return pad(dateObj.year, 4)
+ yy: (dateObj) => {
+ return pad(dateObj.year)
+ MM: (dateObj) => {
+ return pad(dateObj.month)
+ M: (dateObj) => {
+ return dateObj.month
+ dd: (dateObj) => {
+ return pad(dateObj.day)
+ d: (dateObj) => {
+ return dateObj.day
+ hh: (dateObj) => {
+ return pad(dateObj.hour)
+ h: (dateObj) => {
+ return dateObj.hour
+ mm: (dateObj) => {
+ return pad(dateObj.minute)
+ m: (dateObj) => {
+ return dateObj.minute
+ ss: (dateObj) => {
+ return pad(dateObj.second)
+ s: (dateObj) => {
+ return dateObj.second
+ SSS: (dateObj) => {
+ return pad(dateObj.millisecond, 3)
+ S: (dateObj) => {
+ return dateObj.millisecond
+// 这都n年了iOS依然不认识2020-12-12,需要转换为2020/12/12
+function getDate(time) {
+ if (time instanceof Date) {
+ return time
+ switch (typeof time) {
+ case 'string':
+ {
+ // 2020-12-12T12:12:12.000Z、2020-12-12T12:12:12.000
+ if (time.indexOf('T') > -1) {
+ return new Date(time)
+ return new Date(time.replace(/-/g, '/'))
+ default:
+export function formatDate(date, format = 'yyyy/MM/dd hh:mm:ss') {
+ if (!date && date !== 0) {
+ date = getDate(date)
+ const dateObj = {
+ year: date.getFullYear(),
+ month: date.getMonth() + 1,
+ day: date.getDate(),
+ hour: date.getHours(),
+ minute: date.getMinutes(),
+ second: date.getSeconds(),
+ millisecond: date.getMilliseconds()
+ const tokenRegExp = /yyyy|yy|MM|M|dd|d|hh|h|mm|m|ss|s|SSS|SS|S/
+ let flag = true
+ let result = format
+ while (flag) {
+ flag = false
+ result = result.replace(tokenRegExp, function(matched) {
+ flag = true
+ return parser[matched](dateObj)
+export function friendlyDate(time, {
+ locale = 'zh',
+ threshold = [60000, 3600000],
+ format = 'yyyy/MM/dd hh:mm:ss'
+}) {
+ if (time === '-') {
+ if (!time && time !== 0) {
+ const localeText = {
+ zh: {
+ year: '年',
+ month: '月',
+ day: '天',
+ hour: '小时',
+ minute: '分钟',
+ second: '秒',
+ ago: '前',
+ later: '后',
+ justNow: '刚刚',
+ soon: '马上',
+ template: '{num}{unit}{suffix}'
+ en: {
+ year: 'year',
+ month: 'month',
+ day: 'day',
+ hour: 'hour',
+ minute: 'minute',
+ second: 'second',
+ ago: 'ago',
+ later: 'later',
+ justNow: 'just now',
+ soon: 'soon',
+ template: '{num} {unit} {suffix}'
+ const text = localeText[locale] || localeText.zh
+ let date = getDate(time)
+ let ms = date.getTime() - Date.now()
+ let absMs = Math.abs(ms)
+ if (absMs < threshold[0]) {
+ return ms < 0 ? text.justNow : text.soon
+ if (absMs >= threshold[1]) {
+ return formatDate(date, format)
+ let num
+ let unit
+ let suffix = text.later
+ if (ms < 0) {
+ suffix = text.ago
+ ms = -ms
+ const seconds = Math.floor((ms) / 1000)
+ const minutes = Math.floor(seconds / 60)
+ const hours = Math.floor(minutes / 60)
+ const days = Math.floor(hours / 24)
+ const months = Math.floor(days / 30)
+ const years = Math.floor(months / 12)
+ switch (true) {
+ case years > 0:
+ num = years
+ unit = text.year
+ case months > 0:
+ num = months
+ unit = text.month
+ case days > 0:
+ num = days
+ unit = text.day
+ case hours > 0:
+ num = hours
+ unit = text.hour
+ case minutes > 0:
+ num = minutes
+ unit = text.minute
+ num = seconds
+ unit = text.second
+ if (locale === 'en') {
+ if (num === 1) {
+ num = 'a'
+ unit += 's'
+ return text.template.replace(/{\s*num\s*}/g, num + '').replace(/{\s*unit\s*}/g, unit).replace(/{\s*suffix\s*}/g,
+ suffix)
+ <text>{{dateShow}}</text>
+ import {friendlyDate} from './date-format.js'
+ * Dateformat 日期格式化
+ * @description 日期格式化组件
+ * @tutorial https://ext.dcloud.net.cn/plugin?id=3279
+ * @property {Object|String|Number} date 日期对象/日期字符串/时间戳
+ * @property {String} locale 格式化使用的语言
+ * @value zh 中文
+ * @value en 英文
+ * @property {Array} threshold 应用不同类型格式化的阈值
+ * @property {String} format 输出日期字符串时的格式
+ name: 'uniDateformat',
+ type: [Object, String, Number],
+ return '-'
+ locale: {
+ default: 'zh',
+ threshold: {
+ default: 'yyyy/MM/dd hh:mm:ss'
+ // refreshRate使用不当可能导致性能问题,谨慎使用
+ refreshRate: {
+ refreshMark: 0
+ dateShow() {
+ this.refreshMark
+ return friendlyDate(this.date, {
+ locale: this.locale,
+ threshold: this.threshold,
+ format: this.format
+ this.setAutoRefresh()
+ refresh() {
+ this.refreshMark++
+ setAutoRefresh() {
+ clearInterval(this.refreshInterval)
+ if (this.refreshRate) {
+ this.refreshInterval = setInterval(() => {
+ this.refresh()
+ }, parseInt(this.refreshRate))
+ "id": "uni-dateformat",
+ "displayName": "uni-dateformat 日期格式化",
+ "version": "1.0.0",
+ "description": "日期格式化组件,可以将日期格式化为1分钟前、刚刚等形式",
+ "日期格式化",
+ "时间格式化",
+ "格式化时间",
+### DateFormat 日期格式化
+> **组件名:uni-dateformat**
+> 代码块: `uDateformat`
+日期格式化组件。
+### [查看文档](https://uniapp.dcloud.io/component/uniui/uni-dateformat)
@@ -0,0 +1,133 @@
+## 2.2.22(2023-03-30)
+- 修复 日历 picker 修改年月后,自动选中当月1日 [详情](https://ask.dcloud.net.cn/question/165937)
+- 修复 小程序端 低版本 ios NaN [详情](https://ask.dcloud.net.cn/question/162979)
+## 2.2.21(2023-02-20)
+- 修复 firefox 浏览器显示区域点击无法拉起日历弹框的Bug [详情](https://ask.dcloud.net.cn/question/163362)
+## 2.2.20(2023-02-17)
+- 优化 值为空依然选中当天问题
+- 优化 提供 default-value 属性支持配置选择器打开时默认显示的时间
+- 优化 非范围选择未选择日期时间,点击确认按钮选中当前日期时间
+- 优化 字节小程序日期时间范围选择,底部日期换行问题
+## 2.2.19(2023-02-09)
+- 修复 2.2.18 引起范围选择配置 end 选择无效的Bug [详情](https://github.com/dcloudio/uni-ui/issues/686)
+## 2.2.18(2023-02-08)
+- 修复 移动端范围选择change事件触发异常的Bug [详情](https://github.com/dcloudio/uni-ui/issues/684)
+- 优化 PC端输入日期格式错误时返回当前日期时间
+- 优化 PC端输入日期时间超出 start、end 限制的Bug
+- 优化 移动端日期时间范围用法时间展示不完整问题
+## 2.2.17(2023-02-04)
+- 修复 小程序端绑定 Date 类型报错的Bug [详情](https://github.com/dcloudio/uni-ui/issues/679)
+- 修复 vue3 time-picker 无法显示绑定时分秒的Bug
+## 2.2.16(2023-02-02)
+- 修复 字节小程序报错的Bug
+## 2.2.15(2023-02-02)
+## 2.2.14(2023-01-30)
+- 修复 某些情况切换月份错误的Bug [详情](https://ask.dcloud.net.cn/question/162033)
+## 2.2.13(2023-01-10)
+- 修复 多次加载组件造成内存占用的Bug
+## 2.2.12(2022-12-01)
+- 修复 vue3 下 i18n 国际化初始值不正确的Bug
+## 2.2.11(2022-09-19)
+- 修复 支付宝小程序样式错乱的Bug [详情](https://github.com/dcloudio/uni-app/issues/3861)
+## 2.2.10(2022-09-19)
+- 修复 反向选择日期范围,日期显示异常的Bug [详情](https://ask.dcloud.net.cn/question/153401?item_id=212892&rf=false)
+## 2.2.9(2022-09-16)
+## 2.2.8(2022-09-08)
+- 修复 close事件无效的Bug
+## 2.2.7(2022-09-05)
+- 修复 移动端 maskClick 无效的Bug [详情](https://ask.dcloud.net.cn/question/140824)
+## 2.2.6(2022-06-30)
+- 优化 组件样式,调整了组件图标大小、高度、颜色等,与uni-ui风格保持一致
+## 2.2.5(2022-06-24)
+- 修复 日历顶部年月及底部确认未国际化的Bug
+## 2.2.4(2022-03-31)
+- 修复 Vue3 下动态赋值,单选类型未响应的Bug
+## 2.2.3(2022-03-28)
+- 修复 Vue3 下动态赋值未响应的Bug
+## 2.2.2(2021-12-10)
+- 修复 clear-icon 属性在小程序平台不生效的Bug
+## 2.2.1(2021-12-10)
+- 修复 日期范围选在小程序平台,必须多点击一次才能取消选中状态的Bug
+## 2.2.0(2021-11-19)
+- 优化 组件UI,并提供设计资源 [详情](https://uniapp.dcloud.io/component/uniui/resource)
+- 文档迁移 [https://uniapp.dcloud.io/component/uniui/uni-datetime-picker](https://uniapp.dcloud.io/component/uniui/uni-datetime-picker)
+## 2.1.5(2021-11-09)
+- 新增 提供组件设计资源,组件样式调整
+## 2.1.4(2021-09-10)
+- 修复 hide-second 在移动端的Bug
+- 修复 单选赋默认值时,赋值日期未高亮的Bug
+- 修复 赋默认值时,移动端未正确显示时间的Bug
+## 2.1.3(2021-09-09)
+- 新增 hide-second 属性,支持只使用时分,隐藏秒
+## 2.1.2(2021-09-03)
+- 优化 取消选中时(范围选)直接开始下一次选择, 避免多点一次
+- 优化 移动端支持清除按钮,同时支持通过 ref 调用组件的 clear 方法
+- 优化 调整字号大小,美化日历界面
+- 修复 因国际化导致的 placeholder 失效的Bug
+## 2.1.1(2021-08-24)
+- 优化 范围选择器在 pc 端过宽的问题
+## 2.1.0(2021-08-09)
+- 新增 适配 vue3
+## 2.0.19(2021-08-09)
+- 新增 支持作为 uni-forms 子组件相关功能
+- 修复 在 uni-forms 中使用时,选择时间报 NAN 错误的Bug
+## 2.0.18(2021-08-05)
+- 修复 type 属性动态赋值无效的Bug
+- 修复 ‘确认’按钮被 tabbar 遮盖 bug
+- 修复 组件未赋值时范围选左、右日历相同的Bug
+## 2.0.17(2021-08-04)
+- 修复 范围选未正确显示当前值的Bug
+- 修复 h5 平台(移动端)报错 'cale' of undefined 的Bug
+## 2.0.16(2021-07-21)
+- 新增 return-type 属性支持返回 date 日期对象
+## 2.0.15(2021-07-14)
+- 修复 单选日期类型,初始赋值后不在当前日历的Bug
+- 新增 clearIcon 属性,显示框的清空按钮可配置显示隐藏(仅 pc 有效)
+- 优化 移动端移除显示框的清空按钮,无实际用途
+## 2.0.14(2021-07-14)
+- 修复 组件赋值为空,界面未更新的Bug
+- 修复 start 和 end 不能动态赋值的Bug
+- 修复 范围选类型,用户选择后再次选择右侧日历(结束日期)显示不正确的Bug
+## 2.0.13(2021-07-08)
+- 修复 范围选择不能动态赋值的Bug
+## 2.0.12(2021-07-08)
+- 修复 范围选择的初始时间在一个月内时,造成无法选择的bug
+## 2.0.11(2021-07-08)
+- 优化 弹出层在超出视窗边缘定位不准确的问题
+## 2.0.10(2021-07-08)
+- 修复 范围起始点样式的背景色与今日样式的字体前景色融合,导致日期字体看不清的Bug
+- 优化 弹出层在超出视窗边缘被遮盖的问题
+## 2.0.9(2021-07-07)
+- 新增 maskClick 事件
+- 修复 特殊情况日历 rpx 布局错误的Bug,rpx -> px
+- 修复 范围选择时清空返回值不合理的bug,['', ''] -> []
+## 2.0.8(2021-07-07)
+- 新增 日期时间显示框支持插槽
+## 2.0.7(2021-07-01)
+- 优化 添加 uni-icons 依赖
+## 2.0.6(2021-05-22)
+- 修复 图标在小程序上不显示的Bug
+- 优化 重命名引用组件,避免潜在组件命名冲突
+## 2.0.5(2021-05-20)
+- 优化 代码目录扁平化
+## 2.0.4(2021-05-12)
+## 2.0.3(2021-05-10)
+- 修复 ios 下不识别 '-' 日期格式的Bug
+- 优化 pc 下弹出层添加边框和阴影
+## 2.0.2(2021-05-08)
+- 修复 在 admin 中获取弹出层定位错误的bug
+## 2.0.1(2021-05-08)
+- 修复 type 属性向下兼容,默认值从 date 变更为 datetime
+## 2.0.0(2021-04-30)
+- 支持日历形式的日期+时间的范围选择
+ > 注意:此版本不向后兼容,不再支持单独时间选择(type=time)及相关的 hide-second 属性(时间选可使用内置组件 picker)
+## 1.0.6(2021-03-18)
+- 新增 hide-second 属性,时间支持仅选择时、分
+- 修复 选择跟显示的日期不一样的Bug
+- 修复 chang事件触发2次的Bug
+- 修复 分、秒 end 范围错误的Bug
+- 优化 更好的 nvue 适配
@@ -0,0 +1,177 @@
+ 'uni-calendar-item--before-checked-x':weeks.beforeMultiple,
+ 'uni-calendar-item--after-checked-x':weeks.afterMultiple,
+ }" @click="choiceDate(weeks)" @mouseenter="handleMousemove(weeks)">
+ <view class="uni-calendar-item__weeks-box-item" :class="{
+ 'uni-calendar-item--checked':calendar.fullDate === weeks.fullDate && (calendar.userChecked || !checkHover),
+ 'uni-calendar-item--checked-range-text': checkHover,
+ }">
+ <text v-if="selected && weeks.extraInfo" class="uni-calendar-item__weeks-box-circle"></text>
+ <text class="uni-calendar-item__weeks-box-text uni-calendar-item__weeks-box-text-disable uni-calendar-item--checked-text">{{weeks.date}}</text>
+ <view :class="{'uni-calendar-item--today': weeks.isToday}"></view>
+ checkHover: {
+ handleMousemove(weeks) {
+ this.$emit('handleMouse', weeks)
+ margin: 1px 0;
+ // font-family: Lato-Bold, Lato;
+ color: darken($color: $uni-primary, $amount: 40%);
+ background-color: #dd524d;
+ .uni-calendar-item__weeks-box .uni-calendar-item--disable {
+ .uni-calendar-item--disable .uni-calendar-item__weeks-box-text-disable {
+ color: #D1D1D1;
+ .uni-calendar-item--today {
+ top: 10px;
+ right: 17%;
+ width:6px;
+ height: 6px;
+ border-radius: 50%;
+ color: #dd524d;
+ .uni-calendar-item__weeks-box .uni-calendar-item--checked {
+ border: 3px solid #fff;
+ .uni-calendar-item--checked .uni-calendar-item--checked-text {
+ .uni-calendar-item--multiple .uni-calendar-item--checked-range-text {
+ background-color: #F6F7FC;
+ // color: #fff;
+ .uni-calendar-item--multiple .uni-calendar-item--before-checked,
+ .uni-calendar-item--multiple .uni-calendar-item--after-checked {
+ border: 3px solid #F6F7FC;
+ .uni-calendar-item--before-checked .uni-calendar-item--checked-text,
+ .uni-calendar-item--after-checked .uni-calendar-item--checked-text {
+ .uni-calendar-item--before-checked-x {
+ border-top-left-radius: 50px;
+ border-bottom-left-radius: 50px;
+ .uni-calendar-item--after-checked-x {
+ border-top-right-radius: 50px;
+ border-bottom-right-radius: 50px;
@@ -0,0 +1,928 @@
+ <view class="uni-calendar" @mouseleave="leaveCale">
+ <view v-if="!insert && show" class="uni-calendar__mask" :class="{'uni-calendar--mask-show':aniMaskShow}"
+ @click="maskClick"></view>
+ <view v-if="insert || show" class="uni-calendar__content"
+ :class="{'uni-calendar--fixed':!insert,'uni-calendar--ani-show':aniMaskShow, 'uni-calendar__content-mobile': aniMaskShow}">
+ <view class="uni-calendar__header" :class="{'uni-calendar__header-mobile' :!insert}">
+ <view class="uni-calendar__header-btn-box" @click.stop="changeMonth('pre')">
+ <text
+ class="uni-calendar__header-text">{{ (nowDate.year||'') + yearText + ( nowDate.month||'') + monthText}}</text>
+ <view class="uni-calendar__header-btn-box" @click.stop="changeMonth('next')">
+ <view v-if="!insert" class="dialog-close" @click="close">
+ <view class="uni-calendar__weeks" style="padding-bottom: 7px;">
+ <text class="uni-calendar__weeks-day-text">{{MONText}}</text>
+ <calendar-item class="uni-calendar-item--hook" :weeks="weeks" :calendar="calendar"
+ :selected="selected" :checkHover="range" @change="choiceDate"
+ @handleMouse="handleMouse">
+ </calendar-item>
+ <view v-if="!insert && !range && hasTime" class="uni-date-changed uni-calendar--fixed-top"
+ style="padding: 0 80px;">
+ <view class="uni-date-changed--time-date">{{tempSingleDate ? tempSingleDate : selectDateText}}</view>
+ <time-picker type="time" :start="timepickerStartTime" :end="timepickerEndTime" v-model="time"
+ :disabled="!tempSingleDate" :border="false" :hide-second="hideSecond" class="time-picker-style">
+ </time-picker>
+ <view v-if="!insert && range && hasTime" class="uni-date-changed uni-calendar--fixed-top">
+ <view class="uni-date-changed--time-start">
+ <view class="uni-date-changed--time-date">{{tempRange.before ? tempRange.before : startDateText}}
+ <time-picker type="time" :start="timepickerStartTime" v-model="timeRange.startTime" :border="false"
+ :hide-second="hideSecond" :disabled="!tempRange.before" class="time-picker-style">
+ <view style="line-height: 50px;">
+ <uni-icons type="arrowthinright" color="#999"></uni-icons>
+ <view class="uni-date-changed--time-end">
+ <view class="uni-date-changed--time-date">{{tempRange.after ? tempRange.after : endDateText}}</view>
+ <time-picker type="time" :end="timepickerEndTime" v-model="timeRange.endTime" :border="false"
+ :hide-second="hideSecond" :disabled="!tempRange.after" class="time-picker-style">
+ <view v-if="!insert" class="uni-date-changed uni-date-btn--ok">
+ <view class="uni-datetime-picker--btn" @click="confirm">{{confirmText}}</view>
+ import { Calendar, getDate, getTime } from './util.js';
+ import calendarItem from './calendar-item.vue'
+ import timePicker from './time-picker.vue'
+ * @property {[String} defaultValue 选择器打开时默认显示的时间
+ * @example <uni-calendar :insert="true" :start-date="'2019-3-2'":end-date="'2019-5-20'"@change="change" />
+ calendarItem,
+ timePicker
+ defTime: {
+ selectableTimes: {
+ type: [Object],
+ startPlaceholder: {
+ endPlaceholder: {
+ hasTime: {
+ hideSecond: {
+ type: [Boolean],
+ pleStatus: {
+ data: [],
+ fulldate: ''
+ defaultValue: {
+ type: [String, Object, Array],
+ nowDate: {},
+ aniMaskShow: false,
+ firstEnter: true,
+ time: '',
+ timeRange: {
+ startTime: '',
+ endTime: ''
+ tempSingleDate: '',
+ tempRange: {
+ after: ''
+ if (!this.range) {
+ this.tempSingleDate = newVal
+ }, 100)
+ this.time = newVal
+ this.timeRange.startTime = newVal.start
+ this.timeRange.endTime = newVal.end
+ startDate(val) {
+ // 字节小程序 watch 早于 created
+ if(!this.cale){
+ this.cale.setStartDate(val)
+ endDate(val) {
+ this.cale.setEndDate(val)
+ after,
+ fulldate,
+ which
+ } = newVal
+ this.tempRange.before = before
+ this.tempRange.after = after
+ if (fulldate) {
+ this.cale.setHoverMultiple(fulldate)
+ this.cale.lastHover = true
+ if (this.rangeWithinMonth(after, before)) return
+ this.setDate(before)
+ this.cale.setMultiple(fulldate)
+ this.setDate(this.nowDate.fullDate)
+ this.calendar.fullDate = ''
+ this.cale.lastHover = false
+ this.cale.setDefaultMultiple(before, after)
+ if (which === 'left' && before) {
+ } else if(after) {
+ this.setDate(after)
+ }, 16)
+ timepickerStartTime() {
+ const activeDate = this.range ? this.tempRange.before : this.calendar.fullDate
+ return activeDate === this.startDate ? this.selectableTimes.start : ''
+ timepickerEndTime() {
+ const activeDate = this.range ? this.tempRange.after : this.calendar.fullDate
+ return activeDate === this.endDate ? this.selectableTimes.end : ''
+ selectDateText() {
+ return t("uni-datetime-picker.selectDate")
+ startDateText() {
+ return this.startPlaceholder || t("uni-datetime-picker.startDate")
+ endDateText() {
+ return this.endPlaceholder || t("uni-datetime-picker.endDate")
+ return t("uni-datetime-picker.ok")
+ yearText() {
+ return t("uni-datetime-picker.year")
+ monthText() {
+ return t("uni-datetime-picker.month")
+ MONText() {
+ confirmText() {
+ return t("uni-calender.confirm")
+ // 获取日历方法实例
+ // 选中某一天
+ leaveCale() {
+ this.firstEnter = true
+ handleMouse(weeks) {
+ if (this.cale.lastHover) return
+ } = this.cale.multipleStatus
+ if (!before) return
+ // 设置范围选
+ this.cale.setHoverMultiple(this.calendar.fullDate)
+ // hover时,进入一个日历,更新另一个
+ if (this.firstEnter) {
+ this.$emit('firstEnterCale', this.cale.multipleStatus)
+ this.firstEnter = false
+ rangeWithinMonth(A, B) {
+ const [yearA, monthA] = A.split('-')
+ const [yearB, monthB] = B.split('-')
+ return yearA === yearB && monthA === monthB
+ // 蒙版点击事件
+ maskClick() {
+ this.$emit('maskClose')
+ clearCalender() {
+ this.timeRange.startTime = ''
+ this.timeRange.endTime = ''
+ this.tempRange.before = ''
+ this.tempRange.after = ''
+ this.cale.multipleStatus.before = ''
+ this.cale.multipleStatus.after = ''
+ this.cale.multipleStatus.data = []
+ this.time = ''
+ this.tempSingleDate = ''
+ this.setDate(new Date())
+ this.cale.setDate(date || new Date())
+ this.calendar = {...this.nowDate}
+ if(!date){
+ // 优化date为空默认不选中今天
+ if(this.defaultValue && !this.range){
+ // 暂时只支持移动端非范围选择
+ const defaultDate = new Date(this.defaultValue)
+ const fullDate = getDate(defaultDate)
+ const year = defaultDate.getFullYear()
+ const month = defaultDate.getMonth()+1
+ const date = defaultDate.getDate()
+ const day = defaultDate.getDay()
+ this.calendar = {
+ day
+ this.tempSingleDate = fullDate
+ this.time = getTime(defaultDate, this.hideSecond)
+ if(!this.range){
+ if(!this.calendar.fullDate){
+ this.calendar = this.cale.getInfo(new Date())
+ this.tempSingleDate = this.calendar.fullDate
+ if(this.hasTime && !this.time) {
+ this.time = getTime(new Date(), this.hideSecond)
+ time: this.time,
+ timeRange: this.timeRange,
+ this.calendar.userChecked = true
+ this.cale.setMultiple(this.calendar.fullDate, true)
+ const beforeDate = new Date(this.cale.multipleStatus.before).getTime()
+ const afterDate = new Date(this.cale.multipleStatus.after).getTime()
+ if (beforeDate > afterDate && afterDate) {
+ this.tempRange.before = this.cale.multipleStatus.after
+ this.tempRange.after = this.cale.multipleStatus.before
+ this.tempRange.before = this.cale.multipleStatus.before
+ this.tempRange.after = this.cale.multipleStatus.after
+ changeMonth(type) {
+ let newDate
+ if(type === 'pre') {
+ newDate = this.cale.getPreMonthObj(this.nowDate.fullDate).fullDate
+ } else if(type === 'next') {
+ newDate = this.cale.getNextMonthObj(this.nowDate.fullDate).fullDate
+ this.setDate(newDate)
+ background-color: rgba(0, 0, 0, 0.4);
+ .uni-calendar__content-mobile {
+ box-shadow: 0px 0px 5px 3px rgba(0, 0, 0, 0.1);
+ .uni-calendar__header-mobile {
+ padding: 10px;
+ padding-bottom: 0;
+ border-top-color: rgba(0, 0, 0, 0.4);
+ background-color: #f1f1f1;
+ font-size: 15px;
+ .uni-calendar__button-text {
+ letter-spacing: 3px;
+ width: 9px;
+ height: 9px;
+ border-left-color: #808080;
+ border-left-width: 1px;
+ border-top-color: #555555;
+ color: #B2B2B2;
+ // padding: 0 10px;
+ padding-bottom: 7px;
+ .uni-date-changed {
+ // line-height: 50px;
+ border-top-color: #DCDCDC;
+ ;
+ .uni-date-btn--ok {
+ padding: 20px 15px;
+ .uni-date-changed--time-start {
+ .uni-date-changed--time-end {
+ .uni-date-changed--time-date {
+ line-height: 50px;
+ /* #ifdef MP-TOUTIAO */
+ // opacity: 0.6;
+ .time-picker-style {
+ // width: 62px;
+ align-items: center
+ .mr-10 {
+ padding: 0 25px;
+ margin-top: 10px;
+ background-color: #737987;
+ .uni-datetime-picker--btn {
+ line-height: 40px;
+ letter-spacing: 2px;
+ .uni-datetime-picker--btn:active {
+ opacity: 0.7;
+ "uni-datetime-picker.selectDate": "select date",
+ "uni-datetime-picker.selectTime": "select time",
+ "uni-datetime-picker.selectDateTime": "select date and time",
+ "uni-datetime-picker.startDate": "start date",
+ "uni-datetime-picker.endDate": "end date",
+ "uni-datetime-picker.startTime": "start time",
+ "uni-datetime-picker.endTime": "end time",
+ "uni-datetime-picker.ok": "ok",
+ "uni-datetime-picker.clear": "clear",
+ "uni-datetime-picker.cancel": "cancel",
+ "uni-datetime-picker.year": "-",
+ "uni-datetime-picker.month": "",
+ "uni-calender.SUN": "SUN",
+ "uni-calender.confirm": "confirm"
+ "uni-datetime-picker.selectDate": "选择日期",
+ "uni-datetime-picker.selectTime": "选择时间",
+ "uni-datetime-picker.selectDateTime": "选择日期时间",
+ "uni-datetime-picker.startDate": "开始日期",
+ "uni-datetime-picker.endDate": "结束日期",
+ "uni-datetime-picker.startTime": "开始时间",
+ "uni-datetime-picker.endTime": "结束时间",
+ "uni-datetime-picker.ok": "确定",
+ "uni-datetime-picker.clear": "清除",
+ "uni-datetime-picker.cancel": "取消",
+ "uni-datetime-picker.year": "年",
+ "uni-datetime-picker.month": "月",
+ "uni-calender.SAT": "六",
+ "uni-calender.confirm": "确认"
+ "uni-datetime-picker.selectDate": "選擇日期",
+ "uni-datetime-picker.selectTime": "選擇時間",
+ "uni-datetime-picker.selectDateTime": "選擇日期時間",
+ "uni-datetime-picker.startDate": "開始日期",
+ "uni-datetime-picker.endDate": "結束日期",
+ "uni-datetime-picker.startTime": "開始时间",
+ "uni-datetime-picker.endTime": "結束时间",
+ "uni-datetime-picker.ok": "確定",
+ "uni-calender.confirm": "確認"
@@ -0,0 +1,934 @@
+ <view class="uni-datetime-picker">
+ <view @click="initTimePicker">
+ <slot>
+ <view class="uni-datetime-picker-timebox-pointer"
+ :class="{'uni-datetime-picker-disabled': disabled, 'uni-datetime-picker-timebox': border}">
+ <text class="uni-datetime-picker-text">{{time}}</text>
+ <view v-if="!time" class="uni-datetime-picker-time">
+ <text class="uni-datetime-picker-text">{{selectTimeText}}</text>
+ <view v-if="visible" id="mask" class="uni-datetime-picker-mask" @click="tiggerTimePicker"></view>
+ <view v-if="visible" class="uni-datetime-picker-popup" :class="[dateShow && timeShow ? '' : 'fix-nvue-height']"
+ :style="fixNvueBug">
+ <view class="uni-title">
+ <view v-if="dateShow" class="uni-datetime-picker__container-box">
+ <picker-view class="uni-datetime-picker-view" :indicator-style="indicatorStyle" :value="ymd"
+ @change="bindDateChange">
+ <picker-view-column>
+ <view class="uni-datetime-picker-item" v-for="(item,index) in years" :key="index">
+ <text class="uni-datetime-picker-item">{{lessThanTen(item)}}</text>
+ </picker-view-column>
+ <view class="uni-datetime-picker-item" v-for="(item,index) in months" :key="index">
+ <view class="uni-datetime-picker-item" v-for="(item,index) in days" :key="index">
+ </picker-view>
+ <!-- 兼容 nvue 不支持伪类 -->
+ <text class="uni-datetime-picker-sign sign-left">-</text>
+ <text class="uni-datetime-picker-sign sign-right">-</text>
+ <view v-if="timeShow" class="uni-datetime-picker__container-box">
+ <picker-view class="uni-datetime-picker-view" :class="[hideSecond ? 'time-hide-second' : '']"
+ :indicator-style="indicatorStyle" :value="hms" @change="bindTimeChange">
+ <view class="uni-datetime-picker-item" v-for="(item,index) in hours" :key="index">
+ <view class="uni-datetime-picker-item" v-for="(item,index) in minutes" :key="index">
+ <picker-view-column v-if="!hideSecond">
+ <view class="uni-datetime-picker-item" v-for="(item,index) in seconds" :key="index">
+ <text class="uni-datetime-picker-sign" :class="[hideSecond ? 'sign-center' : 'sign-left']">:</text>
+ <text v-if="!hideSecond" class="uni-datetime-picker-sign sign-right">:</text>
+ <view class="uni-datetime-picker-btn">
+ <view @click="clearTime">
+ <text class="uni-datetime-picker-btn-text">{{clearText}}</text>
+ <view class="uni-datetime-picker-btn-group">
+ <view class="uni-datetime-picker-cancel" @click="tiggerTimePicker">
+ <text class="uni-datetime-picker-btn-text">{{cancelText}}</text>
+ <view @click="setTime">
+ <text class="uni-datetime-picker-btn-text">{{okText}}</text>
+ import { fixIosDateFormat } from './util'
+ * DatetimePicker 时间选择器
+ * @description 可以同时选择日期和时间的选择器
+ * @property {String} type = [datetime | date | time] 显示模式
+ * @property {String|Number} value 默认值
+ * @property {String|Number} start 起始日期或时间
+ * @property {String|Number} end 起始日期或时间
+ * @property {String} return-type = [timestamp | string]
+ name: 'UniDatetimePicker',
+ indicatorStyle: `height: 50px;`,
+ visible: false,
+ fixNvueBug: {},
+ dateShow: true,
+ timeShow: true,
+ title: '日期和时间',
+ // 输入框当前时间
+ // 当前的年月日时分秒
+ year: 1920,
+ month: 0,
+ day: 0,
+ hour: 0,
+ minute: 0,
+ second: 0,
+ // 起始时间
+ startYear: 1920,
+ startMonth: 1,
+ startDay: 1,
+ startHour: 0,
+ startMinute: 0,
+ startSecond: 0,
+ // 结束时间
+ endYear: 2120,
+ endMonth: 12,
+ endDay: 31,
+ endHour: 23,
+ endMinute: 59,
+ endSecond: 59,
+ default: 'datetime'
+ end: {
+ returnType: {
+ default: 'string'
+ this.parseValue(fixIosDateFormat(newVal))
+ this.initTime(false)
+ this.parseValue(Date.now())
+ handler(newValue) {
+ if (newValue === 'date') {
+ this.dateShow = true
+ this.timeShow = false
+ this.title = '日期'
+ } else if (newValue === 'time') {
+ this.dateShow = false
+ this.timeShow = true
+ this.title = '时间'
+ this.title = '日期和时间'
+ this.parseDatetimeRange(fixIosDateFormat(newVal), 'start')
+ this.parseDatetimeRange(fixIosDateFormat(newVal), 'end')
+ // 月、日、时、分、秒可选范围变化后,检查当前值是否在范围内,不在则当前值重置为可选范围第一项
+ months(newVal) {
+ this.checkValue('month', this.month, newVal)
+ days(newVal) {
+ this.checkValue('day', this.day, newVal)
+ hours(newVal) {
+ this.checkValue('hour', this.hour, newVal)
+ minutes(newVal) {
+ this.checkValue('minute', this.minute, newVal)
+ seconds(newVal) {
+ this.checkValue('second', this.second, newVal)
+ // 当前年、月、日、时、分、秒选择范围
+ years() {
+ return this.getCurrentRange('year')
+ months() {
+ return this.getCurrentRange('month')
+ days() {
+ return this.getCurrentRange('day')
+ hours() {
+ return this.getCurrentRange('hour')
+ minutes() {
+ return this.getCurrentRange('minute')
+ seconds() {
+ return this.getCurrentRange('second')
+ // picker 当前值数组
+ ymd() {
+ return [this.year - this.minYear, this.month - this.minMonth, this.day - this.minDay]
+ hms() {
+ return [this.hour - this.minHour, this.minute - this.minMinute, this.second - this.minSecond]
+ // 当前 date 是 start
+ currentDateIsStart() {
+ return this.year === this.startYear && this.month === this.startMonth && this.day === this.startDay
+ // 当前 date 是 end
+ currentDateIsEnd() {
+ return this.year === this.endYear && this.month === this.endMonth && this.day === this.endDay
+ // 当前年、月、日、时、分、秒的最小值和最大值
+ minYear() {
+ return this.startYear
+ maxYear() {
+ return this.endYear
+ minMonth() {
+ if (this.year === this.startYear) {
+ return this.startMonth
+ return 1
+ maxMonth() {
+ if (this.year === this.endYear) {
+ return this.endMonth
+ return 12
+ minDay() {
+ if (this.year === this.startYear && this.month === this.startMonth) {
+ return this.startDay
+ maxDay() {
+ if (this.year === this.endYear && this.month === this.endMonth) {
+ return this.endDay
+ return this.daysInMonth(this.year, this.month)
+ minHour() {
+ if (this.type === 'datetime') {
+ if (this.currentDateIsStart) {
+ return this.startHour
+ return 0
+ if (this.type === 'time') {
+ maxHour() {
+ if (this.currentDateIsEnd) {
+ return this.endHour
+ return 23
+ minMinute() {
+ if (this.currentDateIsStart && this.hour === this.startHour) {
+ return this.startMinute
+ if (this.hour === this.startHour) {
+ maxMinute() {
+ if (this.currentDateIsEnd && this.hour === this.endHour) {
+ return this.endMinute
+ return 59
+ if (this.hour === this.endHour) {
+ minSecond() {
+ if (this.currentDateIsStart && this.hour === this.startHour && this.minute === this.startMinute) {
+ return this.startSecond
+ if (this.hour === this.startHour && this.minute === this.startMinute) {
+ maxSecond() {
+ if (this.currentDateIsEnd && this.hour === this.endHour && this.minute === this.endMinute) {
+ return this.endSecond
+ if (this.hour === this.endHour && this.minute === this.endMinute) {
+ selectTimeText() {
+ return t("uni-datetime-picker.selectTime")
+ clearText() {
+ return t("uni-datetime-picker.clear")
+ return t("uni-datetime-picker.cancel")
+ const res = uni.getSystemInfoSync();
+ this.fixNvueBug = {
+ top: res.windowHeight / 2,
+ left: res.windowWidth / 2
+ * 小于 10 在前面加个 0
+ lessThanTen(item) {
+ return item < 10 ? '0' + item : item
+ * 解析时分秒字符串,例如:00:00:00
+ * @param {String} timeString
+ parseTimeType(timeString) {
+ if (timeString) {
+ let timeArr = timeString.split(':')
+ this.hour = Number(timeArr[0])
+ this.minute = Number(timeArr[1])
+ this.second = Number(timeArr[2])
+ * 解析选择器初始值,类型可以是字符串、时间戳,例如:2000-10-02、'08:30:00'、 1610695109000
+ * @param {String | Number} datetime
+ initPickerValue(datetime) {
+ let defaultValue = null
+ if (datetime) {
+ defaultValue = this.compareValueWithStartAndEnd(datetime, this.start, this.end)
+ defaultValue = Date.now()
+ defaultValue = this.compareValueWithStartAndEnd(defaultValue, this.start, this.end)
+ this.parseValue(defaultValue)
+ * 初始值规则:
+ * - 用户设置初始值 value
+ * - 设置了起始时间 start、终止时间 end,并 start < value < end,初始值为 value, 否则初始值为 start
+ * - 只设置了起始时间 start,并 start < value,初始值为 value,否则初始值为 start
+ * - 只设置了终止时间 end,并 value < end,初始值为 value,否则初始值为 end
+ * - 无起始终止时间,则初始值为 value
+ * - 无初始值 value,则初始值为当前本地时间 Date.now()
+ * @param {Object} value
+ * @param {Object} dateBase
+ compareValueWithStartAndEnd(value, start, end) {
+ let winner = null
+ value = this.superTimeStamp(value)
+ start = this.superTimeStamp(start)
+ end = this.superTimeStamp(end)
+ if (start && end) {
+ if (value < start) {
+ winner = new Date(start)
+ } else if (value > end) {
+ winner = new Date(end)
+ winner = new Date(value)
+ } else if (start && !end) {
+ winner = start <= value ? new Date(value) : new Date(start)
+ } else if (!start && end) {
+ winner = value <= end ? new Date(value) : new Date(end)
+ return winner
+ * 转换为可比较的时间戳,接受日期、时分秒、时间戳
+ superTimeStamp(value) {
+ let dateBase = ''
+ if (this.type === 'time' && value && typeof value === 'string') {
+ const now = new Date()
+ const year = now.getFullYear()
+ const month = now.getMonth() + 1
+ const day = now.getDate()
+ dateBase = year + '/' + month + '/' + day + ' '
+ if (Number(value)) {
+ value = parseInt(value)
+ dateBase = 0
+ return this.createTimeStamp(dateBase + value)
+ * 解析默认值 value,字符串、时间戳
+ * @param {Object} defaultTime
+ parseValue(value) {
+ if (!value) {
+ if (this.type === 'time' && typeof value === "string") {
+ this.parseTimeType(value)
+ let defaultDate = null
+ defaultDate = new Date(value)
+ if (this.type !== 'time') {
+ this.year = defaultDate.getFullYear()
+ this.month = defaultDate.getMonth() + 1
+ this.day = defaultDate.getDate()
+ if (this.type !== 'date') {
+ this.hour = defaultDate.getHours()
+ this.minute = defaultDate.getMinutes()
+ this.second = defaultDate.getSeconds()
+ if (this.hideSecond) {
+ this.second = 0
+ * 解析可选择时间范围 start、end,年月日字符串、时间戳
+ parseDatetimeRange(point, pointType) {
+ // 时间为空,则重置为初始值
+ if (!point) {
+ if (pointType === 'start') {
+ this.startYear = 1920
+ this.startMonth = 1
+ this.startDay = 1
+ this.startHour = 0
+ this.startMinute = 0
+ this.startSecond = 0
+ if (pointType === 'end') {
+ this.endYear = 2120
+ this.endMonth = 12
+ this.endDay = 31
+ this.endHour = 23
+ this.endMinute = 59
+ this.endSecond = 59
+ const pointArr = point.split(':')
+ this[pointType + 'Hour'] = Number(pointArr[0])
+ this[pointType + 'Minute'] = Number(pointArr[1])
+ this[pointType + 'Second'] = Number(pointArr[2])
+ pointType === 'start' ? this.startYear = this.year - 60 : this.endYear = this.year + 60
+ if (Number(point)) {
+ point = parseInt(point)
+ // datetime 的 end 没有时分秒, 则不限制
+ const hasTime = /[0-9]:[0-9]/
+ if (this.type === 'datetime' && pointType === 'end' && typeof point === 'string' && !hasTime.test(
+ point)) {
+ point = point + ' 23:59:59'
+ const pointDate = new Date(point)
+ this[pointType + 'Year'] = pointDate.getFullYear()
+ this[pointType + 'Month'] = pointDate.getMonth() + 1
+ this[pointType + 'Day'] = pointDate.getDate()
+ this[pointType + 'Hour'] = pointDate.getHours()
+ this[pointType + 'Minute'] = pointDate.getMinutes()
+ this[pointType + 'Second'] = pointDate.getSeconds()
+ // 获取 年、月、日、时、分、秒 当前可选范围
+ getCurrentRange(value) {
+ const range = []
+ for (let i = this['min' + this.capitalize(value)]; i <= this['max' + this.capitalize(value)]; i++) {
+ range.push(i)
+ return range
+ // 字符串首字母大写
+ capitalize(str) {
+ return str.charAt(0).toUpperCase() + str.slice(1)
+ // 检查当前值是否在范围内,不在则当前值重置为可选范围第一项
+ checkValue(name, value, values) {
+ if (values.indexOf(value) === -1) {
+ this[name] = values[0]
+ // 每个月的实际天数
+ daysInMonth(year, month) { // Use 1 for January, 2 for February, etc.
+ return new Date(year, month, 0).getDate();
+ //兼容 iOS、safari 日期格式
+ fixIosDateFormat(value) {
+ if (typeof value === 'string') {
+ value = value.replace(/-/g, '/')
+ return value
+ * 生成时间戳
+ * @param {Object} time
+ createTimeStamp(time) {
+ if (!time) return
+ if (typeof time === "number") {
+ time = time.replace(/-/g, '/')
+ if (this.type === 'date') {
+ time = time + ' ' + '00:00:00'
+ return Date.parse(time)
+ * 生成日期或时间的字符串
+ createDomSting() {
+ const yymmdd = this.year +
+ '-' +
+ this.lessThanTen(this.month) +
+ this.lessThanTen(this.day)
+ let hhmmss = this.lessThanTen(this.hour) +
+ ':' +
+ this.lessThanTen(this.minute)
+ if (!this.hideSecond) {
+ hhmmss = hhmmss + ':' + this.lessThanTen(this.second)
+ return yymmdd
+ } else if (this.type === 'time') {
+ return hhmmss
+ return yymmdd + ' ' + hhmmss
+ * 初始化返回值,并抛出 change 事件
+ initTime(emit = true) {
+ this.time = this.createDomSting()
+ if (!emit) return
+ if (this.returnType === 'timestamp' && this.type !== 'time') {
+ this.$emit('change', this.createTimeStamp(this.time))
+ this.$emit('input', this.createTimeStamp(this.time))
+ this.$emit('update:modelValue', this.createTimeStamp(this.time))
+ this.$emit('change', this.time)
+ this.$emit('input', this.time)
+ this.$emit('update:modelValue', this.time)
+ * 用户选择日期或时间更新 data
+ * @param {Object} e
+ const val = e.detail.value
+ this.year = this.years[val[0]]
+ this.month = this.months[val[1]]
+ this.day = this.days[val[2]]
+ bindTimeChange(e) {
+ this.hour = this.hours[val[0]]
+ this.minute = this.minutes[val[1]]
+ this.second = this.seconds[val[2]]
+ * 初始化弹出层
+ initTimePicker() {
+ const value = fixIosDateFormat(this.time)
+ this.initPickerValue(value)
+ this.visible = !this.visible
+ * 触发或关闭弹框
+ tiggerTimePicker(e) {
+ * 用户点击“清空”按钮,清空当前值
+ clearTime() {
+ this.tiggerTimePicker()
+ * 用户点击“确定”按钮
+ setTime() {
+ this.initTime()
+ .uni-datetime-picker {
+ /* width: 100%; */
+ .uni-datetime-picker-view {
+ height: 130px;
+ width: 270px;
+ .uni-datetime-picker-item {
+ .uni-datetime-picker-btn {
+ margin-top: 60px;
+ .uni-datetime-picker-btn-text {
+ .uni-datetime-picker-btn-group {
+ .uni-datetime-picker-cancel {
+ margin-right: 30px;
+ .uni-datetime-picker-mask {
+ bottom: 0px;
+ top: 0px;
+ left: 0px;
+ right: 0px;
+ z-index: 998;
+ .uni-datetime-picker-popup {
+ padding: 30px;
+ height: 500px;
+ width: 330px;
+ top: 50%;
+ left: 50%;
+ transform: translate(-50%, -50%);
+ .fix-nvue-height {
+ height: 330px;
+ .uni-datetime-picker-time {
+ .uni-datetime-picker-column {
+ .uni-datetime-picker-timebox {
+ border: 1px solid #E5E5E5;
+ padding: 7px 10px;
+ .uni-datetime-picker-timebox-pointer {
+ .uni-datetime-picker-disabled {
+ cursor: not-allowed !important;
+ .uni-datetime-picker-text {
+ line-height: 50px
+ .uni-datetime-picker-sign {
+ top: 53px;
+ /* 减掉 10px 的元素高度,兼容nvue */
+ .sign-left {
+ left: 86px;
+ .sign-right {
+ right: 86px;
+ .sign-center {
+ left: 135px;
+ .uni-datetime-picker__container-box {
+ margin-top: 40px;
+ .time-hide-second {
+ width: 180px;
@@ -0,0 +1,1026 @@
+ <view class="uni-date">
+ <view class="uni-date-editor" @click="show">
+ class="uni-date-editor--x"
+ :class="{'uni-date-editor--x__disabled': disabled,'uni-date-x--border': border}"
+ <view v-if="!isRange" class="uni-date-x uni-date-single">
+ <uni-icons class="icon-calendar" type="calendar" color="#c0c4cc" size="22"></uni-icons>
+ <view class="uni-date__x-input">{{ displayValue || singlePlaceholderText }}</view>
+ <view v-else class="uni-date-x uni-date-range">
+ <view class="uni-date__x-input text-center">{{ displayRangeValue.startDate || startPlaceholderText }}</view>
+ <view class="range-separator">{{rangeSeparator}}</view>
+ <view class="uni-date__x-input text-center">{{ displayRangeValue.endDate || endPlaceholderText }}</view>
+ <view v-if="showClearIcon" class="uni-date__icon-clear" @click.stop="clear">
+ <uni-icons type="clear" color="#c0c4cc" size="22"></uni-icons>
+ <view v-show="pickerVisible" class="uni-date-mask--pc" @click="close"></view>
+ <view v-if="!isPhone" v-show="pickerVisible" ref="datePicker" class="uni-date-picker__container">
+ <view v-if="!isRange" class="uni-date-single--x" :style="pickerPositionStyle">
+ <view v-if="hasTime" class="uni-date-changed popup-x-header">
+ <input class="uni-date__input text-center" type="text" v-model="inputDate"
+ :placeholder="selectDateText" />
+ <time-picker type="time" v-model="pickerTime" :border="false" :disabled="!inputDate"
+ :start="timepickerStartTime" :end="timepickerEndTime" :hideSecond="hideSecond" style="width: 100%;">
+ <input class="uni-date__input text-center" type="text" v-model="pickerTime" :placeholder="selectTimeText"
+ :disabled="!inputDate" />
+ <Calendar ref="pcSingle" :showMonth="false" :start-date="calendarRange.startDate"
+ :end-date="calendarRange.endDate" :date="calendarDate" @change="singleChange"
+ :default-value="defaultValue"
+ style="padding: 0 8px;" />
+ <view v-if="hasTime" class="popup-x-footer">
+ <text class="confirm-text" @click="confirmSingleChange">{{okText}}</text>
+ <view v-else class="uni-date-range--x" :style="pickerPositionStyle">
+ <view v-if="hasTime" class="popup-x-header uni-date-changed">
+ <view class="popup-x-header--datetime">
+ <input class="uni-date__input uni-date-range__input" type="text" v-model="tempRange.startDate"
+ :placeholder="startDateText" />
+ <time-picker type="time" v-model="tempRange.startTime" :start="timepickerStartTime" :border="false"
+ :disabled="!tempRange.startDate" :hideSecond="hideSecond">
+ <input class="uni-date__input uni-date-range__input" type="text"
+ v-model="tempRange.startTime" :placeholder="startTimeText"
+ :disabled="!tempRange.startDate" />
+ <uni-icons type="arrowthinright" color="#999" style="line-height: 40px;"></uni-icons>
+ <input class="uni-date__input uni-date-range__input" type="text" v-model="tempRange.endDate"
+ :placeholder="endDateText" />
+ <time-picker type="time" v-model="tempRange.endTime" :end="timepickerEndTime" :border="false"
+ :disabled="!tempRange.endDate" :hideSecond="hideSecond">
+ <input class="uni-date__input uni-date-range__input" type="text" v-model="tempRange.endTime"
+ :placeholder="endTimeText" :disabled="!tempRange.endDate" />
+ <view class="popup-x-body">
+ <Calendar ref="left" :showMonth="false" :start-date="calendarRange.startDate"
+ :end-date="calendarRange.endDate" :range="true" :pleStatus="endMultipleStatus"
+ @change="leftChange" @firstEnterCale="updateRightCale" style="padding: 0 8px;" />
+ <Calendar ref="right" :showMonth="false" :start-date="calendarRange.startDate"
+ :end-date="calendarRange.endDate" :range="true" @change="rightChange"
+ :pleStatus="startMultipleStatus" @firstEnterCale="updateLeftCale"
+ style="padding: 0 8px;border-left: 1px solid #F1F1F1;" />
+ <text @click="clear">{{clearText}}</text>
+ <text class="confirm-text" @click="confirmRangeChange">{{okText}}</text>
+ <Calendar v-if="isPhone" ref="mobile" :clearDate="false" :date="calendarDate" :defTime="mobileCalendarTime"
+ :start-date="calendarRange.startDate" :end-date="calendarRange.endDate" :selectableTimes="mobSelectableTime"
+ :startPlaceholder="startPlaceholder" :endPlaceholder="endPlaceholder"
+ :pleStatus="endMultipleStatus" :showMonth="false" :range="isRange" :hasTime="hasTime" :insert="false"
+ :hideSecond="hideSecond" @confirm="mobileChange" @maskClose="close" />
+ * @description 同时支持 PC 和移动端使用日历选择日期和日期范围
+ * @tutorial https://ext.dcloud.net.cn/plugin?id=3962
+ * @property {String} type 选择器类型
+ * @property {String|Number|Array|Date} value 绑定值
+ * @property {String} placeholder 单选择时的占位内容
+ * @property {String} start 起始时间
+ * @property {String} end 终止时间
+ * @property {String} start-placeholder 范围选择时开始日期的占位内容
+ * @property {String} end-placeholder 范围选择时结束日期的占位内容
+ * @property {String} range-separator 选择范围时的分隔符
+ * @property {Boolean} disabled = [true|false] 是否禁用
+ * @property {Boolean} clearIcon = [true|false] 是否显示清除按钮(仅PC端适用)
+ * @event {Function} change 确定日期时触发的事件
+ * @event {Function} maskClick 点击遮罩层触发的事件
+ * @event {Function} show 打开弹出层
+ * @event {Function} close 关闭弹出层
+ * @event {Function} clear 清除上次选中的状态和值
+ **/
+ import Calendar from './calendar.vue'
+ import TimePicker from './time-picker.vue'
+ import { getDateTime, getDate, getTime, getDefaultSecond, dateCompare, checkDate, fixIosDateFormat } from './util'
+ Calendar,
+ TimePicker
+ isRange: false,
+ hasTime: false,
+ displayValue: '',
+ inputDate: '',
+ calendarDate: '',
+ pickerTime: '',
+ calendarRange: {
+ startDate: '',
+ endDate: '',
+ displayRangeValue: {
+ // 左右日历同步数据
+ startMultipleStatus: {
+ endMultipleStatus: {
+ pickerVisible: false,
+ pickerPositionStyle: null,
+ isEmitValue: false,
+ isPhone: false,
+ isFirstShow: true,
+ i18nT: () => {}
+ type: [String, Number, Array, Date],
+ rangeSeparator: {
+ default: '-'
+ this.hasTime = newVal.indexOf('time') !== -1
+ this.isRange = newVal.indexOf('range') !== -1
+ if (this.isEmitValue) {
+ this.isEmitValue = false
+ this.initPicker(newVal)
+ if (!newVal) return
+ this.calendarRange.startDate = getDate(newVal)
+ if (this.hasTime) {
+ this.calendarRange.startTime = getTime(newVal)
+ this.calendarRange.endDate = getDate(newVal)
+ this.calendarRange.endTime = getTime(newVal, this.hideSecond)
+ const activeDate = this.isRange ? this.tempRange.startDate : this.inputDate
+ return activeDate === this.calendarRange.startDate ? this.calendarRange.startTime : ''
+ const activeDate = this.isRange ? this.tempRange.endDate : this.inputDate
+ return activeDate === this.calendarRange.endDate ? this.calendarRange.endTime : ''
+ mobileCalendarTime() {
+ const timeRange = {
+ start: this.tempRange.startTime,
+ end: this.tempRange.endTime
+ return this.isRange ? timeRange : this.pickerTime
+ mobSelectableTime() {
+ start: this.calendarRange.startTime,
+ end: this.calendarRange.endTime
+ datePopupWidth() {
+ // todo
+ return this.isRange ? 653 : 301
+ singlePlaceholderText() {
+ return this.placeholder || (this.type === 'date' ? this.selectDateText : this.selectDateTimeText)
+ startPlaceholderText() {
+ return this.startPlaceholder || this.startDateText
+ endPlaceholderText() {
+ return this.endPlaceholder || this.endDateText
+ return this.i18nT("uni-datetime-picker.selectDate")
+ selectDateTimeText() {
+ return this.i18nT("uni-datetime-picker.selectDateTime")
+ return this.i18nT("uni-datetime-picker.selectTime")
+ return this.startPlaceholder || this.i18nT("uni-datetime-picker.startDate")
+ startTimeText() {
+ return this.i18nT("uni-datetime-picker.startTime")
+ return this.endPlaceholder || this.i18nT("uni-datetime-picker.endDate")
+ endTimeText() {
+ return this.i18nT("uni-datetime-picker.endTime")
+ return this.i18nT("uni-datetime-picker.ok")
+ return this.i18nT("uni-datetime-picker.clear")
+ showClearIcon() {
+ return this.clearIcon && !this.disabled && (this.displayValue || (this.displayRangeValue.startDate && this.displayRangeValue.endDate))
+ this.initI18nT()
+ this.platform()
+ initI18nT() {
+ const vueI18n = initVueI18n(i18nMessages)
+ this.i18nT = vueI18n.t
+ initPicker(newVal) {
+ if ((!newVal && !this.defaultValue) || Array.isArray(newVal) && !newVal.length) {
+ this.clear(false)
+ if (!Array.isArray(newVal) && !this.isRange) {
+ if(newVal){
+ this.displayValue = this.inputDate = this.calendarDate = getDate(newVal)
+ this.pickerTime = getTime(newVal, this.hideSecond)
+ this.displayValue = `${this.displayValue} ${this.pickerTime}`
+ }else if(this.defaultValue){
+ this.inputDate = this.calendarDate = getDate(this.defaultValue)
+ if(this.hasTime){
+ this.pickerTime = getTime(this.defaultValue, this.hideSecond)
+ const [before, after] = newVal
+ if (!before && !after) return
+ const beforeDate = getDate(before)
+ const beforeTime = getTime(before, this.hideSecond)
+ const afterDate = getDate(after)
+ const afterTime = getTime(after, this.hideSecond)
+ const startDate = beforeDate
+ const endDate = afterDate
+ this.displayRangeValue.startDate = this.tempRange.startDate = startDate
+ this.displayRangeValue.endDate = this.tempRange.endDate = endDate
+ this.displayRangeValue.startDate = `${beforeDate} ${beforeTime}`
+ this.displayRangeValue.endDate = `${afterDate} ${afterTime}`
+ this.tempRange.startTime = beforeTime
+ this.tempRange.endTime = afterTime
+ const defaultRange = {
+ before: beforeDate,
+ after: afterDate
+ this.startMultipleStatus = Object.assign({}, this.startMultipleStatus, defaultRange, {
+ which: 'right'
+ this.endMultipleStatus = Object.assign({}, this.endMultipleStatus, defaultRange, {
+ which: 'left'
+ updateLeftCale(e) {
+ const left = this.$refs.left
+ left.cale.setHoverMultiple(e.after)
+ left.setDate(this.$refs.left.nowDate.fullDate)
+ updateRightCale(e) {
+ const right = this.$refs.right
+ right.cale.setHoverMultiple(e.after)
+ right.setDate(this.$refs.right.nowDate.fullDate)
+ platform() {
+ const { windowWidth } = uni.getSystemInfoSync()
+ this.isPhone = windowWidth <= 500
+ this.windowWidth = windowWidth
+ if (this.isPhone) {
+ this.$refs.mobile.open()
+ this.pickerPositionStyle = {
+ top: '10px'
+ const dateEditor = uni.createSelectorQuery().in(this).select(".uni-date-editor")
+ dateEditor.boundingClientRect(rect => {
+ if (this.windowWidth - rect.left < this.datePopupWidth) {
+ this.pickerPositionStyle.right = 0
+ }).exec()
+ this.pickerVisible = !this.pickerVisible
+ if (!this.isPhone && this.isRange && this.isFirstShow) {
+ this.isFirstShow = false
+ endDate
+ } = this.calendarRange
+ if (startDate && endDate) {
+ if (this.diffDate(startDate, endDate) < 30) {
+ this.$refs.right.changeMonth('pre')
+ this.$refs.right.changeMonth('next')
+ this.$refs.right.cale.lastHover = false
+ this.pickerVisible = false
+ this.$emit('maskClick', this.value)
+ this.$refs.mobile && this.$refs.mobile.close()
+ }, 20)
+ setEmit(value) {
+ if (this.returnType === "timestamp" || this.returnType === "date") {
+ if (!this.hasTime) {
+ value = value + ' ' + '00:00:00'
+ value = this.createTimestamp(value)
+ if (this.returnType === "date") {
+ value = new Date(value)
+ value[0] = value[0] + ' ' + '00:00:00'
+ value[1] = value[1] + ' ' + '00:00:00'
+ value[0] = this.createTimestamp(value[0])
+ value[1] = this.createTimestamp(value[1])
+ value[0] = new Date(value[0])
+ value[1] = new Date(value[1])
+ this.$emit('update:modelValue', value)
+ this.$emit('input', value)
+ this.$emit('change', value)
+ this.isEmitValue = true
+ createTimestamp(date) {
+ date = fixIosDateFormat(date)
+ return Date.parse(new Date(date))
+ singleChange(e) {
+ this.calendarDate = this.inputDate = e.fulldate
+ if (this.hasTime) return
+ this.confirmSingleChange()
+ confirmSingleChange() {
+ if(!checkDate(this.inputDate)){
+ this.calendarDate = this.inputDate = getDate(now)
+ this.pickerTime = getTime(now, this.hideSecond)
+ let startLaterInputDate = false
+ let startDate, startTime
+ if(this.start) {
+ let startString = this.start
+ if(typeof this.start === 'number'){
+ startString = getDateTime(this.start, this.hideSecond)
+ [startDate, startTime] = startString.split(' ')
+ if(this.start && !dateCompare(startDate, this.inputDate)) {
+ startLaterInputDate = true
+ this.inputDate = startDate
+ let endEarlierInputDate = false
+ let endDate, endTime
+ if(this.end) {
+ let endString = this.end
+ if(typeof this.end === 'number'){
+ endString = getDateTime(this.end, this.hideSecond)
+ [endDate, endTime] = endString.split(' ')
+ if(this.end && !dateCompare(this.inputDate, endDate)) {
+ endEarlierInputDate = true
+ this.inputDate = endDate
+ if(startLaterInputDate){
+ this.pickerTime = startTime || getDefaultSecond(this.hideSecond)
+ if(endEarlierInputDate){
+ this.pickerTime = endTime || getDefaultSecond(this.hideSecond)
+ if(!this.pickerTime){
+ this.pickerTime = getTime(Date.now(), this.hideSecond)
+ this.displayValue = `${this.inputDate} ${this.pickerTime}`
+ this.displayValue = this.inputDate
+ this.setEmit(this.displayValue)
+ leftChange(e) {
+ } = e.range
+ this.rangeChange(before, after)
+ const obj = {
+ before: e.range.before,
+ after: e.range.after,
+ data: e.range.data,
+ fulldate: e.fulldate
+ this.startMultipleStatus = Object.assign({}, this.startMultipleStatus, obj)
+ rightChange(e) {
+ this.endMultipleStatus = Object.assign({}, this.endMultipleStatus, obj)
+ mobileChange(e) {
+ if (this.isRange) {
+ const {before, after} = e.range
+ if(!before || !after){
+ this.handleStartAndEnd(before, after, true)
+ startTime,
+ endTime
+ } = e.timeRange
+ this.tempRange.startTime = startTime
+ this.tempRange.endTime = endTime
+ this.confirmRangeChange()
+ this.displayValue = e.fulldate + ' ' + e.time
+ this.displayValue = e.fulldate
+ this.$refs.mobile.close()
+ rangeChange(before, after) {
+ if (!(before && after)) return
+ confirmRangeChange() {
+ if (!this.tempRange.startDate || !this.tempRange.endDate) {
+ if(!checkDate(this.tempRange.startDate)){
+ this.tempRange.startDate = getDate(Date.now())
+ if(!checkDate(this.tempRange.endDate)){
+ this.tempRange.endDate = getDate(Date.now())
+ let start, end
+ let startDateLaterRangeStartDate = false
+ let startDateLaterRangeEndDate = false
+ [startDate,startTime] = startString.split(' ')
+ if(this.start && !dateCompare(this.start, this.tempRange.startDate)) {
+ startDateLaterRangeStartDate = true
+ this.tempRange.startDate = startDate
+ if(this.start && !dateCompare(this.start, this.tempRange.endDate)) {
+ startDateLaterRangeEndDate = true
+ this.tempRange.endDate = startDate
+ let endDateEarlierRangeStartDate = false
+ let endDateEarlierRangeEndDate = false
+ [endDate,endTime] = endString.split(' ')
+ if(this.end && !dateCompare(this.tempRange.startDate, this.end)) {
+ endDateEarlierRangeStartDate = true
+ this.tempRange.startDate = endDate
+ if(this.end && !dateCompare(this.tempRange.endDate, this.end)) {
+ endDateEarlierRangeEndDate = true
+ this.tempRange.endDate = endDate
+ start = this.displayRangeValue.startDate = this.tempRange.startDate
+ end = this.displayRangeValue.endDate = this.tempRange.endDate
+ if(startDateLaterRangeStartDate){
+ this.tempRange.startTime = startTime || getDefaultSecond(this.hideSecond)
+ }else if(endDateEarlierRangeStartDate){
+ this.tempRange.startTime = endTime || getDefaultSecond(this.hideSecond)
+ if(!this.tempRange.startTime){
+ this.tempRange.startTime = getTime(Date.now(), this.hideSecond)
+ if(startDateLaterRangeEndDate){
+ this.tempRange.endTime = startTime || getDefaultSecond(this.hideSecond)
+ }else if(endDateEarlierRangeEndDate){
+ this.tempRange.endTime = endTime || getDefaultSecond(this.hideSecond)
+ if(!this.tempRange.endTime){
+ this.tempRange.endTime = getTime(Date.now(), this.hideSecond)
+ start = this.displayRangeValue.startDate = `${this.tempRange.startDate} ${this.tempRange.startTime}`
+ end = this.displayRangeValue.endDate = `${this.tempRange.endDate} ${this.tempRange.endTime}`
+ if(!dateCompare(start,end)){
+ [start, end] = [end, start]
+ this.displayRangeValue.startDate = start
+ this.displayRangeValue.endDate = end
+ const displayRange = [start, end]
+ this.setEmit(displayRange)
+ handleStartAndEnd(before, after, temp = false) {
+ const type = temp ? 'tempRange' : 'range'
+ const isStartEarlierEnd = dateCompare(before, after)
+ this[type].startDate = isStartEarlierEnd ? before : after
+ this[type].endDate = isStartEarlierEnd ? after : before
+ return startDate <= endDate
+ * 比较时间差
+ diffDate(startDate, endDate) {
+ const diff = (endDate - startDate) / (24 * 60 * 60 * 1000)
+ return Math.abs(diff)
+ clear(needEmit = true) {
+ if (!this.isRange) {
+ this.displayValue = ''
+ this.inputDate = ''
+ this.pickerTime = ''
+ this.$refs.mobile && this.$refs.mobile.clearCalender()
+ this.$refs.pcSingle && this.$refs.pcSingle.clearCalender()
+ if (needEmit) {
+ this.$emit('change', '')
+ this.$emit('input', '')
+ this.$emit('update:modelValue', '')
+ this.displayRangeValue.startDate = ''
+ this.displayRangeValue.endDate = ''
+ this.tempRange.startDate = ''
+ this.tempRange.startTime = ''
+ this.tempRange.endDate = ''
+ this.tempRange.endTime = ''
+ this.$refs.left && this.$refs.left.clearCalender()
+ this.$refs.right && this.$refs.right.clearCalender()
+ this.$refs.right && this.$refs.right.changeMonth('next')
+ this.$emit('change', [])
+ this.$emit('input', [])
+ this.$emit('update:modelValue', [])
+ .uni-date {
+ .uni-date-x {
+ .icon-calendar{
+ padding-left: 3px;
+ .range-separator{
+ /* #ifndef MP */
+ padding: 0 2px;
+ .uni-date-x--border {
+ .uni-date-editor--x {
+ .uni-date-editor--x .uni-date__icon-clear {
+ padding-right: 3px;
+ .uni-date__x-input {
+ width: auto;
+ padding-left: 5px;
+ .text-center {
+ .uni-date__input {
+ .uni-date-range__input {
+ max-width: 142px;
+ .uni-date-picker__container {
+ .uni-date-mask--pc {
+ background-color: rgba(0, 0, 0, 0);
+ z-index: 996;
+ .uni-date-single--x {
+ .uni-date-range--x {
+ .uni-date-editor--x__disabled {
+ .uni-date-editor--logo {
+ /* 添加时间 */
+ .popup-x-header {
+ .popup-x-header--datetime {
+ .popup-x-body {
+ .popup-x-footer {
+ border-top-color: #F1F1F1;
+ text-align: right;
+ .popup-x-footer text:hover {
+ .popup-x-footer .confirm-text {
+ margin-left: 20px;
+ border-bottom-color: #F1F1F1;
+ .uni-date-changed--time text {
+ .uni-date-changed .uni-date-changed--time {
+ opacity: 0.6;
+ .mr-50 {
+ margin-right: 50px;
+ border: 6px solid transparent;
@@ -0,0 +1,403 @@
+ range,
+ this.date = this.getDateObj(new Date()) // 当前初入日期
+ // 终止时间
+ // 是否范围选择
+ this.lastHover = false
+ const selectDate = this.getDateObj(date)
+ this.getWeeks(selectDate.fullDate)
+ setStartDate(startDate) {
+ setEndDate(endDate) {
+ getPreMonthObj(date){
+ date = new Date(date)
+ const oldMonth = date.getMonth()
+ date.setMonth(oldMonth - 1)
+ const newMonth = date.getMonth()
+ if(oldMonth !== 0 && newMonth - oldMonth === 0){
+ date.setMonth(newMonth - 1)
+ return this.getDateObj(date)
+ getNextMonthObj(date){
+ date.setMonth(oldMonth + 1)
+ if(newMonth - oldMonth > 1){
+ * 获取指定格式Date对象
+ getDateObj(date) {
+ fullDate: getDate(date),
+ month: addZero(date.getMonth() + 1),
+ date: addZero(date.getDate()),
+ day: date.getDay()
+ * 获取上一个月日期集合
+ getPreMonthDays(amount, dateObj) {
+ const result = []
+ for (let i = amount - 1; i >= 0; i--) {
+ const month = dateObj.month - 1
+ result.push({
+ date: new Date(dateObj.year, month, -i).getDate(),
+ * 获取本月日期集合
+ getCurrentMonthDays(amount, dateObj) {
+ const fullDate = this.date.fullDate
+ for (let i = 1; i <= amount; i++) {
+ const currentDate = `${dateObj.year}-${dateObj.month}-${addZero(i)}`
+ const isToday = fullDate === currentDate
+ const info = this.selected && this.selected.find((item) => {
+ if (this.dateEqual(currentDate, item.date)) {
+ disableBefore = dateCompare(this.startDate, currentDate)
+ disableAfter = dateCompare(currentDate, this.endDate)
+ if (this.range && multiples) {
+ return this.dateEqual(item, currentDate)
+ const checked = multiplesStatus !== -1
+ fullDate: currentDate,
+ year: dateObj.year,
+ beforeMultiple: this.isLogicBefore(currentDate, this.multipleStatus.before, this.multipleStatus.after),
+ afterMultiple: this.isLogicAfter(currentDate, this.multipleStatus.before, this.multipleStatus.after),
+ month: dateObj.month,
+ disable: (this.startDate && !dateCompare(this.startDate, currentDate)) || (this.endDate && !dateCompare(currentDate,this.endDate)),
+ isToday,
+ userChecked: false,
+ extraInfo: info
+ * 获取下一个月日期集合
+ _getNextMonthDays(amount, dateObj) {
+ const month = dateObj.month + 1
+ return this.calendar.find(item => item.fullDate === this.getDateObj(date).fullDate)
+ before = new Date(fixIosDateFormat(before))
+ after = new Date(fixIosDateFormat(after))
+ return before.valueOf() === after.valueOf()
+ * 比较真实起始日期
+ isLogicBefore(currentDate, before, after) {
+ let logicBefore = before
+ logicBefore = dateCompare(before, after) ? before : after
+ return this.dateEqual(logicBefore, currentDate)
+ isLogicAfter(currentDate, before, after) {
+ let logicAfter = after
+ logicAfter = dateCompare(before, after) ? after : before
+ return this.dateEqual(logicAfter, currentDate)
+ arr.push(this.getDateObj(new Date(parseInt(k))).fullDate)
+ if (!this.lastHover) {
+ this.lastHover = true
+ this.multipleStatus.fulldate = ''
+ if (dateCompare(this.multipleStatus.before, this.multipleStatus.after)) {
+ this.multipleStatus.data = this.geDateAll(this.multipleStatus.before, this.multipleStatus
+ .after);
+ this.multipleStatus.data = this.geDateAll(this.multipleStatus.after, this.multipleStatus
+ .before);
+ this.getWeeks(fullDate)
+ * 鼠标 hover 更新多选状态
+ setHoverMultiple(fullDate) {
+ if (!this.range || this.lastHover) return
+ const { before } = this.multipleStatus
+ * 更新默认值多选状态
+ setDefaultMultiple(before, after) {
+ this.multipleStatus.before = before
+ this.multipleStatus.after = after
+ if (dateCompare(before, after)) {
+ this.multipleStatus.data = this.geDateAll(before, after);
+ this.getWeeks(after)
+ this.multipleStatus.data = this.geDateAll(after, before);
+ this.getWeeks(before)
+ getWeeks(dateData) {
+ } = this.getDateObj(dateData)
+ const preMonthDayAmount = new Date(year, month - 1, 1).getDay()
+ const preMonthDays = this.getPreMonthDays(preMonthDayAmount, this.getDateObj(dateData))
+ const currentMonthDayAmount = new Date(year, month, 0).getDate()
+ const currentMonthDays = this.getCurrentMonthDays(currentMonthDayAmount, this.getDateObj(dateData))
+ const nextMonthDayAmount = 42 - preMonthDayAmount - currentMonthDayAmount
+ const nextMonthDays = this._getNextMonthDays(nextMonthDayAmount, this.getDateObj(dateData))
+ const calendarDays = [...preMonthDays, ...currentMonthDays, ...nextMonthDays]
+ const weeks = new Array(6)
+ for (let i = 0; i < calendarDays.length; i++) {
+ const index = Math.floor(i / 7)
+ if(!weeks[index]){
+ weeks[index] = new Array(7)
+ weeks[index][i % 7] = calendarDays[i]
+ this.calendar = calendarDays
+function getDateTime(date, hideSecond){
+ return `${getDate(date)} ${getTime(date, hideSecond)}`
+function getDate(date) {
+ const year = date.getFullYear()
+ const month = date.getMonth()+1
+ const day = date.getDate()
+ return `${year}-${addZero(month)}-${addZero(day)}`
+function getTime(date, hideSecond){
+ const hour = date.getHours()
+ const minute = date.getMinutes()
+ const second = date.getSeconds()
+ return hideSecond ? `${addZero(hour)}:${addZero(minute)}` : `${addZero(hour)}:${addZero(minute)}:${addZero(second)}`
+function addZero(num) {
+ if(num < 10){
+ num = `0${num}`
+ return num
+function getDefaultSecond(hideSecond) {
+ return hideSecond ? '00:00' : '00:00:00'
+function dateCompare(startDate, endDate) {
+ startDate = new Date(fixIosDateFormat(startDate))
+ endDate = new Date(fixIosDateFormat(endDate))
+function checkDate(date){
+ const dateReg = /((19|20)\d{2})(-|\/)\d{1,2}(-|\/)\d{1,2}/g
+ return date.match(dateReg)
+const dateTimeReg = /^\d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])( [0-5][0-9]:[0-5][0-9]:[0-5][0-9])?$/
+function fixIosDateFormat(value) {
+ if (typeof value === 'string' && dateTimeReg.test(value)) {
+export {Calendar, getDateTime, getDate, getTime, addZero, getDefaultSecond, dateCompare, checkDate, fixIosDateFormat}
@@ -0,0 +1,87 @@
+ "id": "uni-datetime-picker",
+ "displayName": "uni-datetime-picker 日期选择器",
+ "version": "2.2.22",
+ "description": "uni-datetime-picker 日期时间选择器,支持日历,支持范围选择",
+ "uni-datetime-picker",
+ "日期时间选择器",
+ "日期时间"
@@ -0,0 +1,21 @@
+> `重要通知:组件升级更新 2.0.0 后,支持日期+时间范围选择,组件 ui 将使用日历选择日期,ui 变化较大,同时支持 PC 和 移动端。此版本不向后兼容,不再支持单独的时间选择(type=time)及相关的 hide-second 属性(时间选可使用内置组件 picker)。若仍需使用旧版本,可在插件市场下载*非uni_modules版本*,旧版本将不再维护`
+## DatetimePicker 时间选择器
+> **组件名:uni-datetime-picker**
+> 代码块: `uDatetimePicker`
+该组件的优势是,支持**时间戳**输入和输出(起始时间、终止时间也支持时间戳),可**同时选择**日期和时间。
+若只是需要单独选择日期和时间,不需要时间戳输入和输出,可使用原生的 picker 组件。
+**_点击 picker 默认值规则:_**
+- 若设置初始值 value, 会显示在 picker 显示框中
+- 若无初始值 value,则初始值 value 为当前本地时间 Date.now(), 但不会显示在 picker 显示框中
+### [查看文档](https://uniapp.dcloud.io/component/uniui/uni-datetime-picker)
@@ -0,0 +1,13 @@
+## 1.2.1(2021-11-22)
+- 文档迁移,详见:[https://uniapp.dcloud.io/component/uniui/uni-drawer](https://uniapp.dcloud.io/component/uniui/uni-drawer)
+## 1.1.0(2021-07-13)
+## 1.0.7(2021-05-12)
+ // this.$once('hook:beforeDestroy', () => {
+ // document.removeEventListener('keyup', listener)
+ // })
@@ -0,0 +1,183 @@
+ <view v-if="visibleSync" :class="{ 'uni-drawer--visible': showDrawer }" class="uni-drawer" @touchmove.stop.prevent="clear">
+ <view class="uni-drawer__mask" :class="{ 'uni-drawer__mask--visible': showDrawer && mask }" @tap="close('mask')" />
+ <view class="uni-drawer__content" :class="{'uni-drawer--right': rightMode,'uni-drawer--left': !rightMode, 'uni-drawer__content--visible': showDrawer}" :style="{width:drawerWidth+'px'}">
+ <!-- #ifdef H5 -->
+ <keypress @esc="close('mask')" />
+ <!-- #endif -->
+ // #ifdef H5
+ import keypress from './keypress.js'
+ * Drawer 抽屉
+ * @description 抽屉侧滑菜单
+ * @tutorial https://ext.dcloud.net.cn/plugin?id=26
+ * @property {Boolean} mask = [true | false] 是否显示遮罩
+ * @property {Boolean} maskClick = [true | false] 点击遮罩是否关闭
+ * @property {Boolean} mode = [left | right] Drawer 滑出位置
+ * @value left 从左侧滑出
+ * @value right 从右侧侧滑出
+ * @property {Number} width 抽屉的宽度 ,仅 vue 页面生效
+ * @event {Function} close 组件关闭时触发事件
+ name: 'UniDrawer',
+ keypress
+ * 显示模式(左、右),只在初始化生效
+ * 蒙层显示状态
+ mask: {
+ * 遮罩是否可点击关闭
+ maskClick:{
+ * 抽屉宽度
+ width: {
+ default: 220
+ visibleSync: false,
+ showDrawer: false,
+ rightMode: false,
+ watchTimer: null,
+ drawerWidth: 220
+ this.drawerWidth = this.width
+ this.rightMode = this.mode === 'right'
+ clear(){},
+ close(type) {
+ // fixed by mehaotian 抽屉尚未完全关闭或遮罩禁止点击时不触发以下逻辑
+ if((type === 'mask' && !this.maskClick) || !this.visibleSync) return
+ this._change('showDrawer', 'visibleSync', false)
+ // fixed by mehaotian 处理重复点击打开的事件
+ if(this.visibleSync) return
+ this._change('visibleSync', 'showDrawer', true)
+ _change(param1, param2, status) {
+ this[param1] = status
+ if (this.watchTimer) {
+ clearTimeout(this.watchTimer)
+ this.watchTimer = setTimeout(() => {
+ this[param2] = status
+ this.$emit('change',status)
+ }, status ? 50 : 300)
+ $uni-mask: rgba($color: #000000, $alpha: 0.4) ;
+ // 抽屉宽度
+ $drawer-width: 220px;
+ .uni-drawer {
+ .uni-drawer__content {
+ width: $drawer-width;
+ background-color: $uni-bg-color;
+ transition: transform 0.3s ease;
+ .uni-drawer--left {
+ transform: translateX(-$drawer-width);
+ transform: translateX(-100%);
+ .uni-drawer--right {
+ transform: translateX($drawer-width);
+ transform: translateX(100%);
+ .uni-drawer__content--visible {
+ transform: translateX(0px);
+ .uni-drawer__mask {
+ background-color: $uni-mask;
+ transition: opacity 0.3s;
+ .uni-drawer__mask--visible {
+ "id": "uni-drawer",
+ "displayName": "uni-drawer 抽屉",
+ "version": "1.2.1",
+ "description": "抽屉式导航,用于展示侧滑菜单,侧滑导航。",
+ "drawer",
+ "抽屉",
+ "侧滑导航"
+## Drawer 抽屉
+> **组件名:uni-drawer**
+> 代码块: `uDrawer`
+抽屉侧滑菜单。
+### [查看文档](https://uniapp.dcloud.io/component/uniui/uni-drawer)
@@ -0,0 +1,97 @@
+## 1.1.9(2023-04-11)
+- 修复 vue3 下 keyboardheightchange 事件报错的bug
+## 1.1.8(2023-03-29)
+- 优化 trim 属性默认值
+## 1.1.7(2023-03-29)
+- 新增 cursor-spacing 属性
+## 1.1.6(2023-01-28)
+- 新增 keyboardheightchange 事件,可监听键盘高度变化
+## 1.1.5(2022-11-29)
+- 优化 主题样式
+## 1.1.4(2022-10-27)
+- 修复 props 中背景颜色无默认值的bug
+## 1.1.0(2022-06-30)
+- 新增 在 uni-forms 1.4.0 中使用可以在 blur 时校验内容
+- 新增 clear 事件,点击右侧叉号图标触发
+- 新增 change 事件 ,仅在输入框失去焦点或用户按下回车时触发
+- 优化 组件样式,组件获取焦点时高亮显示,图标颜色调整等
+## 1.0.5(2022-06-07)
+- 优化 clearable 显示策略
+## 1.0.4(2022-06-07)
+## 1.0.3(2022-05-20)
+- 修复 关闭图标某些情况下无法取消的 bug
+## 1.0.2(2022-04-12)
+- 修复 默认值不生效的 bug
+## 1.0.1(2022-04-02)
+- 修复 value 不能为 0 的 bug
+- 文档迁移,详见:[https://uniapp.dcloud.io/component/uniui/uni-easyinput](https://uniapp.dcloud.io/component/uniui/uni-easyinput)
+## 0.1.4(2021-08-20)
+- 修复 在 uni-forms 的动态表单中默认值校验不通过的 bug
+## 0.1.3(2021-08-11)
+## 0.1.2(2021-07-30)
+- 优化 vue3 下事件警告的问题
+## 0.1.1
+- 优化 errorMessage 属性支持 Boolean 类型
+## 0.1.0(2021-07-13)
+## 0.0.16(2021-06-29)
+- 修复 confirmType 属性(仅 type="text" 生效)导致多行文本框无法换行的 bug
+## 0.0.15(2021-06-21)
+- 修复 passwordIcon 属性拼写错误的 bug
+## 0.0.14(2021-06-18)
+- 新增 passwordIcon 属性,当 type=password 时是否显示小眼睛图标
+- 修复 confirmType 属性不生效的问题
+## 0.0.13(2021-06-04)
+- 修复 disabled 状态可清出内容的 bug
+## 0.0.12(2021-05-12)
+## 0.0.11(2021-05-07)
+- 修复 input-border 属性不生效的问题
+## 0.0.10(2021-04-30)
+- 修复 ios 遮挡文字、显示一半的问题
+## 0.0.9(2021-02-05)
+- 优化 兼容 nvue 页面
@@ -0,0 +1,56 @@
+ * @desc 函数防抖
+ * @param func 目标函数
+ * @param wait 延迟执行毫秒数
+ * @param immediate true - 立即执行, false - 延迟执行
+export const debounce = function(func, wait = 1000, immediate = true) {
+ let timer;
+ console.log(1);
+ return function() {
+ console.log(123);
+ let context = this,
+ args = arguments;
+ if (timer) clearTimeout(timer);
+ if (immediate) {
+ let callNow = !timer;
+ timer = null;
+ }, wait);
+ if (callNow) func.apply(context, args);
+ func.apply(context, args);
+ }, wait)
+ * @desc 函数节流
+ * @param func 函数
+ * @param type 1 使用表时间戳,在时间段开始的时候触发 2 使用表定时器,在时间段结束的时候触发
+export const throttle = (func, wait = 1000, type = 1) => {
+ let previous = 0;
+ let timeout;
+ let context = this;
+ let args = arguments;
+ if (type === 1) {
+ let now = Date.now();
+ if (now - previous > wait) {
+ previous = now;
+ } else if (type === 2) {
+ if (!timeout) {
+ timeout = setTimeout(() => {
+ timeout = null;
+ func.apply(context, args)
@@ -0,0 +1,657 @@
+ <view class="uni-easyinput" :class="{ 'uni-easyinput-error': msg }" :style="boxStyle">
+ <view class="uni-easyinput__content" :class="inputContentClass" :style="inputContentStyle">
+ <uni-icons v-if="prefixIcon" class="content-clear-icon" :type="prefixIcon" color="#c0c4cc" @click="onClickIcon('prefix')" size="22"></uni-icons>
+ <textarea
+ v-if="type === 'textarea'"
+ class="uni-easyinput__content-textarea"
+ :class="{ 'input-padding': inputBorder }"
+ :name="name"
+ :value="val"
+ :placeholder="placeholder"
+ :placeholderStyle="placeholderStyle"
+ :disabled="disabled"
+ placeholder-class="uni-easyinput__placeholder-class"
+ :maxlength="inputMaxlength"
+ :focus="focused"
+ :autoHeight="autoHeight"
+ :cursor-spacing="cursorSpacing"
+ @input="onInput"
+ @blur="_Blur"
+ @focus="_Focus"
+ @confirm="onConfirm"
+ @keyboardheightchange="onkeyboardheightchange"
+ ></textarea>
+ <input
+ v-else
+ :type="type === 'password' ? 'text' : type"
+ class="uni-easyinput__content-input"
+ :style="inputStyle"
+ :password="!showPassword && type === 'password'"
+ :confirmType="confirmType"
+ <template v-if="type === 'password' && passwordIcon">
+ <!-- 开启密码时显示小眼睛 -->
+ <uni-icons
+ v-if="isVal"
+ class="content-clear-icon"
+ :class="{ 'is-textarea-icon': type === 'textarea' }"
+ :type="showPassword ? 'eye-slash-filled' : 'eye-filled'"
+ :size="22"
+ :color="focusShow ? primaryColor : '#c0c4cc'"
+ @click="onEyes"
+ ></uni-icons>
+ <template v-else-if="suffixIcon">
+ <uni-icons v-if="suffixIcon" class="content-clear-icon" :type="suffixIcon" color="#c0c4cc" @click="onClickIcon('suffix')" size="22"></uni-icons>
+ v-if="clearable && isVal && !disabled && type !== 'textarea'"
+ type="clear"
+ :size="clearSize"
+ :color="msg ? '#dd524d' : focusShow ? primaryColor : '#c0c4cc'"
+ @click="onClear"
+ <slot name="right"></slot>
+ * Easyinput 输入框
+ * @description 此组件可以实现表单的输入与校验,包括 "text" 和 "textarea" 类型。
+ * @tutorial https://ext.dcloud.net.cn/plugin?id=3455
+ * @property {String} value 输入内容
+ * @property {String } type 输入框的类型(默认text) password/text/textarea/..
+ * @value text 文本输入键盘
+ * @value textarea 多行文本输入键盘
+ * @value password 密码输入键盘
+ * @value number 数字输入键盘,注意iOS上app-vue弹出的数字键盘并非9宫格方式
+ * @value idcard 身份证输入键盘,信、支付宝、百度、QQ小程序
+ * @value digit 带小数点的数字键盘 ,App的nvue页面、微信、支付宝、百度、头条、QQ小程序支持
+ * @property {Boolean} clearable 是否显示右侧清空内容的图标控件,点击可清空输入框内容(默认true)
+ * @property {Boolean} autoHeight 是否自动增高输入区域,type为textarea时有效(默认true)
+ * @property {String } placeholder 输入框的提示文字
+ * @property {String } placeholderStyle placeholder的样式(内联样式,字符串),如"color: #ddd"
+ * @property {Boolean} focus 是否自动获得焦点(默认false)
+ * @property {Boolean} disabled 是否禁用(默认false)
+ * @property {Number } maxlength 最大输入长度,设置为 -1 的时候不限制最大长度(默认140)
+ * @property {String } confirmType 设置键盘右下角按钮的文字,仅在type="text"时生效(默认done)
+ * @property {Number } clearSize 清除图标的大小,单位px(默认15)
+ * @property {String} prefixIcon 输入框头部图标
+ * @property {String} suffixIcon 输入框尾部图标
+ * @property {String} primaryColor 设置主题色(默认#2979ff)
+ * @property {Boolean} trim 是否自动去除两端的空格
+ * @property {Boolean} cursorSpacing 指定光标与键盘的距离,单位 px
+ * @value both 去除两端空格
+ * @value left 去除左侧空格
+ * @value right 去除右侧空格
+ * @value start 去除左侧空格
+ * @value end 去除右侧空格
+ * @value all 去除全部空格
+ * @value none 不去除空格
+ * @property {Boolean} inputBorder 是否显示input输入框的边框(默认true)
+ * @property {Boolean} passwordIcon type=password时是否显示小眼睛图标
+ * @property {Object} styles 自定义颜色
+ * @event {Function} input 输入框内容发生变化时触发
+ * @event {Function} focus 输入框获得焦点时触发
+ * @event {Function} blur 输入框失去焦点时触发
+ * @event {Function} confirm 点击完成按钮时触发
+ * @event {Function} iconClick 点击图标时触发
+ * @example <uni-easyinput v-model="mobile"></uni-easyinput>
+function obj2strClass(obj) {
+ let classess = '';
+ for (let key in obj) {
+ const val = obj[key];
+ if (val) {
+ classess += `${key} `;
+ return classess;
+function obj2strStyle(obj) {
+ let style = '';
+ style += `${key}:${val};`;
+ return style;
+ name: 'uni-easyinput',
+ emits: ['click', 'iconClick', 'update:modelValue', 'input', 'focus', 'blur', 'confirm', 'clear', 'eyes', 'change', 'keyboardheightchange'],
+ model: {
+ prop: 'modelValue',
+ event: 'update:modelValue'
+ form: {
+ from: 'uniForm',
+ formItem: {
+ from: 'uniFormItem',
+ name: String,
+ value: [Number, String],
+ modelValue: [Number, String],
+ default: 'text'
+ clearable: {
+ autoHeight: {
+ default: ' '
+ placeholderStyle: String,
+ focus: {
+ maxlength: {
+ default: 140
+ confirmType: {
+ default: 'done'
+ clearSize: {
+ default: 24
+ inputBorder: {
+ prefixIcon: {
+ suffixIcon: {
+ trim: {
+ cursorSpacing: {
+ passwordIcon: {
+ primaryColor: {
+ default: '#2979ff'
+ color: '#333',
+ backgroundColor: '#fff',
+ disableColor: '#F7F6F6',
+ borderColor: '#e5e5e5'
+ errorMessage: {
+ type: [String, Boolean],
+ focused: false,
+ val: '',
+ showMsg: '',
+ border: false,
+ isFirstBorder: false,
+ showClearIcon: false,
+ showPassword: false,
+ focusShow: false,
+ localMsg: '',
+ isEnter: false // 用于判断当前是否是使用回车操作
+ // 输入框内是否有值
+ isVal() {
+ const val = this.val;
+ // fixed by mehaotian 处理值为0的情况,字符串0不在处理范围
+ if (val || val === 0) {
+ return true;
+ return false;
+ msg() {
+ // console.log('computed', this.form, this.formItem);
+ // if (this.form) {
+ // return this.errorMessage || this.formItem.errMsg;
+ // TODO 处理头条 formItem 中 errMsg 不更新的问题
+ return this.localMsg || this.errorMessage;
+ // 因为uniapp的input组件的maxlength组件必须要数值,这里转为数值,用户可以传入字符串数值
+ inputMaxlength() {
+ return Number(this.maxlength);
+ // 处理外层样式的style
+ boxStyle() {
+ return `color:${this.inputBorder && this.msg ? '#e43d33' : this.styles.color};`;
+ // input 内容的类和样式处理
+ inputContentClass() {
+ return obj2strClass({
+ 'is-input-border': this.inputBorder,
+ 'is-input-error-border': this.inputBorder && this.msg,
+ 'is-textarea': this.type === 'textarea',
+ 'is-disabled': this.disabled,
+ 'is-focused': this.focusShow
+ inputContentStyle() {
+ const focusColor = this.focusShow ? this.primaryColor : this.styles.borderColor;
+ const borderColor = this.inputBorder && this.msg ? '#dd524d' : focusColor;
+ return obj2strStyle({
+ 'border-color': borderColor || '#e5e5e5',
+ 'background-color': this.disabled ? this.styles.disableColor : this.styles.backgroundColor
+ // input右侧样式
+ inputStyle() {
+ const paddingRight = this.type === 'password' || this.clearable || this.prefixIcon ? '' : '10px';
+ 'padding-right': paddingRight,
+ 'padding-left': this.prefixIcon ? '' : '10px'
+ this.val = newVal;
+ focus(newVal) {
+ this.focused = this.focus;
+ this.focusShow = this.focus;
+ this.init();
+ // TODO 处理头条vue3 computed 不监听 inject 更改的问题(formItem.errMsg)
+ if (this.form && this.formItem) {
+ this.$watch('formItem.errMsg', newVal => {
+ this.localMsg = newVal;
+ * 初始化变量值
+ init() {
+ if (this.value || this.value === 0) {
+ this.val = this.value;
+ } else if (this.modelValue || this.modelValue === 0 || this.modelValue === '') {
+ this.val = this.modelValue;
+ this.val = null;
+ * 点击图标时触发
+ * @param {Object} type
+ onClickIcon(type) {
+ this.$emit('iconClick', type);
+ * 显示隐藏内容,密码框时生效
+ onEyes() {
+ this.showPassword = !this.showPassword;
+ this.$emit('eyes', this.showPassword);
+ * 输入时触发
+ * @param {Object} event
+ onInput(event) {
+ let value = event.detail.value;
+ // 判断是否去除空格
+ if (this.trim) {
+ if (typeof this.trim === 'boolean' && this.trim) {
+ value = this.trimStr(value);
+ if (typeof this.trim === 'string') {
+ value = this.trimStr(value, this.trim);
+ if (this.errMsg) this.errMsg = '';
+ this.val = value;
+ this.$emit('input', value);
+ // TODO 兼容 vue3
+ this.$emit('update:modelValue', value);
+ * 外部调用方法
+ * 获取焦点时触发
+ this.focused = true;
+ this.$emit('focus', null);
+ _Focus(event) {
+ this.focusShow = true;
+ this.$emit('focus', event);
+ * 失去焦点时触发
+ this.focused = false;
+ _Blur(event) {
+ this.focusShow = false;
+ this.$emit('blur', event);
+ // 根据类型返回值,在event中获取的值理论上讲都是string
+ if (this.isEnter === false) {
+ this.$emit('change', this.val);
+ // 失去焦点时参与表单校验
+ const { validateTrigger } = this.form;
+ if (validateTrigger === 'blur') {
+ this.formItem.onFieldChange();
+ * 按下键盘的发送键
+ onConfirm(e) {
+ this.$emit('confirm', this.val);
+ this.isEnter = true;
+ this.isEnter = false;
+ * 清理内容
+ onClear(event) {
+ this.val = '';
+ this.$emit('input', '');
+ this.$emit('update:modelValue', '');
+ // 点击叉号触发
+ this.$emit('clear');
+ * 键盘高度发生变化的时候触发此事件
+ * 兼容性:微信小程序2.7.0+、App 3.1.0+
+ onkeyboardheightchange(event) {
+ this.$emit("keyboardheightchange",event);
+ * 去除空格
+ trimStr(str, pos = 'both') {
+ if (pos === 'both') {
+ return str.trim();
+ } else if (pos === 'left') {
+ return str.trimLeft();
+ } else if (pos === 'right') {
+ return str.trimRight();
+ } else if (pos === 'start') {
+ return str.trimStart();
+ } else if (pos === 'end') {
+ return str.trimEnd();
+ } else if (pos === 'all') {
+ return str.replace(/\s+/g, '');
+ } else if (pos === 'none') {
+$uni-error: #e43d33;
+$uni-border-1: #dcdfe6 !default;
+.uni-easyinput {
+ text-align: left;
+.uni-easyinput__content {
+ // min-height: 36px;
+ // 处理border动画刚开始显示黑色的问题
+ border-color: #fff;
+ transition-property: border-color;
+.uni-easyinput__content-input {
+.uni-easyinput__placeholder-class {
+ // font-weight: 200;
+.is-textarea {
+ align-items: flex-start;
+.is-textarea-icon {
+.uni-easyinput__content-textarea {
+ line-height: 1.5;
+ margin: 6px;
+ margin-left: 0;
+ height: 80px;
+ min-height: 80px;
+.input-padding {
+.content-clear-icon {
+.label-icon {
+ margin-top: -1px;
+// 显示边框
+.is-input-border {
+ border: 1px solid $uni-border-1;
+ /* #ifdef MP-ALIPAY */
+.uni-error-message {
+ bottom: -17px;
+.uni-error-msg--boeder {
+.is-input-error-border {
+ border-color: $uni-error;
+ .uni-easyinput__placeholder-class {
+ color: mix(#fff, $uni-error, 50%);
+.uni-easyinput--border {
+ margin-bottom: 0;
+ // padding-bottom: 0;
+.uni-easyinput-error {
+.is-first-border {
+ border-width: 0;
+.is-disabled {
+ background-color: #f7f6f6;
+ color: #d5d5d5;
+ "id": "uni-easyinput",
+ "displayName": "uni-easyinput 增强输入框",
+ "version": "1.1.9",
+ "description": "Easyinput 组件是对原生input组件的增强",
+ "input",
+ "uni-easyinput",
+ "输入框"
+### Easyinput 增强输入框
+> **组件名:uni-easyinput**
+> 代码块: `uEasyinput`
+easyinput 组件是对原生input组件的增强 ,是专门为配合表单组件[uni-forms](https://ext.dcloud.net.cn/plugin?id=2773)而设计的,easyinput 内置了边框,图标等,同时包含 input 所有功能
+### [查看文档](https://uniapp.dcloud.io/component/uniui/uni-easyinput)
@@ -0,0 +1,23 @@
+## 1.2.5(2023-03-29)
+- 新增 pattern.icon 属性,可自定义图标
+## 1.2.4(2022-09-07)
+小程序端由于 style 使用了对象导致报错,[详情](https://ask.dcloud.net.cn/question/152790?item_id=211778&rf=false)
+## 1.2.3(2022-09-05)
+- 修复 nvue 环境下,具有 tabBar 时,fab 组件下部位置无法正常获取 --window-bottom 的bug,详见:[https://ask.dcloud.net.cn/question/110638?notification_id=826310](https://ask.dcloud.net.cn/question/110638?notification_id=826310)
+## 1.2.2(2021-12-29)
+- 更新 组件依赖
+## 1.2.1(2021-11-19)
+- 修复 阴影颜色不正确的bug
+- 文档迁移,详见:[https://uniapp.dcloud.io/component/uniui/uni-fab](https://uniapp.dcloud.io/component/uniui/uni-fab)
+## 1.1.1(2021-11-09)
+## 1.0.6(2021-02-05)
+- 优化 按钮背景色调整
+- 优化 兼容pc端
@@ -0,0 +1,491 @@
+ <view class="uni-cursor-point">
+ <view v-if="popMenu && (leftBottom||rightBottom||leftTop||rightTop) && content.length > 0" :class="{
+ 'uni-fab--leftBottom': leftBottom,
+ 'uni-fab--rightBottom': rightBottom,
+ 'uni-fab--leftTop': leftTop,
+ 'uni-fab--rightTop': rightTop
+ }" class="uni-fab"
+ :style="nvueBottom"
+ 'uni-fab__content--left': horizontal === 'left',
+ 'uni-fab__content--right': horizontal === 'right',
+ 'uni-fab__content--flexDirection': direction === 'vertical',
+ 'uni-fab__content--flexDirectionStart': flexDirectionStart,
+ 'uni-fab__content--flexDirectionEnd': flexDirectionEnd,
+ 'uni-fab__content--other-platform': !isAndroidNvue
+ }" :style="{ width: boxWidth, height: boxHeight, backgroundColor: styles.backgroundColor }"
+ class="uni-fab__content" elevation="5">
+ <view v-if="flexDirectionStart || horizontalLeft" class="uni-fab__item uni-fab__item--first" />
+ <view v-for="(item, index) in content" :key="index" :class="{ 'uni-fab__item--active': isShow }"
+ class="uni-fab__item" @click="_onItemClick(index, item)">
+ <image :src="item.active ? item.selectedIconPath : item.iconPath" class="uni-fab__item-image"
+ mode="aspectFit" />
+ <text class="uni-fab__item-text"
+ :style="{ color: item.active ? styles.selectedColor : styles.color }">{{ item.text }}</text>
+ <view v-if="flexDirectionEnd || horizontalRight" class="uni-fab__item uni-fab__item--first" />
+ 'uni-fab__circle--leftBottom': leftBottom,
+ 'uni-fab__circle--rightBottom': rightBottom,
+ 'uni-fab__circle--leftTop': leftTop,
+ 'uni-fab__circle--rightTop': rightTop,
+ }" class="uni-fab__circle uni-fab__plus" :style="{ 'background-color': styles.buttonColor, 'bottom': nvueBottom }" @click="_onClick">
+ <uni-icons class="fab-circle-icon" :type="styles.icon" :color="styles.iconColor" size="32"
+ :class="{'uni-fab__plus--active': isShow && content.length > 0}"></uni-icons>
+ <!-- <view class="fab-circle-v" :class="{'uni-fab__plus--active': isShow && content.length > 0}"></view>
+ <view class="fab-circle-h" :class="{'uni-fab__plus--active': isShow && content.length > 0}"></view> -->
+ let platform = 'other'
+ platform = uni.getSystemInfoSync().platform
+ * Fab 悬浮按钮
+ * @description 点击可展开一个图形按钮菜单
+ * @tutorial https://ext.dcloud.net.cn/plugin?id=144
+ * @property {Object} pattern 可选样式配置项
+ * @property {Object} horizontal = [left | right] 水平对齐方式
+ * @value left 左对齐
+ * @value right 右对齐
+ * @property {Object} vertical = [bottom | top] 垂直对齐方式
+ * @value bottom 下对齐
+ * @value top 上对齐
+ * @property {Object} direction = [horizontal | vertical] 展开菜单显示方式
+ * @value horizontal 水平显示
+ * @value vertical 垂直显示
+ * @property {Array} content 展开菜单内容配置项
+ * @property {Boolean} popMenu 是否使用弹出菜单
+ * @event {Function} trigger 展开菜单点击事件,返回点击信息
+ * @event {Function} fabClick 悬浮按钮点击事件
+ name: 'UniFab',
+ emits: ['fabClick', 'trigger'],
+ pattern: {
+ horizontal: {
+ vertical: {
+ default: 'bottom'
+ direction: {
+ default: 'horizontal'
+ content: {
+ show: {
+ popMenu: {
+ fabShow: false,
+ isShow: false,
+ isAndroidNvue: platform === 'android',
+ color: '#3c3e49',
+ selectedColor: '#007AFF',
+ buttonColor: '#007AFF',
+ iconColor: '#fff',
+ icon: 'plusempty'
+ contentWidth(e) {
+ return (this.content.length + 1) * 55 + 15 + 'px'
+ contentWidthMin() {
+ return '55px'
+ // 动态计算宽度
+ boxWidth() {
+ return this.getPosition(3, 'horizontal')
+ // 动态计算高度
+ boxHeight() {
+ return this.getPosition(3, 'vertical')
+ // 计算左下位置
+ leftBottom() {
+ return this.getPosition(0, 'left', 'bottom')
+ // 计算右下位置
+ rightBottom() {
+ return this.getPosition(0, 'right', 'bottom')
+ // 计算左上位置
+ leftTop() {
+ return this.getPosition(0, 'left', 'top')
+ rightTop() {
+ return this.getPosition(0, 'right', 'top')
+ flexDirectionStart() {
+ return this.getPosition(1, 'vertical', 'top')
+ flexDirectionEnd() {
+ return this.getPosition(1, 'vertical', 'bottom')
+ horizontalLeft() {
+ return this.getPosition(2, 'horizontal', 'left')
+ horizontalRight() {
+ return this.getPosition(2, 'horizontal', 'right')
+ // 计算 nvue bottom
+ nvueBottom() {
+ const safeBottom = uni.getSystemInfoSync().windowBottom;
+ return 30 + safeBottom
+ return 30
+ handler(val, oldVal) {
+ this.styles = Object.assign({}, this.styles, val)
+ this.isShow = this.show
+ if (this.top === 0) {
+ this.fabShow = true
+ // 初始化样式
+ this.styles = Object.assign({}, this.styles, this.pattern)
+ _onClick() {
+ this.$emit('fabClick')
+ if (!this.popMenu) {
+ this.isShow = !this.isShow
+ this.isShow = true
+ this.isShow = false
+ * 按钮点击事件
+ _onItemClick(index, item) {
+ if (!this.isShow) {
+ this.$emit('trigger', {
+ index,
+ item
+ * 获取 位置信息
+ getPosition(types, paramA, paramB) {
+ if (types === 0) {
+ return this.horizontal === paramA && this.vertical === paramB
+ } else if (types === 1) {
+ return this.direction === paramA && this.vertical === paramB
+ } else if (types === 2) {
+ return this.direction === paramA && this.horizontal === paramB
+ return this.isShow && this.direction === paramA ? this.contentWidth : this.contentWidthMin
+ $uni-shadow-base:0 1px 5px 2px rgba($color: #000000, $alpha: 0.3) !default;
+ .uni-fab {
+ z-index: 10;
+ border-radius: 45px;
+ box-shadow: $uni-shadow-base;
+ .uni-cursor-point {
+ .uni-fab--active {
+ .uni-fab--leftBottom {
+ left: 15px;
+ bottom: 30px;
+ left: calc(15px + var(--window-left));
+ bottom: calc(30px + var(--window-bottom));
+ // padding: 10px;
+ .uni-fab--leftTop {
+ top: 30px;
+ top: calc(30px + var(--window-top));
+ .uni-fab--rightBottom {
+ right: 15px;
+ right: calc(15px + var(--window-right));
+ .uni-fab--rightTop {
+ .uni-fab__circle {
+ width: 55px;
+ height: 55px;
+ background-color: #3c3e49;
+ z-index: 11;
+ // box-shadow: $uni-shadow-base;
+ .uni-fab__circle--leftBottom {
+ .uni-fab__circle--leftTop {
+ .uni-fab__circle--rightBottom {
+ .uni-fab__circle--rightTop {
+ .uni-fab__circle--left {
+ .uni-fab__circle--right {
+ .uni-fab__circle--top {
+ .uni-fab__circle--bottom {
+ .uni-fab__plus {
+ // .fab-circle-v {
+ // position: absolute;
+ // width: 2px;
+ // height: 24px;
+ // left: 0;
+ // top: 0;
+ // right: 0;
+ // bottom: 0;
+ // /* #ifndef APP-NVUE */
+ // margin: auto;
+ // /* #endif */
+ // background-color: white;
+ // transform: rotate(0deg);
+ // transition: transform 0.3s;
+ // .fab-circle-h {
+ // width: 24px;
+ // height: 2px;
+ .fab-circle-icon {
+ transition: transform 0.3s;
+ font-weight: 200;
+ .uni-fab__plus--active {
+ .uni-fab__content {
+ border-radius: 55px;
+ transition-property: width, height;
+ transition-duration: 0.2s;
+ border-color: #DDDDDD;
+ border-width: 1rpx;
+ .uni-fab__content--other-platform {
+ border-width: 0px;
+ .uni-fab__content--left {
+ .uni-fab__content--right {
+ justify-content: flex-end;
+ .uni-fab__content--flexDirection {
+ .uni-fab__content--flexDirectionStart {
+ .uni-fab__content--flexDirectionEnd {
+ .uni-fab__item {
+ transition: opacity 0.2s;
+ .uni-fab__item--active {
+ .uni-fab__item-image {
+ margin-bottom: 4px;
+ .uni-fab__item-text {
+ color: #FFFFFF;
+ margin-top: 2px;
+ .uni-fab__item--first {
+ "id": "uni-fab",
+ "displayName": "uni-fab 悬浮按钮",
+ "version": "1.2.5",
+ "description": "悬浮按钮 fab button ,点击可展开一个图标按钮菜单。",
+ "按钮",
+ "悬浮按钮",
+ "fab"
+ "dependencies": ["uni-scss","uni-icons"],
@@ -0,0 +1,9 @@
+## Fab 悬浮按钮
+> **组件名:uni-fab**
+> 代码块: `uFab`
+点击可展开一个图形按钮菜单
+### [查看文档](https://uniapp.dcloud.io/component/uniui/uni-fab)
@@ -0,0 +1,19 @@
+## 1.2.1(2022-05-30)
+- 新增 stat 属性 ,是否开启uni统计功能
+- 文档迁移,详见:[https://uniapp.dcloud.io/component/uniui/uni-fav](https://uniapp.dcloud.io/component/uniui/uni-fav)
+## 1.1.1(2021-08-24)
+## 1.0.6(2021-05-12)
+## 1.0.5(2021-04-21)
+## 1.0.4(2021-02-05)
+## 1.0.3(2021-02-05)
+## 1.0.2(2021-02-05)
@@ -0,0 +1,4 @@
+ "uni-fav.collect": "collect",
+ "uni-fav.collected": "collected"
+ "uni-fav.collect": "收藏",
+ "uni-fav.collected": "已收藏"
@@ -0,0 +1,161 @@
+ <view :class="[circle === true || circle === 'true' ? 'uni-fav--circle' : '']" :style="[{ backgroundColor: checked ? bgColorChecked : bgColor }]"
+ @click="onClick" class="uni-fav">
+ <!-- #ifdef MP-ALIPAY -->
+ <view class="uni-fav-star" v-if="!checked && (star === true || star === 'true')">
+ <uni-icons :color="fgColor" :style="{color: checked ? fgColorChecked : fgColor}" size="14" type="star-filled" />
+ <!-- #ifndef MP-ALIPAY -->
+ <uni-icons :color="fgColor" :style="{color: checked ? fgColorChecked : fgColor}" class="uni-fav-star" size="14" type="star-filled"
+ v-if="!checked && (star === true || star === 'true')" />
+ <text :style="{color: checked ? fgColorChecked : fgColor}" class="uni-fav-text">{{ checked ? contentFav : contentDefault }}</text>
+ * Fav 收藏按钮
+ * @description 用于收藏功能,可点击切换选中、不选中的状态
+ * @tutorial https://ext.dcloud.net.cn/plugin?id=864
+ * @property {Boolean} star = [true|false] 按钮是否带星星
+ * @property {String} bgColor 未收藏时的背景色
+ * @property {String} bgColorChecked 已收藏时的背景色
+ * @property {String} fgColor 未收藏时的文字颜色
+ * @property {String} fgColorChecked 已收藏时的文字颜色
+ * @property {Boolean} circle = [true|false] 是否为圆角
+ * @property {Boolean} checked = [true|false] 是否为已收藏
+ * @property {Object} contentText = [true|false] 收藏按钮文字
+ * @property {Boolean} stat 是否开启统计功能
+ * @event {Function} click 点击 fav按钮触发事件
+ * @example <uni-fav :checked="true"/>
+ const { t } = initVueI18n(messages)
+ name: "UniFav",
+ // TODO 兼容 vue3,需要注册事件
+ star: {
+ bgColor: {
+ default: "#eeeeee"
+ fgColor: {
+ default: "#666666"
+ bgColorChecked: {
+ default: "#007aff"
+ fgColorChecked: {
+ default: "#FFFFFF"
+ circle: {
+ checked: {
+ contentDefault: "",
+ contentFav: ""
+ stat:{
+ contentDefault() {
+ return this.contentText.contentDefault || t("uni-fav.collect")
+ contentFav() {
+ return this.contentText.contentFav || t("uni-fav.collected")
+ checked() {
+ if (uni.report && this.stat) {
+ if (this.checked) {
+ uni.report("收藏", "收藏");
+ uni.report("取消收藏", "取消收藏");
+ this.$emit("click");
+ $fav-height: 25px;
+ .uni-fav {
+ width: 60px;
+ height: $fav-height;
+ line-height: $fav-height;
+ .uni-fav--circle {
+ border-radius: 30px;
+ .uni-fav-star {
+ line-height: 24px;
+ .uni-fav-text {
+ "id": "uni-fav",
+ "displayName": "uni-fav 收藏按钮",
+ "description": " Fav 收藏组件,可自定义颜色、大小。",
+ "fav",
+ "收藏"
+## Fav 收藏按钮
+> **组件名:uni-fav**
+> 代码块: `uFav`
+用于收藏功能,可点击切换选中、不选中的状态。
+### [查看文档](https://uniapp.dcloud.io/component/uniui/uni-fav)
@@ -0,0 +1,67 @@
+## 1.0.4(2023-03-29)
+- 修复 手动上传删除一个文件后不能再上传的bug
+## 1.0.3(2022-12-19)
+- 新增 sourceType 属性, 可以自定义图片和视频选择的来源
+## 1.0.2(2022-07-04)
+- 修复 在uni-forms下样式不生效的bug
+- 修复 参数为对象的情况下,url在某些情况显示错误的bug
+- 文档迁移,详见:[https://uniapp.dcloud.io/component/uniui/uni-file-picker](https://uniapp.dcloud.io/component/uniui/uni-file-picker)
+## 0.2.16(2021-11-08)
+- 修复 传入空对象 ,显示错误的Bug
+## 0.2.15(2021-08-30)
+- 修复 return-type="object" 时且存在v-model时,无法删除文件的Bug
+## 0.2.14(2021-08-23)
+- 新增 参数中返回 fileID 字段
+## 0.2.13(2021-08-23)
+- 修复 腾讯云传入fileID 不能回显的bug
+- 修复 选择图片后,不能放大的问题
+## 0.2.12(2021-08-17)
+- 修复 由于 0.2.11 版本引起的不能回显图片的Bug
+## 0.2.11(2021-08-16)
+- 新增 clearFiles(index) 方法,可以手动删除指定文件
+- 修复 v-model 值设为 null 报错的Bug
+## 0.2.10(2021-08-13)
+- 修复 return-type="object" 时,无法删除文件的Bug
+## 0.2.9(2021-08-03)
+- 修复 auto-upload 属性失效的Bug
+## 0.2.8(2021-07-31)
+- 修复 fileExtname属性不指定值报错的Bug
+## 0.2.7(2021-07-31)
+- 修复 在某种场景下图片不回显的Bug
+## 0.2.6(2021-07-30)
+- 修复 return-type为object下,返回值不正确的Bug
+## 0.2.5(2021-07-30)
+- 修复(重要) H5 平台下如果和uni-forms组件一同使用导致页面卡死的问题
+## 0.2.3(2021-07-28)
+- 优化 调整示例代码
+## 0.2.2(2021-07-27)
+- 修复 vue3 下赋值错误的Bug
+- 优化 h5平台下上传文件导致页面卡死的问题
+## 0.1.1(2021-07-02)
+- 修复 sourceType 缺少默认值导致 ios 无法选择文件
+## 0.1.0(2021-06-30)
+- 优化 解耦与uniCloud的强绑定关系 ,如不绑定服务空间,默认autoUpload为false且不可更改
+## 0.0.11(2021-06-30)
+- 修复 由 0.0.10 版本引发的 returnType 属性失效的问题
+## 0.0.10(2021-06-29)
+- 优化 文件上传后进度条消失时机
+## 0.0.9(2021-06-29)
+- 修复 在uni-forms 中,删除文件 ,获取的值不对的Bug
+## 0.0.8(2021-06-15)
+- 修复 删除文件时无法触发 v-model 的Bug
+## 0.0.7(2021-05-12)
+## 0.0.6(2021-04-09)
+- 修复 选择的文件非 file-extname 字段指定的扩展名报错的Bug
+## 0.0.5(2021-04-09)
+- 优化 更新组件示例
+## 0.0.4(2021-04-09)
+- 优化 file-extname 字段支持字符串写法,多个扩展名需要用逗号分隔
+## 0.0.3(2021-02-05)
+- 修复 微信小程序不指定 fileExtname 属性选择失败的Bug
@@ -0,0 +1,224 @@
+'use strict';
+const ERR_MSG_OK = 'chooseAndUploadFile:ok';
+const ERR_MSG_FAIL = 'chooseAndUploadFile:fail';
+function chooseImage(opts) {
+ count,
+ sizeType = ['original', 'compressed'],
+ sourceType,
+ extension
+ } = opts
+ return new Promise((resolve, reject) => {
+ uni.chooseImage({
+ sizeType,
+ extension,
+ success(res) {
+ resolve(normalizeChooseAndUploadFileRes(res, 'image'));
+ fail(res) {
+ reject({
+ errMsg: res.errMsg.replace('chooseImage:fail', ERR_MSG_FAIL),
+function chooseVideo(opts) {
+ camera,
+ compressed,
+ maxDuration,
+ } = opts;
+ uni.chooseVideo({
+ tempFilePath,
+ duration,
+ height,
+ width
+ } = res;
+ resolve(normalizeChooseAndUploadFileRes({
+ errMsg: 'chooseVideo:ok',
+ tempFilePaths: [tempFilePath],
+ tempFiles: [
+ name: (res.tempFile && res.tempFile.name) || '',
+ path: tempFilePath,
+ type: (res.tempFile && res.tempFile.type) || '',
+ width,
+ fileType: 'video',
+ cloudPath: '',
+ }, ],
+ }, 'video'));
+ errMsg: res.errMsg.replace('chooseVideo:fail', ERR_MSG_FAIL),
+function chooseAll(opts) {
+ let chooseFile = uni.chooseFile;
+ if (typeof wx !== 'undefined' &&
+ typeof wx.chooseMessageFile === 'function') {
+ chooseFile = wx.chooseMessageFile;
+ if (typeof chooseFile !== 'function') {
+ return reject({
+ errMsg: ERR_MSG_FAIL + ' 请指定 type 类型,该平台仅支持选择 image 或 video。',
+ chooseFile({
+ type: 'all',
+ resolve(normalizeChooseAndUploadFileRes(res));
+ errMsg: res.errMsg.replace('chooseFile:fail', ERR_MSG_FAIL),
+function normalizeChooseAndUploadFileRes(res, fileType) {
+ res.tempFiles.forEach((item, index) => {
+ if (!item.name) {
+ item.name = item.path.substring(item.path.lastIndexOf('/') + 1);
+ if (fileType) {
+ item.fileType = fileType;
+ item.cloudPath =
+ Date.now() + '_' + index + item.name.substring(item.name.lastIndexOf('.'));
+ if (!res.tempFilePaths) {
+ res.tempFilePaths = res.tempFiles.map((file) => file.path);
+ return res;
+function uploadCloudFiles(files, max = 5, onUploadProgress) {
+ files = JSON.parse(JSON.stringify(files))
+ const len = files.length
+ let count = 0
+ let self = this
+ return new Promise(resolve => {
+ while (count < max) {
+ next()
+ function next() {
+ let cur = count++
+ if (cur >= len) {
+ !files.find(item => !item.url && !item.errMsg) && resolve(files)
+ const fileItem = files[cur]
+ const index = self.files.findIndex(v => v.uuid === fileItem.uuid)
+ fileItem.url = ''
+ delete fileItem.errMsg
+ uniCloud
+ .uploadFile({
+ filePath: fileItem.path,
+ cloudPath: fileItem.cloudPath,
+ fileType: fileItem.fileType,
+ onUploadProgress: res => {
+ res.index = index
+ onUploadProgress && onUploadProgress(res)
+ .then(res => {
+ fileItem.url = res.fileID
+ fileItem.index = index
+ if (cur < len) {
+ .catch(res => {
+ fileItem.errMsg = res.errMsg || res.message
+function uploadFiles(choosePromise, {
+ onChooseFile,
+ onUploadProgress
+ return choosePromise
+ .then((res) => {
+ if (onChooseFile) {
+ const customChooseRes = onChooseFile(res);
+ if (typeof customChooseRes !== 'undefined') {
+ return Promise.resolve(customChooseRes).then((chooseRes) => typeof chooseRes === 'undefined' ?
+ res : chooseRes);
+ if (res === false) {
+ errMsg: ERR_MSG_OK,
+ tempFilePaths: [],
+ tempFiles: [],
+ return res
+function chooseAndUploadFile(opts = {
+ type: 'all'
+ if (opts.type === 'image') {
+ return uploadFiles(chooseImage(opts), opts);
+ else if (opts.type === 'video') {
+ return uploadFiles(chooseVideo(opts), opts);
+ return uploadFiles(chooseAll(opts), opts);
+export {
+ chooseAndUploadFile,
+ uploadCloudFiles
@@ -0,0 +1,667 @@
+ <view class="uni-file-picker">
+ <view v-if="title" class="uni-file-picker__header">
+ <text class="file-title">{{ title }}</text>
+ <text class="file-count">{{ filesList.length }}/{{ limitLength }}</text>
+ <upload-image v-if="fileMediatype === 'image' && showType === 'grid'" :readonly="readonly"
+ :image-styles="imageStyles" :files-list="filesList" :limit="limitLength" :disablePreview="disablePreview"
+ :delIcon="delIcon" @uploadFiles="uploadFiles" @choose="choose" @delFile="delFile">
+ <view class="is-add">
+ <view class="icon-add"></view>
+ <view class="icon-add rotate"></view>
+ </upload-image>
+ <upload-file v-if="fileMediatype !== 'image' || showType !== 'grid'" :readonly="readonly"
+ :list-styles="listStyles" :files-list="filesList" :showType="showType" :delIcon="delIcon"
+ @uploadFiles="uploadFiles" @choose="choose" @delFile="delFile">
+ <slot><button type="primary" size="mini">选择文件</button></slot>
+ </upload-file>
+ } from './choose-and-upload-file.js'
+ get_file_ext,
+ get_extname,
+ get_files_and_is_max,
+ get_file_info,
+ get_file_data
+ } from './utils.js'
+ import uploadImage from './upload-image.vue'
+ import uploadFile from './upload-file.vue'
+ let fileInput = null
+ * FilePicker 文件选择上传
+ * @description 文件选择上传组件,可以选择图片、视频等任意文件并上传到当前绑定的服务空间
+ * @tutorial https://ext.dcloud.net.cn/plugin?id=4079
+ * @property {Object|Array} value 组件数据,通常用来回显 ,类型由return-type属性决定
+ * @property {Boolean} disabled = [true|false] 组件禁用
+ * @value true 禁用
+ * @value false 取消禁用
+ * @property {Boolean} readonly = [true|false] 组件只读,不可选择,不显示进度,不显示删除按钮
+ * @value true 只读
+ * @value false 取消只读
+ * @property {String} return-type = [array|object] 限制 value 格式,当为 object 时 ,组件只能单选,且会覆盖
+ * @value array 规定 value 属性的类型为数组
+ * @value object 规定 value 属性的类型为对象
+ * @property {Boolean} disable-preview = [true|false] 禁用图片预览,仅 mode:grid 时生效
+ * @value true 禁用图片预览
+ * @value false 取消禁用图片预览
+ * @property {Boolean} del-icon = [true|false] 是否显示删除按钮
+ * @value true 显示删除按钮
+ * @value false 不显示删除按钮
+ * @property {Boolean} auto-upload = [true|false] 是否自动上传,值为true则只触发@select,可自行上传
+ * @value true 自动上传
+ * @value false 取消自动上传
+ * @property {Number|String} limit 最大选择个数 ,h5 会自动忽略多选的部分
+ * @property {String} title 组件标题,右侧显示上传计数
+ * @property {String} mode = [list|grid] 选择文件后的文件列表样式
+ * @value list 列表显示
+ * @value grid 宫格显示
+ * @property {String} file-mediatype = [image|video|all] 选择文件类型
+ * @value image 只选择图片
+ * @value video 只选择视频
+ * @value all 选择所有文件
+ * @property {Array} file-extname 选择文件后缀,根据 file-mediatype 属性而不同
+ * @property {Object} list-style mode:list 时的样式
+ * @property {Object} image-styles 选择文件后缀,根据 file-mediatype 属性而不同
+ * @event {Function} select 选择文件后触发
+ * @event {Function} progress 文件上传时触发
+ * @event {Function} success 上传成功触发
+ * @event {Function} fail 上传失败触发
+ * @event {Function} delete 文件从列表移除时触发
+ name: 'uniFilePicker',
+ uploadImage,
+ uploadFile
+ emits: ['select', 'success', 'fail', 'progress', 'delete', 'update:modelValue', 'input'],
+ disablePreview: {
+ delIcon: {
+ // 自动上传
+ autoUpload: {
+ // 最大选择个数 ,h5只能限制单选或是多选
+ limit: {
+ default: 9
+ // 列表样式 grid | list | list-card
+ default: 'grid'
+ // 选择文件类型 image/video/all
+ fileMediatype: {
+ default: 'image'
+ // 文件类型筛选
+ fileExtname: {
+ type: [Array, String],
+ listStyles: {
+ // 是否显示边框
+ border: true,
+ // 是否显示分隔线
+ dividline: true,
+ // 线条样式
+ borderStyle: {}
+ imageStyles: {
+ width: 'auto',
+ height: 'auto'
+ default: 'array'
+ sizeType: {
+ return ['original', 'compressed']
+ sourceType: {
+ return ['album', 'camera']
+ files: [],
+ localValue: []
+ this.setValue(newVal, oldVal)
+ filesList() {
+ let files = []
+ this.files.forEach(v => {
+ files.push(v)
+ return files
+ showType() {
+ if (this.fileMediatype === 'image') {
+ return this.mode
+ return 'list'
+ limitLength() {
+ if (this.returnType === 'object') {
+ if (!this.limit) {
+ if (this.limit >= 9) {
+ return 9
+ return this.limit
+ // TODO 兼容不开通服务空间的情况
+ if (!(uniCloud.config && uniCloud.config.provider)) {
+ this.noSpace = true
+ uniCloud.chooseAndUploadFile = chooseAndUploadFile
+ this.form = this.getForm('uniForms')
+ this.formItem = this.getForm('uniFormsItem')
+ if (this.formItem.name) {
+ this.rename = this.formItem.name
+ this.form.inputChildrens.push(this)
+ * 公开用户使用,清空文件
+ clearFiles(index) {
+ if (index !== 0 && !index) {
+ this.files = []
+ this.setEmit()
+ this.files.splice(index, 1)
+ * 公开用户使用,继续上传
+ upload() {
+ this.files.forEach((v, index) => {
+ if (v.status === 'ready' || v.status === 'error') {
+ files.push(Object.assign({}, v))
+ return this.uploadFiles(files)
+ async setValue(newVal, oldVal) {
+ const newData = async (v) => {
+ const reg = /cloud:\/\/([\w.]+\/?)\S*/
+ let url = ''
+ if(v.fileID){
+ url = v.fileID
+ url = v.url
+ if (reg.test(url)) {
+ v.fileID = url
+ v.url = await this.getTempFileURL(url)
+ if(v.url) v.path = v.url
+ return v
+ await newData(newVal)
+ newVal = {}
+ if (!newVal) newVal = []
+ for(let i =0 ;i < newVal.length ;i++){
+ let v = newVal[i]
+ await newData(v)
+ this.localValue = newVal
+ if (this.form && this.formItem &&!this.is_reset) {
+ this.is_reset = false
+ this.formItem.setValue(this.localValue)
+ let filesData = Object.keys(newVal).length > 0 ? newVal : [];
+ this.files = [].concat(filesData)
+ * 选择文件
+ choose() {
+ if (this.files.length >= Number(this.limitLength) && this.showType !== 'grid' && this.returnType ===
+ 'array') {
+ uni.showToast({
+ title: `您最多选择 ${this.limitLength} 个文件`,
+ icon: 'none'
+ this.chooseFiles()
+ * 选择文件并上传
+ chooseFiles() {
+ const _extname = get_extname(this.fileExtname)
+ // 获取后缀
+ .chooseAndUploadFile({
+ type: this.fileMediatype,
+ compressed: false,
+ sizeType: this.sizeType,
+ sourceType: this.sourceType,
+ // TODO 如果为空,video 有问题
+ extension: _extname.length > 0 ? _extname : undefined,
+ count: this.limitLength - this.files.length, //默认9
+ onChooseFile: this.chooseFileCallback,
+ onUploadProgress: progressEvent => {
+ this.setProgress(progressEvent, progressEvent.index)
+ .then(result => {
+ this.setSuccessAndError(result.tempFiles)
+ .catch(err => {
+ console.log('选择失败', err)
+ * 选择文件回调
+ * @param {Object} res
+ async chooseFileCallback(res) {
+ const is_one = (Number(this.limitLength) === 1 &&
+ this.disablePreview &&
+ !this.disabled) ||
+ this.returnType === 'object'
+ // 如果这有一个文件 ,需要清空本地缓存数据
+ if (is_one) {
+ filePaths,
+ files
+ } = get_files_and_is_max(res, _extname)
+ if (!(_extname && _extname.length > 0)) {
+ filePaths = res.tempFilePaths
+ files = res.tempFiles
+ let currentData = []
+ for (let i = 0; i < files.length; i++) {
+ if (this.limitLength - this.files.length <= 0) break
+ files[i].uuid = Date.now()
+ let filedata = await get_file_data(files[i], this.fileMediatype)
+ filedata.progress = 0
+ filedata.status = 'ready'
+ this.files.push(filedata)
+ currentData.push({
+ ...filedata,
+ file: files[i]
+ this.$emit('select', {
+ tempFiles: currentData,
+ tempFilePaths: filePaths
+ res.tempFiles = files
+ // 停止自动上传
+ if (!this.autoUpload || this.noSpace) {
+ res.tempFiles = []
+ * 批传
+ uploadFiles(files) {
+ files = [].concat(files)
+ return uploadCloudFiles.call(this, files, 5, res => {
+ this.setProgress(res, res.index, true)
+ this.setSuccessAndError(result)
+ return result;
+ console.log(err)
+ * 成功或失败
+ async setSuccessAndError(res, fn) {
+ let successData = []
+ let errorData = []
+ let tempFilePath = []
+ let errorTempFilePath = []
+ for (let i = 0; i < res.length; i++) {
+ const item = res[i]
+ const index = item.uuid ? this.files.findIndex(p => p.uuid === item.uuid) : item.index
+ if (index === -1 || !this.files) break
+ if (item.errMsg === 'request:fail') {
+ this.files[index].url = item.path
+ this.files[index].status = 'error'
+ this.files[index].errMsg = item.errMsg
+ // this.files[index].progress = -1
+ errorData.push(this.files[index])
+ errorTempFilePath.push(this.files[index].url)
+ this.files[index].errMsg = ''
+ this.files[index].fileID = item.url
+ if (reg.test(item.url)) {
+ this.files[index].url = await this.getTempFileURL(item.url)
+ this.files[index].url = item.url
+ this.files[index].status = 'success'
+ this.files[index].progress += 1
+ successData.push(this.files[index])
+ tempFilePath.push(this.files[index].fileID)
+ if (successData.length > 0) {
+ // 状态改变返回
+ this.$emit('success', {
+ tempFiles: this.backObject(successData),
+ tempFilePaths: tempFilePath
+ if (errorData.length > 0) {
+ this.$emit('fail', {
+ tempFiles: this.backObject(errorData),
+ tempFilePaths: errorTempFilePath
+ * 获取进度
+ * @param {Object} progressEvent
+ setProgress(progressEvent, index, type) {
+ const fileLenth = this.files.length
+ const percentNum = (index / fileLenth) * 100
+ const percentCompleted = Math.round((progressEvent.loaded * 100) / progressEvent.total)
+ let idx = index
+ if (!type) {
+ idx = this.files.findIndex(p => p.uuid === progressEvent.tempFile.uuid)
+ if (idx === -1 || !this.files[idx]) return
+ // fix by mehaotian 100 就会消失,-1 是为了让进度条消失
+ this.files[idx].progress = percentCompleted - 1
+ // 上传中
+ this.$emit('progress', {
+ index: idx,
+ progress: parseInt(percentCompleted),
+ tempFile: this.files[idx]
+ * 删除文件
+ delFile(index) {
+ this.$emit('delete', {
+ tempFile: this.files[index],
+ tempFilePath: this.files[index].url
+ * 获取文件名和后缀
+ getFileExt(name) {
+ const last_len = name.lastIndexOf('.')
+ const len = name.length
+ name: name.substring(0, last_len),
+ ext: name.substring(last_len + 1, len)
+ * 处理返回事件
+ setEmit() {
+ let data = []
+ data = this.backObject(this.files)[0]
+ this.localValue = data?data:null
+ data = this.backObject(this.files)
+ if (!this.localValue) {
+ this.localValue = []
+ this.localValue = [...data]
+ this.$emit('update:modelValue', this.localValue)
+ this.$emit('input', this.localValue)
+ * 处理返回参数
+ * @param {Object} files
+ backObject(files) {
+ let newFilesData = []
+ files.forEach(v => {
+ newFilesData.push({
+ extname: v.extname,
+ fileType: v.fileType,
+ image: v.image,
+ name: v.name,
+ path: v.path,
+ size: v.size,
+ fileID:v.fileID,
+ url: v.url,
+ // 修改删除一个文件后不能再上传的bug, #694
+ uuid: v.uuid,
+ status: v.status,
+ cloudPath: v.cloudPath
+ return newFilesData
+ async getTempFileURL(fileList) {
+ fileList = {
+ fileList: [].concat(fileList)
+ const urls = await uniCloud.getTempFileURL(fileList)
+ return urls.fileList[0].tempFileURL || ''
+ .uni-file-picker {
+ .uni-file-picker__header {
+ padding-top: 5px;
+ padding-bottom: 10px;
+ .file-title {
+ .file-count {
+ .is-add {
+ .icon-add {
+ height: 5px;
+ .rotate {
+ transform: rotate(90deg);
@@ -0,0 +1,325 @@
+ <view class="uni-file-picker__files">
+ <view v-if="!readonly" class="files-button" @click="choose">
+ <!-- :class="{'is-text-box':showType === 'list'}" -->
+ <view v-if="list.length > 0" class="uni-file-picker__lists is-text-box" :style="borderStyle">
+ <!-- ,'is-list-card':showType === 'list-card' -->
+ <view class="uni-file-picker__lists-box" v-for="(item ,index) in list" :key="index" :class="{
+ 'files-border':index !== 0 && styles.dividline}"
+ :style="index !== 0 && styles.dividline &&borderLineStyle">
+ <view class="uni-file-picker__item">
+ <!-- :class="{'is-text-image':showType === 'list'}" -->
+ <!-- <view class="files__image is-text-image">
+ <image class="header-image" :src="item.logo" mode="aspectFit"></image>
+ </view> -->
+ <view class="files__name">{{item.name}}</view>
+ <view v-if="delIcon&&!readonly" class="icon-del-box icon-files" @click="delFile(index)">
+ <view class="icon-del icon-files"></view>
+ <view class="icon-del rotate"></view>
+ <view v-if="(item.progress && item.progress !== 100) ||item.progress===0 " class="file-picker__progress">
+ <progress class="file-picker__progress-item" :percent="item.progress === -1?0:item.progress" stroke-width="4"
+ :backgroundColor="item.errMsg?'#ff5a5f':'#EBEBEB'" />
+ <view v-if="item.status === 'error'" class="file-picker__mask" @click.stop="uploadFiles(item,index)">
+ 点击重试
+ name: "uploadFile",
+ emits:['uploadFiles','choose','delFile'],
+ filesList: {
+ showType: {
+ readonly:{
+ type:Boolean,
+ default:false
+ list() {
+ this.filesList.forEach(v => {
+ styles() {
+ let styles = {
+ 'border-style': {}
+ return Object.assign(styles, this.listStyles)
+ borderStyle() {
+ borderStyle,
+ border
+ } = this.styles
+ let obj = {}
+ if (!border) {
+ obj.border = 'none'
+ let width = (borderStyle && borderStyle.width) || 1
+ width = this.value2px(width)
+ let radius = (borderStyle && borderStyle.radius) || 5
+ radius = this.value2px(radius)
+ obj = {
+ 'border-width': width,
+ 'border-style': (borderStyle && borderStyle.style) || 'solid',
+ 'border-color': (borderStyle && borderStyle.color) || '#eee',
+ 'border-radius': radius
+ for (let i in obj) {
+ classles += `${i}:${obj[i]};`
+ borderLineStyle() {
+ borderStyle
+ if (borderStyle && borderStyle.color) {
+ obj['border-color'] = borderStyle.color
+ if (borderStyle && borderStyle.width) {
+ let width = borderStyle && borderStyle.width || 1
+ let style = borderStyle && borderStyle.style || 0
+ if (typeof width === 'number') {
+ width += 'px'
+ width = width.indexOf('px') ? width : width + 'px'
+ obj['border-width'] = width
+ if (typeof style === 'number') {
+ style += 'px'
+ style = style.indexOf('px') ? style : style + 'px'
+ obj['border-top-style'] = style
+ uploadFiles(item, index) {
+ this.$emit("uploadFiles", {
+ item,
+ index
+ this.$emit("choose")
+ this.$emit('delFile', index)
+ value2px(value) {
+ if (typeof value === 'number') {
+ value += 'px'
+ value = value.indexOf('px') !== -1 ? value : value + 'px'
+ .uni-file-picker__files {
+ .files-button {
+ // border: 1px red solid;
+ .uni-file-picker__lists {
+ .file-picker__mask {
+ .uni-file-picker__lists-box {
+ .uni-file-picker__item {
+ padding: 8px 10px;
+ .files-border {
+ .files__name {
+ word-break: break-all;
+ word-wrap: break-word;
+ .icon-files {
+ position: static;
+ background-color: initial;
+ // .icon-files .icon-del {
+ // background-color: #333;
+ // width: 12px;
+ // height: 1px;
+ .is-list-card {
+ box-shadow: 0 0 2px 0px rgba(0, 0, 0, 0.1);
+ padding: 5px;
+ .files__image {
+ .header-image {
+ .is-text-box {
+ .is-text-image {
+ width: 25px;
+ .icon-del-box {
+ height: 26px;
+ width: 26px;
+ // border-radius: 50%;
+ // background-color: rgba(0, 0, 0, 0.5);
+ .icon-del {
+ width: 15px;
+ height: 1px;
+ background-color: #333;
+ // border-radius: 1px;
+ max-width: 375px;
@@ -0,0 +1,292 @@
+ <view class="uni-file-picker__container">
+ <view class="file-picker__box" v-for="(item,index) in filesList" :key="index" :style="boxStyle">
+ <view class="file-picker__box-content" :style="borderStyle">
+ <image class="file-image" :src="item.url" mode="aspectFill" @click.stop="prviewImage(item,index)"></image>
+ <view v-if="delIcon && !readonly" class="icon-del-box" @click.stop="delFile(index)">
+ <view class="icon-del"></view>
+ <view v-if="item.errMsg" class="file-picker__mask" @click.stop="uploadFiles(item,index)">
+ <view v-if="filesList.length < limit && !readonly" class="file-picker__box" :style="boxStyle">
+ <view class="file-picker__box-content is-add" :style="borderStyle" @click="choose">
+ name: "uploadImage",
+ height: 'auto',
+ border: {}
+ return Object.assign(styles, this.imageStyles)
+ width = 'auto',
+ height = 'auto'
+ if (height === 'auto') {
+ if (width !== 'auto') {
+ obj.height = this.value2px(width)
+ obj['padding-top'] = 0
+ obj.height = 0
+ obj.height = this.value2px(height)
+ if (width === 'auto') {
+ if (height !== 'auto') {
+ obj.width = this.value2px(height)
+ obj.width = '33.3%'
+ obj.width = this.value2px(width)
+ for(let i in obj){
+ classles+= `${i}:${obj[i]};`
+ const widthDefaultValue = 1
+ const radiusDefaultValue = 3
+ if (typeof border === 'boolean') {
+ obj.border = border ? '1px #eee solid' : 'none'
+ let width = (border && border.width) || widthDefaultValue
+ let radius = (border && border.radius) || radiusDefaultValue
+ 'border-style': (border && border.style) || 'solid',
+ 'border-color': (border && border.color) || '#eee',
+ this.$emit("uploadFiles", item)
+ prviewImage(img, index) {
+ let urls = []
+ if(Number(this.limit) === 1&&this.disablePreview&&!this.disabled){
+ if(this.disablePreview) return
+ this.filesList.forEach(i => {
+ urls.push(i.url)
+ uni.previewImage({
+ urls: urls,
+ current: index
+ if (value.indexOf('%') === -1) {
+ .uni-file-picker__container {
+ margin: -5px;
+ .file-picker__box {
+ // flex: 0 0 33.3%;
+ width: 33.3%;
+ padding-top: 33.33%;
+ .file-picker__box-content {
+ margin: 5px;
+ .file-picker__progress {
+ /* border: 1px red solid; */
+ .file-picker__progress-item {
+ .file-image {
+ top: 3px;
+ right: 3px;
+ background-color: rgba(0, 0, 0, 0.5);