Skip to content

日历

@astryxdesign/core v0.7.1 · Calendar

Calendar Props ​

名称类型默认值说明
modelValueDate | nullnull当前选中的日期。
mode'single' | 'range''single'选一天,或选一段起止日期。
range{ start: Date | null, end: Date | null } | nullnull范围值,用 v-model:range 绑定。
numberOfMonths1 | 21并排显示的月份数。
focusDateDate—先显示这一天所在的月份。
minDate—最早可选日期。
maxDate—最晚可选日期。
isDateDisabled(date: Date) => boolean—返回 true 时该日期不可选。
dateConstraintsArray<(date: Date) => boolean>—任一函数返回 false 时该日期不可选。和最早、最晚、禁用判断一起生效。
minRangeSpannumber1范围最短天数,含两端。大于 1 时,再点一次起点会取消这次选择。
maxRangeSpannumber—范围最长天数,含两端。起点还没选中时不生效。
hasOutsideDaysbooleantrue显示相邻月份的日期。这些日期不能选。
hasWeekNumbersbooleanfalse在每一行左侧显示周数。
hasVariableRowCountbooleanfalse行数随当月缩短。关闭时固定六行。
weekStartsOn0-6 | 'sun' | 'mon' | 'tue' | 'wed' | 'thu' | 'fri' | 'sat'0一周从哪一天开始。0 是周日。
handleRefRef | (handle) => void—接收翻月句柄。调用 navigateTo 会翻到那一天并聚焦它。
labelstringCalendar / 日历日历的无障碍名称。未设置语言时为英文,提供 zh-CN 后为中文。
disabledbooleanfalse是否禁用整个日历。

Calendar 事件 ​

名称载荷说明
update:modelValuevalue: Date | null选中日期变化时触发。
update:rangevalue: { start: Date | null, end: Date | null }日期范围变化时触发。
changevalue: Date | null选中日期变化时触发。
update:focusDatevalue: Date可见月份变化时触发,值是该月第一天。

Calendar 插槽 ​

名称参数说明
header—自定义月份头部。
day{ date, isSelected, isDisabled, isToday, isInMonth }自定义日期单元格。