Calendar 日历
WebH5
整月日历面板。支持选中日期、min/max 限制、面板翻页、农历与传统节日显示(lunar)、代办事项事件标记(events)、节假日/工作日角标(holidays/workdays),date-cell 插槽可完全自定义日期格内容。
何时使用
需要整月视图选日期或展示日期维度信息:日程看板、考勤标记、活动日历、农历节日展示、代办事项标记、节假日与补班排班。
何时不使用
表单里单纯录入一个日期用 DatePicker 更省空间;需要选时间用 TimePicker/TimeSelect。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | string | null | "null" | 绑定值,格式 'YYYY-MM-DD',配合 v-model 使用 |
min | string | - | 可选最小日期(含),格式 'YYYY-MM-DD' |
max | string | - | 可选最大日期(含),格式 'YYYY-MM-DD' |
lunar | boolean | "false" | 是否显示农历:日号下方小字,初一显月份名(正月/腊月/闰五月),传统节日(春节/端午/中秋/除夕等)显节日名并主色高亮。支持 1900-2100 |
festivals | boolean | "true" | 是否显示公历节日(元旦/劳动节/国庆等,主色高亮),仅在 lunar 开启时生效 |
events | { date: string; label: string; type?: 'primary' | 'success' | 'warning' | 'danger' }[] | "[]" | 代办事项列表。有事件的格子显示事件条(soft 底 + 色字,单行省略),最多 2 条,超出折叠为 +N。lunar 或 events 开启时格子自动增高 |
holidays | string[] | "[]" | 节假日(休息日)日期列表,格式 'YYYY-MM-DD'。这些日期在格子右上角显示红色「休」角标 |
workdays | string[] | "[]" | 工作日(补班/调休)日期列表,格式 'YYYY-MM-DD'。这些日期在格子右上角显示「班」角标;同一日期同时命中 holidays 时以 workdays 为准 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | string | 选中日期时触发 |
change | string | 选中日期(含点击“今天”)时触发 |
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 文档(含手机预览)。