Skip to content

Calendar 日历

用于展示日期的日历组件,支持自定义内容和头部。

基础使用

Calendar 组件支持通过 v-model 进行日期选择,未指定时默认显示当前月份。

自定义单元格

通过设置 date-cell 插槽来自定义日历单元格中显示的内容,可以获取到当前单元格的日期信息。

自定义头部

使用 header 插槽来自定义日历头部内容,可以获取到日期切换的方法。

Calendar API

Calendar 属性

属性说明类型默认值
model-value/v-model绑定值Date-
readonly是否只读booleanfalse

Calendar 插槽

插槽名说明作用域参数
header自定义头部内容{ date: Date, prevMonth: () => void, nextMonth: () => void, prevYear: () => void, nextYear: () => void, today: () => void }
date-cell自定义单元格内容{ data: { type: 'prev-month' | 'current-month' | 'next-month', isSelected: boolean, day: string, date: Date } }

Calendar 事件

事件名说明类型
change选中日期变化时触发(value: Date) => void

Calendar 方法

方法名说明类型
prevYear切换到上一年() => void
nextYear切换到下一年() => void
prevMonth切换到上一月() => void
nextMonth切换到下一月() => void
today切换到今天() => void