Skip to content

时间区间选择器

vx-range-picker 组件用于选择时间区间,提供灵活的日期范围选择功能。

目录

Props

公共props

该组件继承了 vx-field的props,所以是通用的,以下仅罗列 vx-range-picker 特有的Props

NameIntroductionTypeDefault Value
type组件类型Stringdatepicker
format日期格式化String'YYYY-MM-DD'
clearable显示可清除样式Booleanfalse

vx-range-picker props

NameIntroductionTypeDefault Value
placeholder占位文本string[]['', '']
needConfirm选中的值需要点击确认才生效booleanfalse
datePickerPropsvuetify 原生参数,用于控制时间选择组件datePickerProps[][]
modelValue绑定的值,见值类型string[] number[] Date[]['', '']

Events

NamePayloadIntroduction
click:confirm{ value: Ref<number[]>, next: Promise }配置了 needconfirm 可以结合 click:confirm 实现对值的校验
blurstring某些情况如果期望失焦或者关闭了下拉后获取值时用这个事件,查看blur 事件示例

值类型

  • 组件拥有很强的传入值适应性,可以传入各种类型的值并格式化字符串、时间戳、日期类型都可,最终都会被格式化成默认格式或者传入的format格式
  • vx-range-picker 可以切换值选中模式,当 needConfirmtrue 时,需要点击确认按钮值才生效

组件类型

  • type: datepicker datetimepicker

日期格式化 format

  • datepicker 默认格式是 YYYY-MM-DD
  • datetimepicker 默认格式是 YYYY-MM-DD HH:mm:ss
  • format 不仅影响展示也影响组件的可选项,以及绑定的 modelValue

配合 datePickerProps 控制

可以通过 datePickerProps 对两个日期选择器分别进行控制,例如设置可选日期范围。

各种状态

blur 事件示例

blur 事件在组件失焦或关闭下拉菜单时触发,可用于获取当前值或执行其他操作。