更新记录

0.0.4(2024-01-28)

feat:新增方法返回当前年月

0.0.3(2024-01-26)

feat: 新增是否显示头部信息 新增handleChange事件

0.0.2(2024-01-26)

feat:解决选中日期和重要节日日期的背景色,文字颜色冲突

查看更多

平台兼容性

Vue2 Vue3
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
app-vue × × × × ×
钉钉小程序 快手小程序 飞书小程序 京东小程序
× × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari
× × ×

日历组件

简单介绍

  • 组件需要依赖 tailwindcss ,请自行在项目适配;
  • 本组件依赖 uni-app 内置组件swiper组件
  • nvue 页面中的swiper组件部分功能不支持,详情见uni-app 内置组件:swiper
  • 通过 uni_modules 引用组件,在页面 template 中即可直接使用,无需在页面中 import 和注册 components;
  • 可设置显示收缩按钮,收缩后只显示一个星期的日期,展开后显示一个月的日期;可以通过触摸屏幕左右滑动切换月份或切换年;
  • 本组件农历转换使用的 js 是 @1900-2100 区间内的公历、农历互转
  • 若有插件导入失败,重启编辑器;

API

属性说明

属性名 类型 默认值 说明
defaultStart number monday 周几为每周的第一天,可选值:[0~7]
headerLineColor string #008080 头部线颜色
lastMonthIcon urlString 头部切换上月图标
nextMonthIcon urlString 头部切换下月图标
lastYearIcon urlString 头部切换上年图标
nextYearIcon urlString 头部切换下年图标
currentDayBgColor string #008080 当前日期背景色颜色
festivalColor string #008080 重要节日文字颜色
currentDayColor string #008080 当前日期文字颜色
clickItemColor string #00808182 点击日期背景颜色
viewType string month 视图类型 可选值['month','week']
showHeader boolean true 是否显示头部导航

注意:

  1. 农历日期、节日、标记日期,只会显示其一,优先级 : 标记 > 节日 > 农历日期;

事件说明

事件名 说明 返回值
handleCurrent 点击日期项触发该函数 可通过回调参数 e 拿到该日期的详细信息
handleChange 日历组件月份切换 可通过回调参数 e 拿到切换后的当前年月
currentDay 返回当前日期项 可通过回调参数 e 拿到当前年月
  1. 方法使用:在组件上添加 @handleCurrent="handleClick" 事件,事件名可自行定义
  2. 方法使用:在组件上添加 @handleChange="handleChange" 事件,事件名可自行定义
  3. 方法使用:在组件上添加 @currentDay="handleCurrent" 事件,事件名可自行定义

@handleCurrent 返回值 e 说明

类型 说明
currentColor String 选中颜色
year number
month Number 阳历月
day Number 阳历日
type Number 月份所属
isCurrenMonth boolean 是否本月
lunarDate Object 农历信息,包含农历日期、节日、生肖等 详情见 @1900-2100 区间内的公历、农历互转

基本用法

template中使用组件


<template>
  <AtomCalendar @handleCurrent="handleClick" />
</template>

script中使用

<script setup lang="ts">
import AtomCalendar from "@/components/atom-calendar.vue";
const handleClick = (e: any) => {
  console.log(e, "接收参数");
};
</script>

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问