介绍

组合了日期时间范围、弹出框组件，实现了便捷快速的日期时间范围选择功能。

引入

import DatetimeRangePickerPopout from 'sard-uniapp/components/datetime-range-picker-popout/datetime-range-picker-popout.vue'

代码演示

基础使用

使用 v-model 双向绑定当前值，使用 v-model:visible 控制弹出框显隐。

vue lang="ts"

<template>
  <sar-datetime-range-picker-popout
    v-model="date"
    v-model:visible="visible"
    title="请选择"
    :tabs="['开始日期', '结束日期']"
    type="yMd"
    @change="onChange"
  />

  <sar-list card>
    <sar-list-item>
      <sar-button @click="visible = true">
        {{ date ? displayText : '请选择' }}
      </sar-button>
    </sar-list-item>
    <sar-list-item
      title="设置为前一个月"
      arrow
      hover
      @click="
        date = [
          new Date(new Date().setMonth(new Date().getMonth() - 1)),
          new Date(),
        ]
      "
    />
    <sar-list-item title="清空" arrow hover @click="date = undefined" />
  </sar-list>
</template>

<script setup lang="ts">
import { formatDate } from 'sard-uniapp'
import { computed, ref } from 'vue'

const visible = ref(false)
const date = ref<Date[]>()

const displayText = computed(() => {
  return JSON.stringify(
    date.value?.map((item) => formatDate(item, 'YYYY-MM-DD')),
  )
})

const onChange = (value: any) => {
  console.log('change', value)
}
</script>

vue lang="js"

<template>
  <sar-datetime-range-picker-popout
    v-model="date"
    v-model:visible="visible"
    title="请选择"
    :tabs="['开始日期', '结束日期']"
    type="yMd"
    @change="onChange"
  />

  <sar-list card>
    <sar-list-item>
      <sar-button @click="visible = true">
        {{ date ? displayText : '请选择' }}
      </sar-button>
    </sar-list-item>
    <sar-list-item
      title="设置为前一个月"
      arrow
      hover
      @click="
        date = [
          new Date(new Date().setMonth(new Date().getMonth() - 1)),
          new Date(),
        ]
      "
    />
    <sar-list-item title="清空" arrow hover @click="date = undefined" />
  </sar-list>
</template>

<script setup lang="js">
import { formatDate } from "sard-uniapp";
import { computed, ref } from "vue";
const visible = ref(false);
const date = ref();
const displayText = computed(() => {
  return JSON.stringify(
    date.value?.map((item) => formatDate(item, "YYYY-MM-DD"))
  );
});
const onChange = (value) => {
  console.log("change", value);
};
</script>

API

DatetimeRangePickerPopoutProps

继承 DatetimeRangePickerProps 并有以下额外属性：

属性	描述	类型	默认值
popout-class	弹窗框根元素类名	string	-
popout-style	弹窗框根元素样式	StyleValue	-
visible (v-model)	是否显示弹出框	boolean	-
title	弹出框标题	string	-
validate-event	是否触发表单验证	boolean	true
resettable 1.23.3+	关闭弹出框后，是否可复位弹出框值	boolean	false

DatetimeRangePickerPopoutEmits

事件	描述	类型
update:model-value	日期时间输入组件值改变时触发	(date: (Date | string)[]) => void
change	日期时间输入组件值改变时触发	(date: (Date | string)[]) => void
update:visible	弹出框显隐时触发	(visible: boolean) => void
confirm 1.22.1+	点击确定按钮时触发	() => void
visible-hook 1.22.1+	入场/退场动画状态改变时触发	(name: TransitionHookName) => void
before-enter 1.22.1+	入场动画开始前触发	() => void
enter 1.22.1+	入场动画开始时触发	() => void
after-enter 1.22.1+	入场动画结束时触发	() => void
enter-cancelled 1.22.1+	入场动画取消时触发	() => void
before-leave 1.22.1+	退场动画开始前触发	() => void
leave 1.22.1+	退场动画开始时触发	() => void
after-leave 1.22.1+	退场动画结束时触发	() => void
leave-cancelled 1.22.1+	退场动画取消时触发	() => void

DatetimeRangePickerPopoutSlots

继承 PopoutInputSlots 和 DatetimeRangePickerSlots