This commit is contained in:
2025-08-12 15:04:01 +08:00
parent df3f5f5269
commit 6708fb8eeb
544 changed files with 75169 additions and 17 deletions
@@ -0,0 +1,486 @@
<template>
<view class="u-calendar">
<uHeader
:title="title"
:subtitle="subtitle"
:showSubtitle="showSubtitle"
:showTitle="showTitle"
:weekdays="weekdays"
></uHeader>
<scroll-view
:style="{
height: $u.addUnit(listHeight),
}"
enable-flex
scroll-y
@scroll="onScroll"
:scroll-top="scrollTop"
:scrollIntoView="scrollIntoView"
>
<uMonth
:shape="shape"
:color="color"
:rowHeight="rowHeight"
:showMark="showMark"
:months="months"
:mode="mode"
:maxCount="maxCount"
:startText="startText"
:endText="endText"
:defaultDate="defaultDate"
:minDate="innerMinDate"
:maxDate="innerMaxDate"
:maxMonth="monthNum"
:readonly="readonly"
:maxRange="maxRange"
:rangePrompt="rangePrompt"
:showRangePrompt="showRangePrompt"
:allowSameDay="allowSameDay"
ref="month"
@monthSelected="monthSelected"
@updateMonthTop="updateMonthTop"
></uMonth>
</scroll-view>
</view>
</template>
<script>
import uHeader from './header.vue';
import uMonth from './month.vue';
import util from './util.js';
import dayjs from '../../libs/util/dayjs.js';
import Calendar from '../../libs/util/calendar.js';
import mixin from '../../libs/mixin/mixin';
/**
* Calendar 日历
* @property {String} title 标题内容 (默认 日期选择 )
* @property {Boolean} showTitle 是否显示标题 (默认 true )
* @property {Boolean} showSubtitle 是否显示副标题 (默认 true )
* @property {String} mode 日期类型选择 single-选择单个日期,multiple-可以选择多个日期,range-选择日期范围 ( 默认 'single' )
* @property {String} startText mode=range时,第一个日期底部的提示文字 (默认 '开始' )
* @property {String} endText mode=range时,最后一个日期底部的提示文字 (默认 '结束' )
* @property {Array} customList 自定义列表
* @property {String} color 主题色,对底部按钮和选中日期有效 (默认 ‘#3c9cff' )
* @property {String | Number} minDate 最小的可选日期 (默认 0 )
* @property {String | Number} maxDate 最大可选日期 (默认 0 )
* @property {Array | String| Date} defaultDate 默认选中的日期,mode为multiple或range是必须为数组格式
* @property {String | Number} maxCount mode=multiple时,最多可选多少个日期 (默认 Number.MAX_SAFE_INTEGER )
* @property {String | Number} rowHeight 日期行高 (默认 56 )
* @property {Function} formatter 日期格式化函数
* @property {Boolean} showLunar 是否显示农历 (默认 false )
* @property {Boolean} showMark 是否显示月份背景色 (默认 true )
* @property {Boolean} show 是否显示日历弹窗 (默认 false )
* @property {Boolean} closeOnClickOverlay 是否允许点击遮罩关闭日历 (默认 false )
* @property {Boolean} readonly 是否为只读状态,只读状态下禁止选择日期 (默认 false )
* @property {String | Number} maxRange 日期区间最多可选天数,默认无限制,mode = range时有效
* @property {String} rangePrompt 范围选择超过最多可选天数时的提示文案,mode = range时有效
* @property {Boolean} showRangePrompt 范围选择超过最多可选天数时,是否展示提示文案,mode = range时有效 (默认 true )
* @property {Boolean} allowSameDay 是否允许日期范围的起止时间为同一天,mode = range时有效 (默认 false )
* @property {Number|String} monthNum 最多展示的月份数量 (默认 3 )
*
* @event {Function()} confirm 点击确定按钮时触发 选择日期相关的返回参数
* @event {Function()} close 日历关闭时触发 可定义页面关闭时的回调事件
* @example <u-calendar :defaultDate="defaultDateMultiple" :show="show" mode="multiple" @confirm="confirm">
</u-calendar>
* */
export default {
name: 'u-calendar-view',
mixins: [mixin],
props: {
// 日历顶部标题
title: {
type: String,
default: '',
},
// 是否显示标题
showTitle: {
type: Boolean,
default: true,
},
// 是否显示副标题
showSubtitle: {
type: Boolean,
default: true,
},
// 日期类型选择,single-选择单个日期,multiple-可以选择多个日期,range-选择日期范围
mode: {
type: String,
default: 'single',
},
// 选中的日期的形状,circle(圆形),square(带圆角) (默认 'square' )
shape: {
type: String,
default: 'square',
},
// mode=range时,第一个日期底部的提示文字
startText: {
type: String,
default: '开始',
},
// mode=range时,最后一个日期底部的提示文字
endText: {
type: String,
default: '结束',
},
// 自定义列表
customList: {
type: Array,
default: () => [],
},
// 主题色,对底部按钮和选中日期有效
color: {
type: String,
default: '#3c9cff',
},
// 最小的可选日期
minDate: {
type: [String, Number],
default: 0,
},
// 最大可选日期
maxDate: {
type: [String, Number],
default: 0,
},
// 默认选中的日期,mode为multiple或range是必须为数组格式
defaultDate: {
type: [Array, String, Date, null],
default: null,
},
// mode=multiple时,最多可选多少个日期
maxCount: {
type: [String, Number],
default: Number.MAX_SAFE_INTEGER,
},
// 日期行高
rowHeight: {
type: [String, Number],
default: 56,
},
// 日期格式化函数
formatter: {
type: [Function, null],
default: null,
},
// 是否显示农历
showLunar: {
type: Boolean,
default: false,
},
// 是否显示月份背景色
showMark: {
type: Boolean,
default: true,
},
// 是否为只读状态,只读状态下禁止选择日期
readonly: {
type: Boolean,
default: false,
},
// 日期区间最多可选天数,默认无限制,mode = range时有效
maxRange: {
type: [Number, String],
default: 0,
},
// 范围选择超过最多可选天数时的提示文案,mode = range时有效
rangePrompt: {
type: String,
default: '',
},
// 范围选择超过最多可选天数时,是否展示提示文案,mode = range时有效
showRangePrompt: {
type: Boolean,
default: true,
},
// 是否允许日期范围的起止时间为同一天,mode = range时有效
allowSameDay: {
type: Boolean,
default: false,
},
// 最多展示月份数量
monthNum: {
type: [Number, String],
default: 3,
},
// 禁止选择的日期
disabledDate: {
type: [Array, String, null],
default: null,
},
// 禁止选择的日期函数
disabledFun: {
type: [Function, null],
default: null,
},
// 星期几
weekdays: {
type: String,
default: '',
},
},
components: {
uHeader,
uMonth,
},
data() {
return {
subtitle: '',
// 需要显示的月份的数组
months: [],
// 在月份滚动区域中,当前视图中月份的index索引
monthIndex: 0,
// 月份滚动区域的高度
listHeight: 0,
scrollIntoView: '',
scrollTop: 0,
// 过滤处理方法
innerFormatter: (value) => value,
};
},
watch: {
selectedChange: {
immediate: true,
handler(n) {
this.setMonth();
},
},
//修复vue2微信小程序报警告
monthIndex: {
immediate: true,
handler(newVal,oldVal) {
this.subtitle = `${this.months[newVal].year}年${this.months[newVal].month}月`;
}
},
},
computed: {
// 由于maxDate和minDate可以为字符串(2021-10-10),或者数值(时间戳),但是dayjs如果接受字符串形式的时间戳会有问题,这里进行处理
innerMaxDate() {
return uni.$u.test.number(this.maxDate)
? Number(this.maxDate)
: this.maxDate;
},
innerMinDate() {
return uni.$u.test.number(this.minDate)
? Number(this.minDate)
: this.minDate;
},
// 多个条件的变化,会引起选中日期的变化,这里统一管理监听
selectedChange() {
return [this.innerMinDate, this.innerMaxDate, this.defaultDate];
},
},
mounted() {
this.start = Date.now();
this.init();
},
// #ifdef VUE3
emits: ['monthSelected'],
// #endif
methods: {
// 在微信小程序中,不支持将函数当做props参数,故只能通过ref形式调用
setFormatter(e) {
this.innerFormatter = e;
},
// month组件内部选择日期后,通过事件通知给父组件
monthSelected(e) {
this.$emit('monthSelected', e);
},
init() {
// 校验maxDate,不能小于minDate
if (
this.innerMaxDate &&
this.innerMinDate &&
new Date(this.innerMaxDate).getTime() <
new Date(this.innerMinDate).getTime()
) {
return uni.$u.error('maxDate不能小于minDate');
}
// 滚动区域的高度
this.listHeight = this.rowHeight * 5 - 1;
this.setMonth();
},
// 获得两个日期之间的月份数
getMonths(minDate, maxDate) {
const minYear = dayjs(minDate).year();
const minMonth = dayjs(minDate).month() + 1;
const maxYear = dayjs(maxDate).year();
const maxMonth = dayjs(maxDate).month() + 1;
return (maxYear - minYear) * 12 + (maxMonth - minMonth) + 1;
},
// 设置月份数据
setMonth() {
// 最小日期的毫秒数
const minDate = this.innerMinDate || dayjs().valueOf();
// 如果没有指定最大日期,则往后推3个月
const maxDate =
this.innerMaxDate ||
dayjs(minDate)
.add(this.monthNum - 1, 'month')
.valueOf();
// 最大最小月份之间的共有多少个月份,
const months = uni.$u.range(
1,
this.monthNum,
this.getMonths(minDate, maxDate),
);
// 先清空数组
let monthsArr = [];
for (let i = 0; i < months; i++) {
monthsArr.push({
date: new Array(
dayjs(minDate).add(i, 'month').daysInMonth(),
)
.fill(1)
.map((item, index) => {
// 日期,取值1-31
let day = index + 1;
// 星期,0-6,0为周日
const week = dayjs(minDate)
.add(i, 'month')
.date(day)
.day();
const date = dayjs(minDate)
.add(i, 'month')
.date(day)
.format('YYYY-MM-DD');
let bottomInfo = '';
if (this.showLunar) {
// 将日期转为农历格式
const lunar = Calendar.solar2lunar(
dayjs(date).year(),
dayjs(date).month() + 1,
dayjs(date).date(),
);
bottomInfo = lunar.IDayCn;
}
let dateObj = new Date(date);
let disabled =
dayjs(date).isBefore(
dayjs(minDate).format('YYYY-MM-DD'),
) ||
dayjs(date).isAfter(
dayjs(maxDate).format('YYYY-MM-DD'),
);
if (!disabled) {
if (this.disabledDate) {
if (
uni.$u.test.string(
this.disabledDate,
)
) {
this.disabledDate = [
this.disabledDate,
];
}
this.disabledDate.forEach((item) => {
if (
dayjs(item).format(
'YYYY-MM-DD',
) === date
) {
disabled = true;
}
});
}
if (
this.disabledFun &&
uni.$u.test.func(this.disabledFun)
) {
let result = this.disabledFun(dateObj);
if (uni.$u.test.array(result)) {
disabled = result[0];
bottomInfo = result[1];
} else {
disabled = result;
}
}
}
let config = {
day,
week,
// 小于最小允许的日期,或者大于最大的日期,则设置为disabled状态
disabled,
// 返回一个日期对象,供外部的formatter获取当前日期的年月日等信息,进行加工处理
date: dateObj,
bottomInfo,
dot: false,
month:
dayjs(minDate).add(i, 'month').month() +
1,
};
const formatter =
this.formatter || this.innerFormatter;
return formatter(config);
}),
// 当前所属的月份
month: dayjs(minDate).add(i, 'month').month() + 1,
// 当前年份
year: dayjs(minDate).add(i, 'month').year(),
});
}
this.months = monthsArr;
},
// 滚动到默认设置的月份
scrollIntoDefaultMonth(selected) {
// 查询默认日期在可选列表的下标
const _index = this.months.findIndex(({ year, month }) => {
month = uni.$u.padZero(month);
return `${year}-${month}` === selected;
});
if (_index !== -1) {
this.$nextTick(() => {
// #ifndef MP-WEIXIN
this.scrollIntoView = `month-${_index}`;
// #endif
// #ifdef MP-WEIXIN
this.scrollTop = 0;
this.scrollTop = this.months[_index].top || 0;
// #endif
});
}
},
// scroll-view滚动监听
onScroll(event) {
// 不允许小于0的滚动值,如果scroll-view到顶了,继续下拉,会出现负数值
const scrollTop = Math.max(0, event.detail.scrollTop);
// 将当前滚动条数值,除以滚动区域的高度,可以得出当前滚动到了哪一个月份的索引
for (let i = 0; i < this.months.length; i++) {
if (scrollTop >= (this.months[i].top || this.listHeight)) {
this.monthIndex = i;
}
}
},
// 更新月份的top值
updateMonthTop(topArr = []) {
// 设置对应月份的top值,用于onScroll方法更新月份
topArr.map((item, index) => {
this.months[index].top = item;
});
// 获取默认日期的下标
if (!this.defaultDate) {
// 如果没有设置默认日期,则将当天日期设置为默认选中的日期
const selected = dayjs().format('YYYY-MM');
this.scrollIntoDefaultMonth(selected);
return;
}
let selected = dayjs().format('YYYY-MM');
// 单选模式,可以是字符串或数组,Date对象等
if (!uni.$u.test.array(this.defaultDate)) {
selected = dayjs(this.defaultDate).format('YYYY-MM');
} else {
selected = dayjs(this.defaultDate[0]).format('YYYY-MM');
}
this.scrollIntoDefaultMonth(selected);
},
},
};
</script>