Skip to content

UNV Calendar 日历组件

UNV Calendar 预览图

📝 组件介绍

封装日历组件,可以在日历上进行预约或签到。

🌟 组件特性

  1. 一款自定义封装的日历组件
  2. 可以用于门票预约、签到等场景
  3. 目前最多只放开当前月份和下一个月的日期,如果需要更多的日期,需要自己进行扩展

📦 基本信息

📍 组件地址

https://p.dcloud.net.cn/plugin?id=23129

💻 组件源码

https://github.com/lhx-liu/lhx-components

📄 更新日志

bash
更新 1.0.0版本
初始版本

🚀 快速开始

📋 兼容性

bash
端:只测试过H5、微信小程序,其他端未测试
框架:vue2、vue3

⬇️ 安装方式

bash
请在uniapp插件市场安装

🔧 引入方式

bash
本组件符合easycom组件规范,直接在页面中使用

🎯 使用示例

javascript
<template>
	<view class="test-box">
		<view class="text">
			日历使用示例
		</view>
		<view class="text1">1、预约示例</view>
		<view class="calendar-box">
			<unv-calendar :selected="openDays1" @changeDay="changeDay" :monthCanChange="true"></unv-calendar>
		</view>
		<view class="text1">2、签到示例</view>
		<view class="calendar-box">
			<unv-calendar :selected="openDays2" :title="false" @changeDay="changeDay" :monthCanChange="true"></unv-calendar>
		</view>
	</view>
</template>

<script>
	export default {
		data() {
			return {
				openDays1: [
					{
						date: '2025-04-21',
						disable: true,
						info: '已约完'
					},
					{
						date: '2025-04-22',
						disable: false,	
						info: '可预约'
					},
					{
						date: '2025-04-23',
						disable: false,	
						info: '可预约'
					},
					{
						date: '2025-04-24',
						disable: false,	
						info: '可预约'
					},
					{
						date: '2025-04-25',
						disable: true,	
						info: '未开放'
					},
					{
						date: '2025-04-26',
						disable: true,	
						info: '未开放'
					}
				],
				openDays2: [
					{
						date: '2025-04-19',
						showDot: true,
						disable: true,
						info: '已签到'
					},
					{
						date: '2025-04-20',
						showDot: false,
						info: '补签'
					},
					{
						date: '2025-04-21',
						showDot: false,
						info: '签到'
					}
				]
			}
		},
		methods: {
			changeDay(date, day) {
				console.log('date', date);
				console.log('day', day);
			},
		}
	}
</script>

⚙️ Props 属性

属性说明

属性名类型默认值说明
selectedArray[dateObj][]打点数组,dateObj为日期对象
monthCanChangeBooleanfalse是否可以切换月份
titleBooleantrue是否显示标题

dateObj 说明

属性名类型默认值说明
dateString-日期(格式:YYYY-MM-DD)
disableBooleanfalse是否禁用该日期
infoString-提示信息
showDotBooleanfalse是否显示圆点

如果需要支持更多属性,请自行 fork 代码进行扩展


📡 Events 事件

changeDay 事件

日期点击事件

参数名类型说明
dateString选中的日期
dayObject日期对象,包含 date、disable、info、showDot 属性

👨‍💻 作者信息

liuhaixu

版本信息

bash
V1.0.0
日历组件