更新记录
1.0.1(2024-12-19)
下载此版本
- 初始版本发布
- 基础日历功能
- 支持日期选择
- 支持禁用日期
- 支持自定义事件
平台兼容性
App |
快应用 |
微信小程序 |
支付宝小程序 |
百度小程序 |
字节小程序 |
QQ小程序 |
HBuilderX 3.1.0 app-vue |
√ |
√ |
√ |
√ |
√ |
√ |
钉钉小程序 |
快手小程序 |
飞书小程序 |
京东小程序 |
鸿蒙元服务 |
√ |
√ |
√ |
√ |
× |
H5-Safari |
Android Browser |
微信浏览器(Android) |
QQ浏览器(Android) |
Chrome |
IE |
Edge |
Firefox |
PC-Safari |
√ |
√ |
√ |
√ |
√ |
× |
√ |
√ |
√ |
lkl-calendar-pro
一个功能强大、易用的日历选择组件,支持单选、多选和范围选择,并且包含农历显示功能。
特性
- 支持三种选择模式:单选、多选和范围选择
- 支持农历日期显示
- 支持自定义主题颜色
- 支持禁用日期
- 优雅的选择交互
- 支持 Vue2 和 Vue3
安装
在插件市场中搜索并导入 lkl-calendar-pro
组件。
使用方法
<template>
<lkl-calendar-pro
v-model="selectedDate"
:mode="mode"
:lunar="true"
/>
</template>
<script>
export default {
data() {
return {
selectedDate: '',
mode: 'single' // 'single' | 'multiple' | 'range'
}
}
}
</script>
API
Props
参数 |
说明 |
类型 |
默认值 |
v-model/modelValue |
选中的日期值 |
String/Array |
- |
mode |
选择模式:单选/多选/范围 |
'single'/'multiple'/'range' |
'single' |
lunar |
是否显示农历 |
Boolean |
false |
disabled |
禁用的日期 |
Function/Array |
- |
themeColor |
主题颜色 |
String |
'#2979ff' |
Events
事件名 |
说明 |
回调参数 |
day-click |
点击日期时触发 |
day: 日期对象 |
change |
日期选择变化时触发 |
value: 选中的日期值 |
day 对象结构
{
date: '1', // 日期
fullDate: '2024-12-19', // 完整日期
lunar: '初五', // 农历日期
isToday: true, // 是否是今天
disabled: false, // 是否禁用
currentMonth: true // 是否是当前月份
}
示例
单选模式
<lkl-calendar-pro v-model="date" mode="single" />
多选模式
<lkl-calendar-pro v-model="dates" mode="multiple" />
范围选择
<lkl-calendar-pro v-model="dateRange" mode="range" />
显示农历
<lkl-calendar-pro v-model="date" :lunar="true" />
自定义主题色
<lkl-calendar-pro v-model="date" themeColor="#ff4757" />
更新日志
查看 CHANGELOG.md 了解详细更新记录。
许可证
MIT