Appearance

so-calendar

so-calendar组件 是基于 u-calendaropen in new window历组件,有单选范围 两种模式,返回日期固定为年月日,即 yyyy-MM-dd,如果需要选择时分秒,请使用so-time组件。

代码示例

模板代码

<so-calendar v-model="form.date" mode="date" max-date="2021-05-14" @confirm="selectDate" />

<so-calendar  v-model="form.dateRange" mode="range" max-date="2021-05-14" @confirm="selectDate" :disabled="true"></so-calendar>

js代码


 methods:{
     selectDate(record){
		console.log(record);
	},
 }

日历模式

即单选模式,点击确定 @confirm返回值:

{
	day: 4, // 选择了哪一天
	days: 30, // 这个月份有多少天
	isToday: true, // 选择的日期是否今天
	month: 6, // 选择的月份
	result: "2020-06-04", // 选择的日期整体值
	week: "星期四", // 选择日期所属的星期数
	year: 2020 , // 选择的年份
}

日期范围模式

点击确定 @confirm返回值:

{
	endDate: "2020-06-04", // 选择的结束日期
	endDay: 4, // 结束日期是哪一天
	endMonth: 6, // 结束日期的月份
	endWeek: "星期四", // 结束日期的星期数
	endYear: 2020, // 结束日期的年份
	startDate: "2020-06-01", // 选择的起始日期
	startDay: 1, // 起始日期是哪一天
	startMonth: 6, // 起始日期的月份
	startWeek: "星期一", // 起始日期的星期数
	startYear: 2020 // 起始日期的年份
}

Props

参数说明类型默认值可选值
v-model/value输入值,日期范围可以为逗号隔开的字符串也可以为2个值的数组String|Array--
mode模式,默认为日期模式String'date''range'
split-letter日期分隔符,默认用中横杠String'-'-
join-letter日期范围联结字符String'至'-
min-date最小可选日期Number | String1900-01-01-
max-date最大可选日期Number | String2100-01-01-
max-year可切换的最大年份Number | String2050-
min-year可切换的最小年份Number | String1950-
border输入框边框Booleanfalsetrue
disabled是否禁用,禁用后能选择,但输入值不会变化Booleanfalsetrue
mask-close-able是否允许通过点击遮罩关闭日历Booleantruefalse
month-arrow-color月份切换按钮箭头颜色String#606266-
year-arrow-color年份切换按钮箭头颜色String#909399-
color日期字体的默认颜色String#303133-
active-bg-color起始/结束日期按钮的背景色String#2979ff-
z-index弹出时的z-indexString | Number10075-
active-color起始/结束日期按钮的字体颜色String#ffffff-
range-bg-color起始/结束日期之间的区域的背景颜色Stringrgba(41,121,255,0.13)-
range-color选择范围内字体颜色String#2979ff-
start-text起始日期底部的提示文字String开始-
end-text结束日期底部的提示文字String结束-
btn-type底部确定按钮的主题Stringprimarydefault / success / info/ warning / error
toolTip顶部提示文字,如设置名为tooltipslot,此参数将失效String选择日期-
closeable是否显示右上角的关闭图标Booleantruefalse

Events

方法名说明参数
confirm返回选择日期,返回值如上介绍Function(record)

Slots

名称说明
tooltip自定义日历顶部的内容

更多API接口及说明,可查看 u-calendar手册open in new window