pco/app/uview-ui/components/u-calendar/u-calendar.vue

<template>
  <u-popup
      :show="show"
      mode="bottom"
      closeable
      @close="close"
      :round="round"
      :closeOnClickOverlay="closeOnClickOverlay"
  >
    <view class="u-calendar">
      <uHeader
          :title="title"
          :subtitle="subtitle"
          :showSubtitle="showSubtitle"
          :showTitle="showTitle"
      ></uHeader>
      <scroll-view
          :style="{
                    height: $u.addUnit(listHeight)
                }"
          scroll-y
          @scroll="onScroll"
          :scroll-top="scrollTop"
          :scrollIntoView="scrollIntoView"
      >
        <uMonth
            :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>
      <slot name="footer" v-if="showConfirm">
        <view class="u-calendar__confirm">
          <u-button
              shape="circle"
              :text="
                            buttonDisabled ? confirmDisabledText : confirmText
                        "
              :color="color"
              @click="confirm"
              :disabled="buttonDisabled"
          ></u-button>
        </view>
      </slot>
    </view>
  </u-popup>
</template>

<script>
import uHeader from './header.vue'
import uMonth from './month.vue'
import props from './props.js'
import dayjs from '../../libs/util/dayjs.js'
import Calendar from '../../libs/util/calendar.js'

/**
 * Calendar 日历
 * @description  此组件用于单个选择日期，范围选择日期等，日历被包裹在底部弹起的容器中.
 * @tutorial https://www.uviewui.com/components/calendar.html
 *
 * @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 {String}        confirmText      确定按钮的文字 (默认 '确定' )
 * @property {String}        confirmDisabledText  确认按钮处于禁用状态时的文字 (默认 '确定' )
 * @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}      round        圆角值，默认无圆角  (默认 0 )
 * @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',
  mixins: [uni.$u.mpMixin, uni.$u.mixin, props],
  components: {
    uHeader,
    uMonth
  },
  data() {
    return {
      // 需要显示的月份的数组
      months: [],
      // 在月份滚动区域中，当前视图中月份的index索引
      monthIndex: 0,
      // 月份滚动区域的高度
      listHeight: 0,
      // month组件中选择的日期数组
      selected: [],
      scrollIntoView: '',
      scrollTop: 0,
      // 过滤处理方法
      innerFormatter: (value) => value
    }
  },
  watch: {
    selectedChange: {
      immediate: true,
      handler(n) {
        this.setMonth()
      }
    },
    // 打开弹窗时，设置月份数据
    show: {
      immediate: true,
      handler(n) {
        this.setMonth()
      }
    }
  },
  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]
    },
    subtitle() {
      // 初始化时，this.months为空数组，所以需要特别判断处理
      if (this.months.length) {
        return `${this.months[this.monthIndex].year}年${
            this.months[this.monthIndex].month
        }月`
      } else {
        return ''
      }
    },
    buttonDisabled() {
      // 如果为range类型，且选择的日期个数不足1个时，让底部的按钮出于disabled状态
      if (this.mode === 'range') {
        if (this.selected.length <= 1) {
          return true
        } else {
          return false
        }
      } else {
        return false
      }
    }
  },
  mounted() {
    this.start = Date.now()
    this.init()
  },
  methods: {
    // 在微信小程序中，不支持将函数当做props参数，故只能通过ref形式调用
    setFormatter(e) {
      this.innerFormatter = e
    },
    // month组件内部选择日期后，通过事件通知给父组件
    monthSelected(e) {
      this.selected = e
      if (!this.showConfirm) {
        // 在不需要确认按钮的情况下，如果为单选，或者范围多选且已选长度大于2，则直接进行返还
        if (
            this.mode === 'multiple' ||
            this.mode === 'single' ||
            (this.mode === 'range' && this.selected.length >= 2)
        ) {
          this.$emit('confirm', this.selected)
        }
      }
    },
    init() {
      // 校验maxDate，不能小于当前时间
      if (
          this.innerMaxDate &&
          new Date(this.innerMaxDate).getTime() <= Date.now()
      ) {
        return uni.$u.error('maxDate不能小于当前时间')
      }
      // 滚动区域的高度
      this.listHeight = this.rowHeight * 5 + 30
      this.setMonth()
    },
    close() {
      this.$emit('close')
    },
    // 点击确定按钮
    confirm() {
      if (!this.buttonDisabled) {
        this.$emit('confirm', this.selected)
      }
    },
    // 获得两个日期之间的月份数
    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)
      )
      // 先清空数组
      this.months = []
      for (let i = 0; i < months; i++) {
        this.months.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 config = {
                  day,
                  week,
                  // 小于最小允许的日期，或者大于最大的日期，则设置为disabled状态
                  disabled:
                      dayjs(date).isBefore(
                          dayjs(minDate).format('YYYY-MM-DD')
                      ) ||
                      dayjs(date).isAfter(
                          dayjs(maxDate).format('YYYY-MM-DD')
                      ),
                  // 返回一个日期对象，供外部的formatter获取当前日期的年月日等信息，进行加工处理
                  date: new Date(date),
                  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()
        })
      }

    },
    // 滚动到默认设置的月份
    scrollIntoDefaultMonth(selected) {
      // 查询默认日期在可选列表的下标
      const _index = this.months.findIndex(({
                                              year,
                                              month
                                            }) => {
        month = uni.$u.padZero(month)
        return `${year}-${month}` === selected
      })
      if (_index !== -1) {
        // #ifndef MP-WEIXIN
        this.$nextTick(() => {
          this.scrollIntoView = `month-${_index}`
        })
        // #endif
        // #ifdef MP-WEIXIN
        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>

<style lang="scss" scoped>
@import '../../libs/css/components.scss';

.u-calendar {
  &__confirm {
    padding: 7px 18px;
  }
}
</style>