## z-calendar
这是一个支持滑动切换，自定义打卡日期，配置项丰富的日历组件。组件样式使用了sass所以需要项目先安装node-sass和sass-loader，如果已经安装可导入之后可直接使用,如果项目支持easycom那么不需要导入即可直接使用。
## 组件调用方式

1. 如果支持easycom组件模式的话那么可以在你需要的页面直接使用该组件  

*template*
```
<view>
 <z-calendar
      :firstDayOfWeek="1"
      v-model="checkDate"
      :dotDates="ondutys"
    ></z-calendar>
</view>
```
*script*
```
export default {
  data() {
    return {
      title: "Hello",
      checkDate: new Date(),
      ondutys: [{ date: "2021-10-11" }],
    };
  },
  onLoad() {},
  methods: {},
};
```
*注意*
通过v-model可以绑定当前选中日期的值，如果你不需要那么不用也可以

2.如果不支持easycom组件模式，那么在使用之前我们需要先将组件引入  
*script*

```
import ZCalendar from "../../components/z-calendar/z-calendar.vue";
export default {
  components: {
    ZCalendar,
  },
  data() {
    return {
      title: "Hello",
      checkDate: new Date(),
      ondutys: [{ date: "2021-10-11" }],
    };
  },
  onLoad() {},
  methods: {},
};
```

## 组件属性说明props

组件提供了很多自定义属性，比如第一天是显示周一还是周日，打卡日期，打卡日期圆点位置和颜色，控制按钮是否显示，是否允许滑动切换到月份，更多属性如下表。    


| 属性名 | 数据类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| timeFormatter | String | yyyy年MM月 | 头部日期月份格式化yyyy表示年，MM表示月 |
| touchSwitch | Boolean | true | 是否可以滑动切换月份 |
| showYearControl | Boolean | true | 是否显示上一年下一年控制按钮 |
| showMonthControl | Boolean | true |  是否显示上一月下一月控制按钮 |
| firstDayOfWeek | Number | 1 | 是从周一开始还是周日开始可选值[1,7] |
| dotDates | Array | [] | 打点日期列表是一个对象数组，对象中有一个属性是date如：[{date: '2021-10-11'}] ,date也可以是一个时间戳|
| dotPosition | Object | {top:10,right: 16} | 打点小圆点的位置 |
| dotColor | String | #faad14 | 打卡圆点的颜色 | 

## 组件属性说明props 
| 事件名 | 事件说明 |
| --- | --- |
| @on-selected | 选中日期改变时触发,返回值为选中日期的时间对象 |
|@month-change | 月份改变（年或者月改变）时触发,返回值为选中日期的时间对象，当月份或者年改变时默认选中日期为该月份1号

## TODO
- [ ] 增加周模式和月模式切换

## 联系
有问题可以在以下评论区评论，或者邮件wallowyou@outlook.com