跳到主要内容

Calendar 日历 ​

WebH5

整月日历面板。支持选中日期、min/max 限制、面板翻页、农历与传统节日显示(lunar)、代办事项事件标记(events)、节假日/工作日角标(holidays/workdays),date-cell 插槽可完全自定义日期格内容。

何时使用 ​

需要整月视图选日期或展示日期维度信息:日程看板、考勤标记、活动日历、农历节日展示、代办事项标记、节假日与补班排班。

何时不使用 ​

表单里单纯录入一个日期用 DatePicker 更省空间;需要选时间用 TimePicker/TimeSelect。

Props ​

名称类型默认值说明
modelValuestring | null"null"绑定值,格式 'YYYY-MM-DD',配合 v-model 使用
minstring-可选最小日期(含),格式 'YYYY-MM-DD'
maxstring-可选最大日期(含),格式 'YYYY-MM-DD'
lunarboolean"false"是否显示农历:日号下方小字,初一显月份名(正月/腊月/闰五月),传统节日(春节/端午/中秋/除夕等)显节日名并主色高亮。支持 1900-2100
festivalsboolean"true"是否显示公历节日(元旦/劳动节/国庆等,主色高亮),仅在 lunar 开启时生效
events{ date: string; label: string; type?: 'primary' | 'success' | 'warning' | 'danger' }[]"[]"代办事项列表。有事件的格子显示事件条(soft 底 + 色字,单行省略),最多 2 条,超出折叠为 +N。lunar 或 events 开启时格子自动增高
holidaysstring[]"[]"节假日(休息日)日期列表,格式 'YYYY-MM-DD'。这些日期在格子右上角显示红色「休」角标
workdaysstring[]"[]"工作日(补班/调休)日期列表,格式 'YYYY-MM-DD'。这些日期在格子右上角显示「班」角标;同一日期同时命中 holidays 时以 workdays 为准

Events ​

名称载荷说明
update:modelValuestring选中日期时触发
changestring选中日期(含点击“今天”)时触发
panel-change{ year: number; month: number }面板年月切换时触发(翻页/点前后月日期/回今天),month 为 1-12
event-click(event: { date: string; label: string; type?: string }, day: { date: string; day: number; inCurrentMonth: boolean; isToday: boolean })点击事件条时触发(已 stopPropagation,不会触发日期选中)

Slots ​

名称说明
date-cell自定义日期格内容,scope { date, day, isSelected, isToday, inCurrentMonth }。提供插槽时完全接管格子内容,lunar/events 默认渲染不再生效(插槽优先)

示例 ​

基础用法 ​

示例加载中…

农历与节日 ​

示例加载中…

节假日与工作日 ​

示例加载中…

代办事项 ​

示例加载中…

日程标记(date-cell 插槽) ​

示例加载中…

限定可选范围 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Calendar 文档(含手机预览)。