1.0.5 • Published 2 years ago
calendar-vue-app v1.0.5
vue-calendar-ui(当前版本 V1.0.5)
一款高效、简洁、功能丰富、宽度可自适应的 app 端考勤日历插件
兼容版本
Vue2.x
Install
npm i calendar-vue-app -S
//main.js
import cv from "calendar-vue-app";
Vue.use(cv)
//页面使用
<calendar-vue-app
ref="cv"
:mark-arr="mark"
title-color="#333"
arrow-color="#333"
crrentdaybg-color="#333"
weeklabel-color="red"
@onclickdate="onclickdate"
@onchangemonth="onchangemonth"
></calendar-vue-app>
//跳转指定月份api调用
this.$refs.cv.jumpToMonth("2020-03-12");版本 ui 效果图
Attribute
| 属性 | 类型 | 说明 | 默认 | 是否必传 |
|---|---|---|---|---|
| animated | Boolean | 是否可缩放 | TRUE | FALSE |
| zoom | Boolean | 是否默认展开 | FALSE | FALSE |
| future-disabled | Boolean | 是否不可跳转到未来月份 | FALSE | FALSE |
| sunday-start | Boolean | 日历是否周天开始 | FALSE | FALSE |
| titlebg-color | String | title 背景颜色(V2.X 版本已废弃) | #f5f7fa | FALSE |
| title-color | String | title 字体颜色 | #333333 | FALSE |
| title-split | Boolean 或 String | title 年月间隔 | "-" | FALSE |
| weeklabel-color | String | 礼拜几字体颜色 | #9da5b1 | FALSE |
| arrow-color | String | 箭头颜色 | #4b7df6 | FALSE |
| itembg-color | String | 默认日期背景颜色 | #fff | FALSE |
| itemlabel-color | String | 默认日期字体颜色 | #333333 | FALSE |
| birthdaybg-color | String | 当天生日的背景颜色 | #FFF5E7 | FALSE |
| birthdaylabel-color | String | 当天生日的字体颜色 | #333333 | FALSE |
| crrentdaybg-color | String | 今天的背景颜色 | #4b7df6 | FALSE |
| crrentdaylabel-color | String | 今天的字体颜色 | #fff | FALSE |
| clickdaybg-color | String | 当前点击日期的背景颜色 | rgba(51, 51, 51,0.8) | FALSE |
| clickdaylabel-color | String | 当前点击日期的字体颜色 | #fff | FALSE |
| prev-color | String | 当月之前的日期颜色 | #cccccc | FALSE |
| next-color | String | 当月之后的日期颜色 | #cccccc | FALSE |
| birthday-arr | Array | 需要标记生日日期列表(下方详细说明) | [] | FALSE |
| mark-arr | Array | 需要标记的日期列表(下方详细说明) | [] | FALSE |
birthday-arr
| 类型 | 示例 |
|---|---|
| String | "2020/05/20","2020/05/21" |
mark-arr
| 属性 | 类型 | 说明 | 格式 | 默认 |
|---|---|---|---|---|
| date | String | 需要标记的日期 | YYYY/MM/DD | |
| color | String | 要标记日期底部图标或字的颜色 | #333333 | |
| isLabel | Boolean | 要标记日期底部是否显示文字 | true/false | false |
| label | String | 要标记日期底部设置显示文字时的 label | ||
| userPopover | Boolean | 有额外信息标记的时候是否使用默认的 Popover 显示 | true/false | false |
| markContent | String | 额外需要标注的内容 | ||
| renderHtml | Boolean | 额外需要标注的内容是否采用渲染 html 的格式 | true/false | false |
回调函数
| 函数名 | 说明 | 返回值 |
|---|---|---|
| onclickdate | 点击具体日期时的回调 | object，包含日期时间以及主动传递的 mark 值及是否当天有生日 isBirthday |
| onchangemonth | 点击具体日期时的回调 | object，包含点击按钮切换类型 type 及 day1(切换到相应月份的 1 号) |
| onChangeSlide | 日历展开关闭时的回调 | Boolean，(与配置 zoom 相同，默认是 false 为关闭) |
API
| 函数名 | 说明 | 参数格式 | 调用示例 |
|---|---|---|---|
| jumpToMonth(date) | 跳转到指定月份 | date 对象或 YYYY-MM-DD | this.$refs.cv.jumpToMonth("2020-03-12") |
| jumpToDay(date) | 跳转到指定日期并标记当前日 | date 对象或 YYYY-MM-DD | this.$refs.cv.jumpToDay("2020-03-12") |
| slideChange(Boolean) | 展开或关闭日历 | true 打开，false 关闭 | this.$refs.cv.slideChange(true) |
Other
1、后继会继续更新 vue3 版本
2、如果有其他问题邮件沟通1195669615@qq.com或者加 qq1195669615。若插件能够帮助到您，期待您的 star 哦！