雖然市面上有許多成熟的日期選擇器(如 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 判斷操作類型(年月切換、日期選擇)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>
disabledDates: ['2024-01-01', /^2024-02/] 正則/數組/函數document.createElement 替代字符串拼接,避免 XSS 風險CustomEvent 替代回調函數,解耦組件通信<my-calendar>) 實現框架無關從零寫一個日曆插件是鍛煉前端功力的經典練習。它涵蓋了日期運算、DOM 操作、事件系統、插件架構、跨瀏覽器兼容等核心知識點。雖然生產環境建議使用成熟庫,但掌握其內部原理能讓你在定制化需求面前遊刃有餘。