e-calendar 是一個事件日曆插件,可針對指定日期自定義日程安排且不限條數,有日程的日期會高亮顯示,兼容 IE7 及主流瀏覽器。本文介紹的升級版在原版基礎上做了八處改進。
1. 同一天可存在多個事件交集;
2. 點擊日期後在日曆下方展開當日日程列表;
3. 點擊日程列表可觸發自定義事件;
4. 增加 item-grid 的顯示與隱藏;
5. Events 數組支持 id、type 等字段,用以區分日程類型(任務型或預約型);
6. 增加年份與月份下拉選擇,不必逐月翻頁;
7. 樣式整體調整;
8. 把 ajax 加載事件、item 點擊事件等以配置項形式暴露給調用方。
原版效果(滑鼠移到日期上顯示當天日程):

升級版運行效果:

<!DOCTYPE html>
<html>
<head lang="en">
<meta charset="UTF-8">
<title>e-calendar</title>
<link rel="stylesheet" href="css/jquery.e-calendar.css" />
<script src="js/jquery-1.11.0.min.js"></script>
<script type="text/javascript" src="js/jquery.e-calendar.js"></script>
<script type="text/javascript">
$(document).ready(function () {
$('#calendar').eCalendar({
yearRange: ['2015', '2016', '2017', '2018', '2019', '2020', '2021'], // 年下拉框範圍
weekDays: ['日', '一', '二', '三', '四', '五', '六'],
months: ['一月', '二月', '三月', '四月', '五月', '六月',
'七月', '八月', '九月', '十月', '十一月', '十二月'],
eventTitle: '日程列表',
// 數據初始化:日曆加載時回調,在此處取數
initData: function (settings, month) {
// 數據格式要求:
// settings.events = [
// { id: "a1", type: "calendar", title: '222',
// description: '日程', datetime: new Date(2016, 0, 15, 17) }
// ];
settings.events = [];
if (month) {
var sourse = [];
$.ajax({
type: "POST",
data: { month: month },
async: false,
url: "/Calendar/GetHomeCalendar?t=" + new Date().getMilliseconds(),
success: function (data) {
var result = JSON.parse(data);
for (var i = 0; i < result.length; i++) {
sourse.push({
id: result[i].Id,
type: result[i].Type,
title: result[i].Title,
description: result[i].Description,
datetime: new Date(result[i].Datetime)
});
}
settings.events = sourse;
},
error: function () {}
});
}
},
// 日程項目的點擊事件
clickItem: function () {
var id = $(this).attr("cid");
var type = $(this).attr("ctype");
alert("點擊 id:" + id + "\r\n 類型:" + type);
}
});
});
</script>
</head>
<body>
<h1 style="text-align:center;">e-calendar</h1>
<div id="calendar"></div>
</body>
</html>
核心配置項有四個:yearRange(年下拉框範圍)、months(月下拉框文字)、initData(數據初始化函數,在此發請求並填充 settings.events)、clickItem(日程列表點擊事件)。
/**
* e-Calendar v2.0.0
*/
(function ($) {
var dMonth = new Date().getMonth();
var dYear = new Date().getFullYear();
var eCalendar = function (options, object) {
// 全域狀態
var adDay = new Date().getDate();
var adMonth = new Date().getMonth();
var adYear = new Date().getFullYear();
var dDay = adDay;
var instance = object;
var settings = $.extend({}, $.fn.eCalendar.defaults, options);
// 左補零,用於日期與時間格式化
function lpad(value, length, pad) {
if (typeof pad == 'undefined') { pad = '0'; }
var p = '';
for (var i = 0; i < length; i++) { p += pad; }
return (p + value).slice(-length);
}
var mouseOver = function () { $(this).addClass('c-nav-btn-over'); };
var mouseLeave = function () { $(this).removeClass('c-nav-btn-over'); };
// 關閉日程列表
var onItemGridClose = function () {
$(".c-event-grid").css("display", "none");
};
// 滑過日期:高亮當天與對應日程
var mouseOverEvent = function () {
$(this).addClass('c-event-over');
var d = $(this).attr('data-event-day');
$('div.c-event-item[data-event-day="' + d + '"]').addClass('c-event-over');
};
// 點擊日期:展開當天日程列表
var mouseClickEvent = function () {
$(".c-event-grid").css("display", "");
$('div.c-day').removeClass('c-event-over');
$('div.c-event-item').removeClass('c-event-over');
$(this).addClass('c-event-over');
var d = $(this).attr('data-event-day');
$('div.c-event-item[data-event-day="' + d + '"]').addClass('c-event-over');
};
var mouseLeaveEvent = function () { };
var mouseClickItem = settings.clickItem; // 對外暴露的點擊回調
var mouseOverItem = function () { $(this).addClass('c-event-over-item'); };
var mouseLeaveItem = function () { $(this).removeClass('c-event-over-item'); };
// 翻月
var nextMonth = function () {
if (dMonth < 11) { dMonth++; } else { dMonth = 0; dYear++; }
init_eCalendar();
loadeCalendarByAjax(settings, dYear + "-" + (dMonth + 1));
};
var previousMonth = function () {
if (dMonth > 0) { dMonth--; } else { dMonth = 11; dYear--; }
init_eCalendar();
loadeCalendarByAjax(settings, dYear + "-" + (dMonth + 1));
};
// 年月下拉
var selectYear = function () {
dYear = $("#selYears").val();
init_eCalendar();
loadeCalendarByAjax(settings, dYear + "-" + (dMonth + 1));
};
var selectMonth = function () {
dMonth = $("#selMonths").val();
init_eCalendar();
loadeCalendarByAjax(settings, dYear + "-" + (dMonth + 1));
};
function loadEvents() {
if (typeof settings.initData != 'undefined' && settings.initData) {
loadeCalendarByAjax(settings, dYear + "-" + (dMonth + 1));
}
}
// 交給調用方去取數據
function loadeCalendarByAjax(settings, ajaxMonth) {
if (typeof settings.initData != 'undefined') {
settings.initData(settings, ajaxMonth);
}
}
function init_eCalendar() {
loadEvents();
var dWeekDayOfMonthStart = new Date(dYear, dMonth, 1).getDay(); // 1號是星期幾
var dLastDayOfMonth = new Date(dYear, dMonth + 1, 0).getDate(); // 本月天數
var dLastDayOfPreviousMonth = new Date(dYear, dMonth + 1, 0).getDate()
- dWeekDayOfMonthStart + 1; // 上月需補的天數起點
var cBody = $('<div/>').addClass('c-grid');
var cEvents = $('<div/>').addClass('c-event-grid');
cEvents.css("display", "none"); // 默認隱藏日程列表
var cEventsBody = $('<div/>').addClass('c-event-body');
cEvents.append($('<div/>').addClass('c_title_sj').html(settings.eventTitle));
// 關閉按鈕
var itemClose = $('<div/>').addClass('c-close-top')
.append($('<a/>').attr("href", "javascript:void(0)")
.on('click', onItemGridClose)
.html('<img src="img/calendar_delete_icon.png">'));
cEvents.append(itemClose);
cEvents.append(cEventsBody);
// 頂部導航
var cTitle = $('<div/>').addClass('top_calendar_div');
var cYear = $('<div/>').addClass('c_years');
var cMonth = $('<div/>').addClass('c_months');
var cPage = $('<div/>').addClass('c_pages');
// 年下拉
var year_sel = document.createElement("select");
year_sel.setAttribute("id", "selYears");
var yearRanges = settings.yearRange || [dYear];
for (var i = 0; i < yearRanges.length; i++) {
year_sel.options.add(new Option(yearRanges[i], yearRanges[i]));
}
year_sel.onchange = function () { selectYear(); };
for (var i = 0; i < year_sel.options.length; i++) {
if (year_sel.options[i].innerHTML == dYear) {
year_sel.options[i].selected = true;
break;
}
}
// 月下拉
var month_sel = document.createElement("select");
month_sel.setAttribute("id", "selMonths");
var monthRanges = settings.months || [];
for (var i = 0; i < monthRanges.length; i++) {
month_sel.options.add(new Option(monthRanges[i], i));
}
month_sel.onchange = function () { selectMonth(); };
for (var i = 0; i < month_sel.options.length; i++) {
if (month_sel.options[i].innerHTML == monthRanges[dMonth]) {
month_sel.options[i].selected = true;
break;
}
}
var cPrevious = $('<a/>').attr("href", "javascript:void(0)")
.on('click', previousMonth).html('<img src="img/page_left.png">');
var cNext = $('<a/>').attr("href", "javascript:void(0)")
.on('click', nextMonth).html('<img src="img/page_right.png">');
cYear.html(year_sel);
cMonth.html(month_sel);
cPage.append(cPrevious).append(cNext);
cTitle.append(cYear).append(cMonth).append(cPage);
cBody.append(cTitle);
// 星期表頭
for (var i = 0; i < settings.weekDays.length; i++) {
cBody.append($('<div/>').addClass('c-week-day c-pad-top').html(settings.weekDays[i]));
}
// 42 格日期矩陣
var day = 1, dayOfNextMonth = 1;
for (var i = 0; i < 42; i++) {
var cDay = $('<div/>');
if (i < dWeekDayOfMonthStart) {
// 上月補位
cDay.addClass('c-day-previous-month c-pad-top').html(dLastDayOfPreviousMonth++);
} else if (day <= dLastDayOfMonth) {
cDay.addClass('c-day c-pad-top');
if (day == dDay && adMonth == dMonth && adYear == dYear) {
cDay.addClass('c-today'); // 今天
}
// 有事件的日期加標記並綁定交互
for (var j = 0; j < settings.events.length; j++) {
var d = settings.events[j].datetime;
if (d.getDate() == day && d.getMonth() == dMonth && d.getFullYear() == dYear) {
cDay.addClass('c-event').attr('data-event-day', d.getDate());
cDay.on('click', mouseClickEvent).on('mouseleave', mouseLeaveEvent);
}
}
cDay.html(day++);
} else {
// 下月補位
cDay.addClass('c-day-next-month c-pad-top').html(dayOfNextMonth++);
}
cBody.append(cDay);
}
// 日程列表
var eventList = $('<div/>').addClass('c-event-list');
for (var i = 0; i < settings.events.length; i++) {
var d = settings.events[i].datetime;
if (d.getMonth() == dMonth && d.getFullYear() == dYear) {
var date = lpad(d.getDate(), 2) + '/' + lpad(d.getMonth() + 1, 2) + ' '
+ lpad(d.getHours(), 2) + ':' + lpad(d.getMinutes(), 2);
// cid / ctype 掛在 div 上,供點擊時讀取
var item = $('<div/>').addClass('c-event-item')
.attr("cid", settings.events[i].id)
.attr("ctype", settings.events[i].type)
.attr("title", settings.events[i].description)
.attr('data-event-day', d.getDate());
item.on('mouseover', mouseOverItem).on('mouseleave', mouseLeaveItem);
item.append($('<div/>').addClass('title').html(settings.events[i].title))
.append($('<div/>').addClass('description').html(settings.events[i].description));
item.on('click', mouseClickItem);
eventList.append(item);
}
}
$(instance).addClass('calendar');
cEventsBody.append(eventList);
$(instance).html(cBody).append(cEvents);
}
return init_eCalendar();
};
$.fn.eCalendar = function (oInit) {
return this.each(function () {
return eCalendar(oInit, $(this));
});
};
// 插件默認配置
$.fn.eCalendar.defaults = {
weekDays: ['Dom', 'Seg', 'Ter', 'Qua', 'Qui', 'Sex', 'Sab'],
months: ['Janeiro', 'Fevereiro', 'Março', 'Abril', 'Maio', 'Junho',
'Julho', 'Agosto', 'Setembro', 'Outubro', 'Novembro', 'Dezembro'],
textArrows: { previous: '<', next: '>' },
eventTitle: 'Eventos',
url: '',
events: []
};
}(jQuery));
每條日程是一個對象,字段含義如下:id(唯一標識,會寫入 DOM 的 cid 屬性)、type(日程類型,寫入 ctype)、title(列表標題)、description(描述,作為 title 屬性滑過顯示)、datetime(Date 對象,決定出現在哪一天)。
initData 裡用了 async: false。同步請求會阻塞主線程,建議改為異步,並在 success 中重新渲染;或更好的做法是把數據獲取與渲染分離,插件只負責畫,取數交給外部。
title 與 description 用了 html() 拼接。若日程內容來自用戶輸入,存在 XSS 風險,應改用 .text()。
yearRange 寫死為 2015–2021。實用中建議動態生成,例如以當前年份為中心前後各取五年。
日期矩陣固定 42 格。這會讓所有月份都佔六行,視覺整齊但偶爾多出一整行空白;若想更緊湊,可按 Math.ceil((起始偏移 + 本月天數) / 7) 動態計算行數。
id 選擇器全局唯一。插件中大量使用 $("#selYears") 這類固定 id,若同一頁面放置兩個日曆實例會互相干擾,多實例場景需改為相對於 instance 查找。