113 lines
5.0 KiB
Markdown
113 lines
5.0 KiB
Markdown
|
## vue-calendar-component
|
||
|
|
|
||
|
|
* 基于 vue 2.0 开发的轻量，高性能日历组件
|
||
|
|
* 占用内存小，性能好，样式好看，可扩展性强
|
||
|
|
* 原生 js 开发，没引入第三方库
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
## Why
|
||
|
|
|
||
|
|
* Github 上很多点击弹出日历选择某个时间的组件，却没有找到单纯展示日历并且能点击获取时间的组件
|
||
|
|
* 少部分日历组件的占用内存过于大，对于日历这样简单的功能来说显然不够合理
|
||
|
|
|
||
|
|
## Demo
|
||
|
|
|
||
|
|
 [或者请用浏览器的手机模式查看](https://zwhgithub.github.io/vue-calendar/dist/#/)
|
||
|
|
|
||
|
|
## 效果
|
||
|
|
|
||
|
|
<img width="286" height="528" src="https://zwhgithub.github.io/vue-calendar/dist/WechatIMG4885.jpeg"/>
|
||
|
|
|
||
|
|
* 🎉 觉得好用给一个 star 哦~~ 🎉
|
||
|
|
|
||
|
|
## Install
|
||
|
|
|
||
|
|
```javascript
|
||
|
|
npm i vue-calendar-component --save
|
||
|
|
cnpm i vue-calendar-component --save //国内镜像
|
||
|
|
```
|
||
|
|
|
||
|
|
## [github地址](https://github.com/zwhGithub/vue-calendar) 详细文档
|
||
|
|
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
```javascript
|
||
|
|
//vue文件中引入
|
||
|
|
import Calendar from 'vue-calendar-component';
|
||
|
|
|
||
|
|
components: {
|
||
|
|
Calendar
|
||
|
|
}
|
||
|
|
<Calendar
|
||
|
|
v-on:choseDay="clickDay"
|
||
|
|
v-on:changeMonth="changeDate"
|
||
|
|
// v-on:isToday="clickToday"
|
||
|
|
// :markDate=arr // arr=['2018/4/1','2018/4/3'] 标记4月1日和4月3日 简单标记
|
||
|
|
//:markDateMore=arr // 多种不同的标记
|
||
|
|
// 第一个标记和第二个标记不能同时使用
|
||
|
|
// :agoDayHide='1514937600' //某个日期以前的不允许点击 时间戳10位
|
||
|
|
// :futureDayHide='1525104000' //某个日期以后的不允许点击 时间戳10位
|
||
|
|
// :sundayStart="true" //默认是周一开始 当是true的时候 是周日开始
|
||
|
|
></Calendar>
|
||
|
|
|
||
|
|
clickDay(data) {
|
||
|
|
console.log(data); //选中某天
|
||
|
|
},
|
||
|
|
changeDate(data) {
|
||
|
|
console.log(data); //左右点击切换月份
|
||
|
|
},
|
||
|
|
clickToday(data) {
|
||
|
|
console.log(data); //跳到了本月
|
||
|
|
}
|
||
|
|
|
||
|
|
// 多个标记示例
|
||
|
|
arr=[{date:'2018/4/1',className:"mark1"}, {date:'2018/4/13',className:"mark2"}];
|
||
|
|
//4月1 标记的className是mark1 根据class做出一些标记样式
|
||
|
|
```
|
||
|
|
|
||
|
|
### API
|
||
|
|
|
||
|
|
| 属性 | 说明 | 默认 | 是否必传 |
|
||
|
|
| :------------ | :----------------------------------------------------------------------------------------------------- | :----: | :------: |
|
||
|
|
| choseDay | 选中某天调用的方法，返回选中的日期 YY-MM-DD | 无 | 否 |
|
||
|
|
| changeMonth | 切换月份调用的方法，返回切换到某月的日期 YY-MM-DD | 无 | 否 |
|
||
|
|
| isToday | 切换月份的时候，如果切到当前月份，调用这个方法，返回当前月今天 | 无 | 否 |
|
||
|
|
| markDate | 如果需要某月的几天被标注，传当月的日期数组。如["2018/2/2","2018/2/6"]被会标注（相同的标记） | 空数组 | 否 |
|
||
|
|
| markDateMore | 需要不同的标记如上Usage 最后一行示例代码 | 空数组 | 否 |
|
||
|
|
| agoDayHide | 某个日期以前的不允许点击 时间戳长度是 10 位 | 0 | 否 |
|
||
|
|
| futureDayHide | 某个日期以后的不允许点击 时间戳长度是 10 位 | 很大 | 否 |
|
||
|
|
| sundayStart | 默认是周一开始 当是true的时候 是周日开始 | false | 否 |
|
||
|
|
| textTop | 日历头部的文字，默认是 [ '日','一', '二', '三', '四', '五', '六'] ，可以根据自己的需求进行不同的修改。 | --- | 否 |
|
||
|
|
|
||
|
|
```javascript
|
||
|
|
✅ 在 Calendar标签上添加 ref 属性, 暴露出三个方法可以 直接切换月份
|
||
|
|
例如: <Calendar ref="Calendar"></Calendar>
|
||
|
|
|
||
|
|
✅ this.$refs.Calendar.PreMonth(); //调用方法实现转到上个月
|
||
|
|
✅ this.$refs.Calendar.NextMonth(); //调用方法实现转到下个月
|
||
|
|
✅ this.$refs.Calendar.ChoseMonth('2018-12-12'); //调用方法实现转到某个月
|
||
|
|
✅ this.$refs.Calendar.ChoseMonth('2018-12-12',false); //跳转到18年12月12日 但是不选中当天
|
||
|
|
//第二个参数 false表示不选中日期 。
|
||
|
|
```
|
||
|
|
## 遇到错误---
|
||
|
|
- 遇到提示UglifyJs打包编译错误。
|
||
|
|
因为当前版本UglifyJs不知道编译es6
|
||
|
|
|
||
|
|
解决方法
|
||
|
|
**npm install --save-dev babel-preset-env** <br>
|
||
|
|
然后在根目录创建一个 .babelrc 文件
|
||
|
|
在输入,<br>
|
||
|
|
{
|
||
|
|
"presets": ["env"]
|
||
|
|
}
|
||
|
|
<br>保存 重新build就OK了
|
||
|
|
|
||
|
|
[babel-preset-env官方文档](https://github.com/babel/babel-preset-env)
|
||
|
|
## Other
|
||
|
|
|
||
|
|
* src 下面的 App.vue 有 demo 可以参考.
|
||
|
|
* 如果有其他问题或者版本上, 功能上不兼容的 邮件沟通 zwhcoder@gmail.com
|