一、使用方法:
1. 在页面中引入flatpicker.css和flatpicker.js文件。
<link rel="stylesheet" type="text/css" href="/path/to/flatpickr.css">
<script src="/path/to/flatpickr.js"></script>
2. HTML代码:
<input class='flatpickr' data-enable-time='true' data-time_24hr='true' >
代码中的 data- 属性是可选的,也可以选择写在 js 初始化参数中,去掉 data- 就可以。
3. 初始化插件
document.getElementsByClassName("myClass").flatpickr({..config});
document.getElementById("myID").flatpickr(); // js 初始化方法
$(".calendar").flatpickr(); // jQuery 初始化方法
// 设置参数
$(".calendar").flatpickr({
enable-time: true,
time_24hr: true,
onClose: function(dateObj, dateStr, instance){
4. 该插件有三个回调函数:
onChange
function(dateObject, dateString, instance)
每次日期被选择的时候都触发该函数。
onOpen
function(dateObject, dateString, instance)
每次日历被打开时都会触发该函数。
onClose
function(dateObject, dateString, instance)
每次日历被关闭时都会触发该函数。
回调函数有三个参数,第一个是当前中国标准时间,格式为 Tue Feb 13 2018 00:00:00 GMT+0800 (中国标准时间),第二个是当前日期 2018-02-13,第三个则返回的是当前 flatpickr 对象:
就这样,然后我们就可以根据需要编写相应的操作。
这里举两个栗子:
1. 开始时间 —— 结束时间 对最大最小时间进行限制,达到联动的效果
html:
<div class="input-group">
<input type="text" id="datetimeStart" class="form-control" placeholder="起始日期">
<div class="input-group-addon clear-time-start">
<span class="glyphicon glyphicon-remove" aria-hidden="true"></span>
</div>
</div>
<div class="input-group"">
<input type="text" id="datetimeEnd" class="form-control" placeholder="结束日期">
<div class="input-group-addon clear-time-end">
<span class="glyphicon glyphicon-remove" aria-hidden="true"></span>
</div>
</div>
// 初始化 起始时间 和 结束时间
var time_start = $("#datetimeStart").flatpickr({
onClose: function(dateObj, dateStr, instance){
// doSomething
var time_end = $("#datetimeEnd").flatpickr({
onClose: function(dateObj, dateStr, instance){
// doSomething
// 时间限制
time_start.config.onChange = function (dateObj) {
time_end.set("minDate", dateObj.fp_incr(1));
time_end.config.onChange = function ( dateObj ) {
time_start.set("maxDate", dateObj.fp_incr(-1));
2. 看上面的代码有人可能注意到了,这里有一个清空的操作,我一开始用 flatpickr 的 demo 方法,就没有生效,然后我就手动清空了 input 的值,结果发现单纯清空 input的值并不能触发 onChange 回调函数,结果 input 是清空了,但是选择结束时间的时候对它的最小时间仍然有限制,也就是说对 flatpickr 时间选择器 来说 开始时间依然存在,并没有得到通知说开始时间清空了。
然后我尝试了一些办法发现 flatpickr 是有自己的清除机制的,就是 clear 方法:
// 开始日期清空
$('.clear-time-start').click(function () {
time_start.clear();
这样会触发 onChange 回调,但是这个时候回调的参数 dateObj 的参数会变成 null,所以在对时间限制的地方要判断一下。
因为我之前发现这个问题没找到答案,所以在这里记录一下,希望能帮到你,这个方法不算好,但也算是一个思路。
下面附一个 参数表 。
配置参数表
在配置参数中,所有的类型为string或boolean的参数都可以通过data-属性在HTML标签中进行设置。例如:data-min-date、data-default-date、data-default-date等。