DIV CSS 佈局教程網

jQuery 日曆插件 e-calendar 升級版:多事件、日程列表與年月選擇
編輯:JQuery入門技巧     

e-calendar 是一個事件日曆插件,可針對指定日期自定義日程安排且不限條數,有日程的日期會高亮顯示,兼容 IE7 及主流瀏覽器。本文介紹的升級版在原版基礎上做了八處改進。

升級版新增能力

1. 同一天可存在多個事件交集;
2. 點擊日期後在日曆下方展開當日日程列表;
3. 點擊日程列表可觸發自定義事件;
4. 增加 item-grid 的顯示與隱藏;
5. Events 數組支持 id、type 等字段,用以區分日程類型(任務型或預約型);
6. 增加年份與月份下拉選擇,不必逐月翻頁;
7. 樣式整體調整;
8. 把 ajax 加載事件、item 點擊事件等以配置項形式暴露給調用方。

原版效果(滑鼠移到日期上顯示當天日程):

升級版運行效果:

調用方式:index.html

<!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(日程列表點擊事件)。

插件主體:jquery.e-calendar.js

/**
 * 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 查找。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved