Kalendae：JavaScript日期选择和日历控件使用

源码：http://github.com/ChiperSoft/Kalendae

demo：http://www.html5tricks.com/demo/Kalendae/index.html

Kalendae是一款完全基于JavaScript的日期选择控件和日历组件，值得一提的是，Kalendae并没有依赖任何第三方的JS脚本库，而是用原生的JavaScript实现了如此功能强大的日期选择控件。

Kalendae有以下特点：

• 完全基于JavaScript，无依赖，无jQuery。
• 可自定义皮肤，基本不用图片，完全靠CSS文件定制皮肤。
• 日期选择支持单天，也支持多天区间范围。
• 自定义展示的日期数字。
• 可直接放在页面上用作日历控件。
• 对于选中的日期，可以自定义日期格式。
• 提供一些常用的日期转换函数。

如何使用

导入对应的javascript和CSS：

<span style="font-size:14px;"><link rel="stylesheet" href="build/kalendae.css" type="text/css" charset="utf-8">
<script src="build/kalendae.js" type="text/javascript" charset="utf-8"></script> </span>

针对不同的使用环境设置，如下：

单日期选择

<span style="font-size:14px;">new Kalendae(document.body, {
    months:1,
    mode:'single',
    selected:Kalendae.moment().subtract({M:1})
});

new Kalendae({
    attachTo:document.body,
    months:2,
    mode:'single',
    selected:Kalendae.moment().subtract({M:1})
});

new Kalendae({
    attachTo:document.body,
    months:3,
    mode:'single',
    selected:Kalendae.moment().subtract({M:1})
});</span>

日期范围选择

<span style="font-size:14px;">new Kalendae(document.body, {
    months:1,
    mode:'range',
    selected:[Kalendae.moment().subtract({M:1}), Kalendae.moment().add({M:1})]
});

new Kalendae({
    attachTo:document.body,
    months:2,
    mode:'range',
    selected:[Kalendae.moment().subtract({M:1}), Kalendae.moment().add({M:1})]
});

new Kalendae({
    attachTo:document.body,
    months:3,
    mode:'range',
    selected:[Kalendae.moment().subtract({M:1}), Kalendae.moment().add({M:1})]
});</span>

多日期选择

<span style="font-size:14px;">new Kalendae(document.body, {
    months:1,
    mode:'multiple',
    selected:[Kalendae.moment().subtract({M:1}), Kalendae.moment().add({M:1})]
});

new Kalendae({
    attachTo:document.body,
    months:2,
    mode:'multiple',
    selected:[Kalendae.moment().subtract({M:1}), Kalendae.moment().add({M:1})]
});

new Kalendae({
    attachTo:document.body,
    months:3,
    mode:'multiple',
    selected:[Kalendae.moment().subtract({M:1}), Kalendae.moment().add({M:1})]
});</span>

未来/过去日期显示，隔日选择/工作日选择

<span style="font-size:14px;">//direction
new Kalendae(document.body, {
    months:3,
    direction:'future'
});

//direction
new Kalendae(document.body, {
    months:3,
    direction:'past'
});

//blackout
new Kalendae(document.body, {
    blackout: function (date) {
        return Kalendae.moment(date).date() % 2; //blackout every other day
    }
});

//blackout AND direction
new Kalendae(document.body, {
    direction:'future',
    blackout: function (date) {
        return [1,0,0,0,0,0,1][Kalendae.moment(date).day()]; //blackout weekends
    }
});</span>

更多javascript请参考Demo。

指定HTML元素，只需要指定需要生成的元素的class为auto-kal即可。

<div class="auto-kal"></div>

或者使用input来生成弹出的日期选择 

<input type="text" class="auto-kal">

缺省不需要jQuery的支持，但是提供一个jQuery插件，如果你使用jQuery，可以使用如下方式来生成一个kalendae日期选择：

$(selector).kalendae(options);

主要选项

• attachTo：日期选择器绑定的元素
• format：处理如期字符串的格式
• mode：选择模式
• months：显示月份的个数
• weekStart：显示日期开始的周
• direction：过去(past)和未来(future)，任何(any)等
• directionScrolling：如果为true并且direction不是any，那么则不能查看direction以外的内容
• blackout：不允许查看的内容
• viewStartDate：定义第一个月的日期显示
• dateClassMap：由日期组织的key/value的css类