Vant3 DatetimePicker 时间选择

介绍

时间选择器,支持日期、年月、时分等维度,通常与弹出层组件配合使用。

实例演示

引入

通过以下方式来全局注册组件,更多注册方式请参考组件注册

import { createApp } from vue;
import { DatetimePicker } from vant;

const app = createApp();
app.use(DatetimePicker);

代码演示

选择年月日

DatetimePicker 通过 type 属性来定义需要选择的时间类型,type 为 date 表示选择年月日。通过 min-date 和 max-date 属性可以确定可选的时间范围。

选择年月日

<van-datetime-picker
  v-model="currentDate"
  type="date"
  title="选择年月日"
  :min-date="minDate"
  :max-date="maxDate"
/>
import { ref } from vue;

export default {
  setup() {
    const currentDate = ref(new Date(2021, 0, 17));
    return {
      minDate: new Date(2020, 0, 1),
      maxDate: new Date(2025, 10, 1),
      currentDate,
    };
  },
};

选择年月

将 type 设置为 year-month 即可选择年份和月份。通过传入 formatter 函数,可以对选项文字进行格式化处理。

选择年月

<van-datetime-picker
  v-model="currentDate"
  type="year-month"
  title="选择年月"
  :min-date="minDate"
  :max-date="maxDate"
  :formatter="formatter"
/>
import { ref } from vue;

export default {
  setup() {
    const currentDate = ref(new Date());

    const formatter = (type, val) => {
      if (type === year) {
        return `${val}年`;
      }
      if (type === month) {
        return `${val}月`;
      }
      return val;
    };

    return {
      minDate: new Date(2020, 0, 1),
      maxDate: new Date(2025, 10, 1),
      formatter,
      currentDate,
    };
  },
};

选择月日

将 type 设置为 month-day 即可选择月份和日期。

选择月日

<van-datetime-picker
  v-model="currentDate"
  type="month-day"
  title="选择月日"
  :min-date="minDate"
  :max-date="maxDate"
  :formatter="formatter"
/>
import { ref } from vue;

export default {
  setup() {
    const currentDate = ref(new Date());

    const formatter = (type, val) => {
      if (type === month) {
        return `${val}月`;
      }
      if (type === day) {
        return `${val}日`;
      }
      return val;
    };

    return {
      minDate: new Date(2020, 0, 1),
      maxDate: new Date(2025, 10, 1),
      formatter,
      currentDate,
    };
  },
};

选择时间

将 type 设置为 time 即可选择时间(小时和分钟)。

选择时间

<van-datetime-picker
  v-model="currentTime"
  type="time"
  title="选择时间"
  :min-hour="10"
  :max-hour="20"
/>
import { ref } from vue;

export default {
  setup() {
    const currentTime = ref(12:00);
    return { currentTime };
  },
};

选择完整时间

将 type 设置为 datetime 即可选择完整时间,包括年月日和小时、分钟。

选择完整时间

<van-datetime-picker
  v-model="currentDate"
  type="datetime"
  title="选择完整时间"
  :min-date="minDate"
  :max-date="maxDate"
/>
import { ref } from vue;

export default {
  setup() {
    const currentDate = ref(new Date());
    return {
      minDate: new Date(2020, 0, 1),
      maxDate: new Date(2025, 10, 1),
      currentDate,
    };
  },
};

选择年月日小时

将 type 设置为 datehour 即可选择日期和小时,包括年月日和小时。

选择年月日时

<van-datetime-picker
  v-model="currentDate"
  type="datehour"
  title="选择年月日小时"
  :min-date="minDate"
  :max-date="maxDate"
/>
import { ref } from vue;

export default {
  setup() {
    const currentDate = ref(new Date());
    return {
      minDate: new Date(2020, 0, 1),
      maxDate: new Date(2025, 10, 1),
      currentDate,
    };
  },
};

选项过滤器

通过传入 filter 函数,可以对选项数组进行过滤,实现自定义时间间隔。

选项过滤器

<van-datetime-picker v-model="currentTime" type="time" :filter="filter" />
import { ref } from vue;

export default {
  setup() {
    const currentTime = ref(12:00);

    const filter = (type, options) => {
      if (type === minute) {
        return options.filter((option) => Number(option) % 5 === 0);
      }
      return options;
    };

    return {
      filter,
      currentTime,
    };
  },
};

自定义列排序

自定义列排序

<van-datetime-picker
  v-model="currentDate"
  type="date"
  title="自定义列排序"
  :columns-order="[month, day, year]"
  :formatter="formatter"
/>
import { ref } from vue;

export default {
  setup() {
    const currentDate = ref(new Date());

    const formatter = (type, val) => {
      if (type === year) {
        return val + 年;
      }
      if (type === month) {
        return val + 月;
      }
      if (type === day) {
        return val + 日;
      }
      return val;
    };

    return {
      formatter,
      currentDate,
    };
  },
};

API

Props

参数说明类型默认值
type时间类型,可选值为 date time

year-month month-day datehour

stringdatetime
title顶部栏标题string
confirm-button-text确认按钮文字string确认
cancel-button-text取消按钮文字string取消
show-toolbar是否显示顶部栏booleantrue
loading是否显示加载状态booleanfalse
readonly是否为只读状态,只读状态下无法切换选项booleanfalse
filter选项过滤函数(type: string, values: string[]) => string[]
formatter选项格式化函数(type: string, value: string) => string
columns-order自定义列排序数组, 子项可选值为

yearmonthdayhourminute

string[]
item-height选项高度,支持 px vw vh rem 单位,默认 pxnumber | string44
visible-item-count可见的选项个数number | string6
swipe-duration快速滑动时惯性滚动的时长,单位msnumber | string1000

DatePicker Props

当时间选择器类型为 date 或 datetime 时,支持以下 props:

参数说明类型默认值
min-date可选的最小时间,精确到分钟Date十年前
max-date可选的最大时间,精确到分钟Date十年后

TimePicker Props

当时间选择器类型为 time 时,支持以下 props:

参数说明类型默认值
min-hour可选的最小小时number | string0
max-hour可选的最大小时number | string23
min-minute可选的最小分钟number | string0
max-minute可选的最大分钟number | string59

Events

事件名说明回调参数
change当值变化时触发的事件value: 当前选中的时间
confirm点击完成按钮时触发的事件value: 当前选中的时间
cancel点击取消按钮时触发的事件

Slots

名称说明参数
default自定义整个顶部栏的内容
title自定义标题内容
confirm自定义确认按钮内容
cancel自定义取消按钮内容
option自定义选项内容option: string | object
columns-top自定义选项上方内容
columns-bottom自定义选项下方内容

方法

通过 ref 可以获取到 DatetimePicker 实例并调用实例方法,详见组件实例方法

方法名说明参数返回值
getPicker获取 Picker 实例,用于调用 Picker 的实例方法

常见问题

设置 min-date 或 max-date 后出现页面卡死的情况?

请注意不要在模板中直接使用类似min-date=”new Date()”的写法,这样会导致每次渲染组件时传入一个新的 Date 对象,而传入新的数据会触发下一次渲染,从而陷入死循环。

正确的做法是将min-date作为一个数据定义在data函数中。

在 iOS 系统上初始化组件失败?

如果你遇到了在 iOS 上无法渲染组件的问题,请确认在创建 Date 对象时没有使用new Date(2020-01-01)这样的写法,iOS 不支持以中划线分隔的日期格式,正确写法是new Date(2020/01/01)。

对此问题的详细解释:stackoverflow

在桌面端无法操作组件?

参见桌面端适配

是否有年份或月份选择器?

如果仅需要选择年份或者月份,建议直接使用 Picker 组件。

作者:唐伯虎点蚊香,如若转载,请注明出处:https://www.web176.com/vant3/18729.html

(0)
打赏 支付宝 支付宝 微信 微信
唐伯虎点蚊香的头像唐伯虎点蚊香
上一篇 2023年4月28日
下一篇 2023年4月28日

相关推荐

发表回复

您的电子邮箱地址不会被公开。 必填项已用 * 标注