注册 X
提交 注:点击提交后系统会发送邮件到邮箱验证!(仅支持中国大陆邮箱)
我已阅读并同意 服务条款
首页 > IT技术笔记 > 查看笔记

vant-DatetimePicker 时间选择

介绍

时间选择器,支持日期、年月、时分等维度,通常与

弹出层

组件配合使用。

引入

        
        
      

代码演示

选择年月日

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

        
        
      

        
        
      

选择年月

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

        
        
      

        
        
      

选择月日

将 type 设置为 `month-day` 即可选择月份和日期(从 2.8.4 版本开始支持)。

        
        
      

        
        
      

选择时间

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

        
        
      

        
        
      

选择完整时间

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

        
        
      

        
        
      

选择年月日小时

将 type 设置为 `datehour` 即可选择日期和小时,包括年月日和小时(从 2.9.1 版本开始支持)。

        
        
      

        
        
      

选项过滤器

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

        
        
      

        
        
      

自定义列排序

        
        
      

        
        
      

API

Props

参数说明类型默认值
type时间类型,可选值为 date timeyear-month month-day datehourstringdatetime
title顶部栏标题string''
confirm-button-text确认按钮文字string确认
cancel-button-text取消按钮文字string取消
show-toolbar是否显示顶部栏booleantrue
loading是否显示加载状态booleanfalse
readonly v2.10.5是否为只读状态,只读状态下无法切换选项booleanfalse
filter选项过滤函数(type, vals) => vals-
formatter选项格式化函数(type, val) => val-
columns-order v2.9.2自定义列排序数组, 子项可选值为yearmonthdayhourminutestring[]-
item-height v2.8.6选项高度,支持 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当值变化时触发的事件picker: Picker 实例
confirm点击完成按钮时触发的事件value: 当前选中的时间
cancel点击取消按钮时触发的事件-

Slots

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

方法

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

组件实例方法

方法名说明参数返回值
getPicker v2.5.3获取 Picker 实例,用于调用 Picker 的[实例方法](https://youzan.github.io/vant/v2/#/zh-CN/picker#fang-fa)--

常见问题

设置 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

组件。


 打赏        分享



评论

邮箱: 昵称: