萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 日曆控件插件開發完整教程

前言

雖然市面上有許多成熟的日期選擇器(如 datepicker、flatpickr),但理解如何從零構建一個 jQuery 日曆插件,有助於掌握插件開發模式、DOM 動態生成、事件委派、日期計算等核心技能。

插件架構設計

(function($, window) {
    'use strict';

    $.fn.calendar = function(options) {
        // 1. 參數檢查
        if (!this.length) {
            if (options && options.debug && window.console) {
                console.log("nothing select");
            }
            return this; // 鏈式調用
        }

        var self = $(this);

        // 2. 默認配置合併
        var defaults = {
            cssPath: '',           // 自定義 CSS 路徑
            eventName: 'click',    // 觸發事件
            onSelectDate: null,    // 選中回調
            autoClose: false       // 選中後自動關閉
        };
        var opts = $.extend(defaults, options);

        // 3. 當前日期基準
        var d = new Date();
        var _date = {
            year: d.getFullYear(),
            month: d.getMonth() + 1,
            day: d.getDate(),
            week: d.getDay()
        };

        // 4. 模板字符串(簡化版,完整版見下文)
        var calendarDiv = '<div id="calendar" class="cld_grid" style="display:none;z-index:100;">...</div>';

        // 5. 行為對象
        var calendarAction = {
            initAction: function() { ... },
            thisClick: function() { ... },
            inputChange: function() { ... },
            buttonChange: function() { ... },
            chooseDate: function() { ... },
            showCalendar: function() { ... }
        };

        // 6. 初始化
        calendarAction.initAction();

        return this;
    };
})(jQuery, window);

核心功能模組解析

動態模板生成

使用字符串拼接構建日曆 DOM 結構:年月導航、星期表頭、日期網格(6行×7列=42格,覆蓋任意月份)。

var calendarDiv = '<div id="calendar" class="cld_grid">';
calendarDiv += '<div class="cld_year_month">';
calendarDiv += '<span id="last-year"><</span>';
calendarDiv += '<span id="last-month"><</span>';
calendarDiv += '<input id="calendar_year" value="' + _date.year + '">';
calendarDiv += '<input id="calendar_month" value="' + _date.month + '">';
calendarDiv += '<span id="next-month">>>/span>';
calendarDiv += '<span id="next-year">>>/span>';
calendarDiv += '</div>';
// 星期表頭
calendarDiv += '<div class="cld_week_box">';
['日','一','二','三','四','五','六'].forEach(function(w, i) {
    calendarDiv += '<div class="header-day" data-index="' + i + '">' + w + '</div>';
});
calendarDiv += '</div>';
// 日期格子
calendarDiv += '<div class="days">';
for (var k = 0; k < 42; k++) {
    calendarDiv += '<div class="day"><span class="day-number"></span></div>';
}
calendarDiv += '</div></div>';

日期渲染核心算法

function init_day_numbers(year, month) {
    var firstDay = new Date(year, month - 1, 1).getDay(); // 本月1號是星期幾
    var daysInMonth = new Date(year, month, 0).getDate(); // 本月總天數
    var prevMonthDays = new Date(year, month - 1, 0).getDate(); // 上月天數

    $('.day').each(function(index) {
        var $span = $(this).find('.day-number');
        var dayNum = index - firstDay + 1;

        if (dayNum > 0 && dayNum <= daysInMonth) {
            // 本月日期
            $span.text(dayNum).data('date', year + '-' + month + '-' + dayNum);
            $(this).removeClass('prev-month next-month').addClass('current-month');
            if (dayNum === _date.day && month === _date.month && year === _date.year) {
                $(this).addClass('today');
            }
        } else if (dayNum <= 0) {
            // 上月尾部日期
            $span.text(prevMonthDays + dayNum).data('date', ...);
            $(this).addClass('prev-month');
        } else {
            // 下月開頭日期
            $span.text(dayNum - daysInMonth).data('date', ...);
            $(this).addClass('next-month');
        }
    });
}

事件綁定策略

  • 事件委派:在 #calendar 容器上綁定 click,通過 e.target 判斷操作類型(年月切換、日期選擇)
  • 輸入框驗證:年輸入 4 位數字、月輸入 1-12,非法則彈窗提示
  • 自動定位:showCalendar() 根據觸發元素位置計算彈層 top/left

使用範例

<input type="text" id="dateInput" readonly>

<script>
$('#dateInput').calendar({
    eventName: 'focus',           // 聚焦時彈出
    autoClose: true,              // 選中自動關閉
    onSelectDate: function(dateStr, $input) {
        $input.val(dateStr);      // 回填輸入框
        console.log('選中日期:', dateStr);
    }
});
</script>

擴展方向

  1. 範圍選擇:雙日曆聯動,支援開始/結束日期
  2. 禁用日期:disabledDates: ['2024-01-01', /^2024-02/] 正則/數組/函數
  3. 多語言:星期/月份文本國際化配置
  4. 主題系統:CSS 變量控制顏色、圓角、陰影
  5. 鍵盤導航:方向鍵切換日期、Enter 確認、Esc 關閉
  6. 無障礙 (a11y):ARIA 屬性、角色標識、焦點管理

現代化重構建議

  • 改用 ES6 Class 語法重構插件結構
  • 採用 document.createElement 替代字符串拼接,避免 XSS 風險
  • 使用 CustomEvent 替代回調函數,解耦組件通信
  • 引入 TypeScript 類型定義提升開發體驗
  • 考慮輸出 Web Component (<my-calendar>) 實現框架無關

結語

從零寫一個日曆插件是鍛煉前端功力的經典練習。它涵蓋了日期運算、DOM 操作、事件系統、插件架構、跨瀏覽器兼容等核心知識點。雖然生產環境建議使用成熟庫,但掌握其內部原理能讓你在定制化需求面前遊刃有餘。

copyright © 萬盛學電腦網 all rights reserved