这里写目录标题
el-date-picker
基础用法
<template>
<el-date-picker v-model="time></el-date-picker>
</template>
<script>
const time = ref<Date>()
</script>
属性
v-model: 动态绑定的值,类型为number、string,array,即为value-format输出的内容
editable: 如果为否,就不能通过输入框填写日期,只能通过下拉面板选择
placeholder、start-placeholder、end-placeholder: 占位内容
type:显示类型,非范围的包括year、month。week、date、datetime,返回的是一个string|number|Date,范围的包括datetimerange、monthrange、daterange(这些只能选择其实两个日期,返回的是只有两个元素的数组,数组元素是value-format的内容)、dates(可以选择单独的多个日期,返回的是包含多个元素的数组,每个元素代表每个选中日期的value-format输出内容)
format:选中日期后,输入框展示的格式,类似”YYYY:MM:DD HH:mm:ss“
value-format:绑定值或其元素的格式
prefix-icon 前缀图标
range-separator:选择范围时(两个输入框)的分隔符,对应的插槽range-separator
shortcuts:是一个数组,下拉面板上快捷选项,比如近一个月、近一年等等,元素的text属性表示前端展示的标签,value代表真实的内容,可以是date对象或date数组,也可以是返回上述内容的函数
disabled-date:值为函数,用来对某些日期金庸,函数参数是date,对面板上的每个日期进行校验,返回true表示禁用
popper-class:DatePicker 下拉框的类名,因为默认下拉面板是挂在body下的,在组建内是不能定义样式的,绑定改类名后,再非scoped的style标签下,可以通过该类名定义样式
teleported:表示下拉面板是否挂在body元素下,true为是,当为false时,会挂在el-date-picker的父元下,可以相对父元素设置样式,比如相对父元素的位置等
default-value:只设置default-value的话,下拉面板会根据其值,展示对应的年月日的日历。但在type=”datetime"时,会直接将其年月日时分秒默认面板上的输入框中。虽然官网文档提到default-value可以为Date[],但其实只需要设置为Date对象就行。
- 如果只是想给datetime设置个默认时间,而不需要默认日期的话,使用default-time更合适
default-time:当设置了default-time,会为v-model绑定的值对应的时分秒默认成default-time的时分秒,default-time上的年月日是没有用的。如果default-time为date对象,那么不论是单个日期,还是日期数组的元素,默认时分秒都会是default-time的时分秒。
- 除非是daterange、monthrange、datetimerange,default-time如果希望起止日期默认时间不同,可以把default-time设置为date数组。
- 其他type,default-time都只能是Date对象,而不能是数组,否则页面会出错
方法
- change:选择的日期变更时触发,参数为v-model绑定的值