web-calendar-js

一个js日历插件（A js calendar plugin ）

中文文档

注意事项

• 兼容 IE8+ (不包括IE8)
• 本日历插件年份范围在1900年—— 2100年

安装

1. 第一种方式，直接引入

• 引入js

<script src="https://webxiaoma.github.io/web-calendar-js/lib/js/calendar.min.js"></script>

• 引入css

<link rel="stylesheet" href="https://webxiaoma.github.io/web-calendar-js/lib/static/css/calendar.min.css">

推荐下载到本地使用，在 [web-calendar-js] 中 的 lib目录中引入相应的js以及css

2. 第二种方式

使用安装npm下载

npm install --save-dev web-calendar-js

或

npm i -D web-calendar-js

基本用法

var cal = new Calendar(el,options)

• el: input元素的id或class,推荐使用id；
• options: 日历插件的配置，各项配置见下表；

Options 属性

| 属性 | 说明 | 类型 | 可选值 | 默认值 | | ------ | ------ | ------ |:------:|:------:|
| format | 年月日之间的分隔符 | String | —— | - | | isFillZero | 单月份和单日前是否补0 | Boolean | —— | true | | max | 可选择的最大时间 | String/Number | 时间格式如(2019-2-1、2019/2/1、时间戳) | true | | min | 可选择的最小时间 | String/Number | 时间格式如(2019-2-1、2019/2/1、时间戳) | true | | nextMonthBtnText | 上一年按钮文本 | String | —— | << | | nextYearBtnName | 下一年按钮文本 | String | —— | >> | | prevMonthBtnName | 上一月按钮文本 | String | —— | <| | nextMonthBtnName | 下一月按钮文本 | String | —— | > | | isHoliday | 是否在周六周日时显示休息字眼 | Boolean | —— | true | | isLunar | 是否显示阴历 | Boolean | —— | true | | isFestival | 是否显示节日（当显示阴历时，才会起作用） | Boolean | —— | true | | isSolarTerm | 是否显示节气（当显示阴历时，才会起作用） | Boolean | —— | true |

Options 事件

| 事件 | 说明 | 回调参数 | | ------ | ------ | ------ | | click | 选择日期时触发 | 返回日期对象day，日期对象中含有日期信息dayMsg | | change | 日期更改时触发 | 返回包含年月日等信息的对象 | | rightHandClick | 右击日期时触发 | 返回日期对象day |

Options 方法

| 方法 | 说明 | 参数 | | ------ | ------ | ------ | | beforeCreateDay | 日期天数创建前钩子函数 | 返回日期对象day | | afterCreateDay | 日期天数创建后钩子函数 | 返回日期对象day |

其它对象说明

dayMsg对象

• Animal: 当年的生肖属性
• IDayCn: "二十"
• IMonthCn: "十月"
• LFtv: 阴历常见节日（默认null）
• SFtv: 阳历历常见节日（默认null）
• Term: 二十四节气
• astro: 当日星座
• cDay: 阳历日
• cMonth: 阳历月份（1-12）
• cYear: 阳历年份
• gzDay: 干支纪天
• gzMonth: 干支纪月
• gzYear: 干支纪年
• isLeap: 是否是闰年，boolean值
• isTerm: 当时是否是二十四节气，boolean值
• isToday: 当前阳历日期是否就是今日，boolean值
• lDay: 阴历号
• lMonth: 阴历月份
• lYear: 阴历年份
• nWeek: 数字星期（1-7）
• ncWeek: 字符串星期