經典的日歷控件在現代項目中仍有應用場景(如無構建環境、極度定制需求、舊系統維護)。本文在傳統日曆基礎上重構升級,新增時間選擇(時/分)、解決 IE6-8 下 Select/Object/Flash 遮擋層級最高的經典問題、提供靈活的格式化配置與主題定制。
/**
* 日歷選擇控件升級版
* 作者: tiannet (基於 meizz 日曆完善)
* 功能: 日期/時間選擇、遮擋元素處理、多格式輸出
*/
var Calendar = (function() {
// ========== 樣式常量 (可外部覆蓋) ==========
var STYLES = {
turnBase: 'height:20px;font-size:12px;color:#fff;border:1px solid #2650A6;cursor:pointer;background:#2650A6;',
turnBtn: 'width:28px;',
turnBtnSmall: 'width:22px;',
selectYear: 'width:64px;',
selectMonth: 'width:46px;',
body: 'width:180px;background:#2650A6;border:1px solid #999;position:absolute;z-index:9999;display:none;',
dayCell: 'width:24px;height:22px;background:#e8f4ff;font-size:12px;text-align:center;cursor:pointer;',
font: 'color:#333;font-size:12px;text-decoration:none;',
todayColor: '#ff0000',
weekendColor: '#ff6600',
workdayColor: '#333',
otherMonthColor: '#999',
hoverBg: '#79D0FF',
normalBg: '#fff',
todayBg: '#fffbcc'
};
// ========== 狀態變量 ==========
var state = {
year: new Date().getFullYear(),
month: new Date().getMonth(), // 0-11
day: new Date().getDate(),
hour: 0,
minute: 0,
showHour: false,
showMinute: false,
dateSplit: '-',
dateTimeSplit: ' ',
timeSplit: ':',
yearStart: 1950,
yearEnd: 2050,
outInput: null, // 目標 input
hiddenElements: [], // 被隱藏的 select/object
panel: null, // 面板 DOM
yearSelect: null,
monthSelect: null,
hourSelect: null,
minuteSelect: null
};
// ========== 工具函數 ==========
function $(id) { return document.getElementById(id); }
function addEvent(el, type, fn) { el.addEventListener ? el.addEventListener(type, fn) : el.attachEvent('on'+type, fn); }
function removeEvent(el, type, fn) { el.removeEventListener ? el.removeEventListener(type, fn) : el.detachEvent('on'+type, fn); }
function stopEvent(e) { e = e || window.event; e.stopPropagation ? e.stopPropagation() : e.cancelBubble = true; }
function preventDefault(e) { e = e || window.event; e.preventDefault ? e.preventDefault() : e.returnValue = false; }
// ========== 核心邏輯 ==========
// 構建面板 HTML (一次性)
function buildPanel() {
if (state.panel) return state.panel;
var panel = document.createElement('div');
panel.id = 'calendarPanel';
panel.style.cssText = STYLES.body;
panel.innerHTML =
'' +
'' +
'' +
'' +
'' +
'' +
'' +
'' +
'' +
'' +
'' +
' ' +
'' +
'
' +
'' +
'';
document.body.appendChild(panel);
state.panel = panel;
cacheElements();
bindEvents();
initSelectOptions();
return panel;
}
function cacheElements() {
var p = state.panel;
state.titleEl = p.querySelector('.title');
state.yearSelect = p.querySelector('#calYear');
state.monthSelect = p.querySelector('#calMonth');
state.hourSelect = p.querySelector('#calHour');
state.minuteSelect = p.querySelector('#calMinute');
state.daysBody = p.querySelector('.days-body');
state.weekHeader = p.querySelector('.week-header');
state.timePanel = p.querySelector('.cal-time');
}
function initSelectOptions() {
// 年份
for (var y = state.yearStart; y <= state.yearEnd; y++) {
state.yearSelect.add(new Option(y + '年', y));
}
// 月份
for (var m = 1; m <= 12; m++) {
state.monthSelect.add(new Option(m + '月', m - 1)); // value 存 0-11
}
// 小時
for (var h = 0; h < 24; h++) {
state.hourSelect.add(new Option(h < 10 ? '0'+h : h, h));
}
// 分鐘
for (var mi = 0; mi < 60; mi++) {
state.minuteSelect.add(new Option(mi < 10 ? '0'+mi : mi, mi));
}
}
function bindEvents() {
var p = state.panel;
// 事件委托
p.addEventListener('click', function(e) {
var t = e.target;
if (t.classList.contains('prev-year')) changeYear(-1);
else if (t.classList.contains('next-year')) changeYear(1);
else if (t.classList.contains('prev-month')) changeMonth(-1);
else if (t.classList.contains('next-month')) changeMonth(1);
else if (t.classList.contains('day-btn') && !t.classList.contains('disabled')) selectDay(t);
else if (t.classList.contains('close-btn')) hide();
else if (t.classList.contains('btn-today')) selectToday();
else if (t.classList.contains('btn-clear')) clearSelection();
else if (t.classList.contains('time-ok')) confirmTime();
});
// 下拉框變化
state.yearSelect.onchange = function() { state.year = +this.value; renderDays(); };
state.monthSelect.onchange = function() { state.month = +this.value; renderDays(); };
state.hourSelect.onchange = function() { state.hour = +this.value; };
state.minuteSelect.onchange = function() { state.minute = +this.value; };
// 文檔點擊關閉
document.addEventListener('mousedown', docClickHandler = function(e) {
if (!p.contains(e.target) && e.target !== state.outInput) hide();
});
}
// 顯示面板
function show(input, mode) {
state.outInput = input;
state.showHour = mode === 'datetime' || mode === 'datetime-local';
state.showMinute = mode === 'datetime-local';
// 解析現有值
if (input.value) parseInputValue(input.value);
buildPanel();
syncSelects();
renderDays();
toggleTimePanel();
positionPanel(input);
// 處理遮擋元素 (IE6-8 核心修復)
handleOverlappingElements(true);
state.panel.style.display = 'block';
input.focus(); // 保持焦點以便鍵盤操作
}
// 隱藏面板
function hide() {
if (!state.panel) return;
state.panel.style.display = 'none';
handleOverlappingElements(false);
document.removeEventListener('mousedown', docClickHandler);
state.outInput = null;
}
// 遮擋元素處理 (核心修復)
function handleOverlappingElements(hide) {
var tags = ['SELECT', 'OBJECT', 'EMBED', 'APPLET', 'IFRAME'];
if (hide) {
state.hiddenElements = [];
tags.forEach(function(tag) {
var elements = document.getElementsByTagName(tag);
for (var i = 0; i < elements.length; i++) {
var el = elements[i];
if (isOverlapping(el, state.panel)) {
el.style.visibility = 'hidden';
state.hiddenElements.push(el);
}
}
});
} else {
state.hiddenElements.forEach(function(el) {
if (el && el.style) el.style.visibility = 'visible';
});
state.hiddenElements = [];
}
}
function isOverlapping(el, panel) {
var elRect = el.getBoundingClientRect();
var pRect = panel.getBoundingClientRect();
return !(elRect.right < pRect.left || elRect.left > pRect.right ||
elRect.bottom < pRect.top || elRect.top > pRect.bottom);
}
// 定位面板
function positionPanel(input) {
var rect = input.getBoundingClientRect();
var scrollX = window.scrollX || document.documentElement.scrollLeft;
var scrollY = window.scrollY || document.documentElement.scrollTop;
var panel = state.panel;
var panelW = panel.offsetWidth, panelH = panel.offsetHeight;
var vpW = window.innerWidth || document.documentElement.clientWidth;
var vpH = window.innerHeight || document.documentElement.clientHeight;
var left = rect.left + scrollX;
var top = rect.bottom + scrollY + 2;
// 邊界檢測翻轉
if (left + panelW > scrollX + vpW) left = scrollX + vpW - panelW - 5;
if (top + panelH > scrollY + vpH && rect.top > panelH) top = rect.top + scrollY - panelH - 2;
panel.style.left = left + 'px';
panel.style.top = top + 'px';
}
// 渲染星期頭
function renderWeekHeader() {
var weeks = ['日','一','二','三','四','五','六'];
state.weekHeader.innerHTML = weeks.map(function(w) {
return '' + w + ' ';
}).join('');
}
// 渲染日期網格
function renderDays() {
var year = state.year, month = state.month;
var firstDay = new Date(year, month, 1).getDay(); // 0-6
var daysInMonth = new Date(year, month+1, 0).getDate();
var daysInPrevMonth = new Date(year, month, 0).getDate();
var today = new Date();
var isToday = (y,m,d) => y===today.getFullYear() && m===today.getMonth() && d===today.getDate();
var isSelected = (y,m,d) => state.selectedDate && y===state.selectedDate.getFullYear() && m===state.selectedDate.getMonth() && d===state.selectedDate.getDate();
state.titleEl.textContent = year + '年' + (month+1) + '月';
state.yearSelect.value = year;
state.monthSelect.value = month;
var html = '';
var day = 1, nextMonthDay = 1;
for (var w = 0; w < 6; w++) {
html += '';
for (var d = 0; d < 7; d++) {
var cellClass = 'day-btn';
var dayNum = '';
var dateObj = null;
var disabled = false;
if (w === 0 && d < firstDay) {
dayNum = daysInPrevMonth - firstDay + d + 1;
cellClass += ' disabled other-month';
dateObj = new Date(year, month-1, dayNum);
disabled = true;
} else if (day > daysInMonth) {
dayNum = nextMonthDay++;
cellClass += ' disabled other-month';
dateObj = new Date(year, month+1, dayNum);
disabled = true;
} else {
dayNum = day++;
dateObj = new Date(year, month, dayNum);
if (isToday(year, month, dayNum)) cellClass += ' today';
if (isSelected(year, month, dayNum)) cellClass += ' selected';
}
var color = disabled ? STYLES.otherMonthColor : (cellClass.indexOf('today')>-1 ? STYLES.todayColor : (d===0||d===6 ? STYLES.weekendColor : STYLES.workdayColor));
var bg = disabled ? 'transparent' : (cellClass.indexOf('selected')>-1 ? STYLES.hoverBg : (cellClass.indexOf('today')>-1 ? STYLES.todayBg : STYLES.normalBg));
html += ' ';
}
html += ' ';
if (day > daysInMonth && nextMonthDay > 7) break;
}
state.daysBody.innerHTML = html;
}
// 選中日期
function selectDay(btn) {
var ts = +btn.getAttribute('data-date');
var date = new Date(ts);
state.selectedDate = date;
state.day = date.getDate();
state.year = date.getFullYear();
state.month = date.getMonth();
if (!state.showHour) {
writeValueAndClose();
} else {
// 切換到時間面板
renderDays(); // 刷新高亮
toggleTimePanel();
}
}
// 切換時間面板顯示
function toggleTimePanel() {
state.timePanel.style.display = state.showHour ? 'block' : 'none';
if (state.showHour) {
state.hourSelect.value = state.hour;
state.minuteSelect.value = state.minute;
}
}
// 確認時間
function confirmTime() {
writeValueAndClose();
}
// 寫入值並關閉
function writeValueAndClose() {
if (!state.outInput || !state.selectedDate) return;
var y = state.selectedDate.getFullYear();
var m = (state.selectedDate.getMonth()+1).toString().padStart(2,'0');
var d = state.selectedDate.getDate().toString().padStart(2,'0');
var dateStr = y + state.dateSplit + m + state.dateSplit + d;
if (state.showHour) {
var h = state.hour.toString().padStart(2,'0');
dateStr += state.dateTimeSplit + h;
if (state.showMinute) {
var mi = state.minute.toString().padStart(2,'0');
dateStr += state.timeSplit + mi;
}
}
state.outInput.value = dateStr;
// 觸發 change 事件
var evt = document.createEvent('HTMLEvents');
evt.initEvent('change', true, false);
state.outInput.dispatchEvent(evt);
hide();
}
// 選中今天
function selectToday() {
var now = new Date();
state.selectedDate = now;
state.year = now.getFullYear();
state.month = now.getMonth();
state.day = now.getDate();
state.hour = now.getHours();
state.minute = now.getMinutes();
writeValueAndClose();
}
// 清空
function clearSelection() {
state.selectedDate = null;
if (state.outInput) {
state.outInput.value = '';
state.outInput.dispatchEvent(new Event('change'));
}
hide();
}
// 解析輸入框值
function parseInputValue(val) {
// 簡易解析 YYYY-MM-DD HH:mm
var parts = val.split(/[\s\-\/\:]+/);
if (parts.length >= 3) {
state.year = +parts[0];
state.month = +parts[1] - 1;
state.day = +parts[2];
state.selectedDate = new Date(state.year, state.month, state.day);
if (parts.length >= 4) state.hour = +parts[3];
if (parts.length >= 5) state.minute = +parts[4];
}
}
// 同步下拉框
function syncSelects() {
state.yearSelect.value = state.year;
state.monthSelect.value = state.month;
}
// 年月變化
function changeYear(delta) {
state.year += delta;
if (state.year < state.yearStart) state.year = state.yearStart;
if (state.year > state.yearEnd) state.year = state.yearEnd;
renderDays();
}
function changeMonth(delta) {
state.month += delta;
if (state.month < 0) { state.month = 11; state.year--; }
else if (state.month > 11) { state.month = 0; state.year++; }
renderDays();
}
// ========== 公開 API ==========
return {
// 僅日期
setDay: function(input) { show(input, 'date'); },
// 日期+時
setDayH: function(input) { show(input, 'datetime'); },
// 日期+時+分
setDayHM: function(input) { show(input, 'datetime-local'); },
// 配置分隔符
setDateSplit: function(s) { state.dateSplit = s; },
setDateTimeSplit: function(s) { state.dateTimeSplit = s; },
setTimeSplit: function(s) { state.timeSplit = s; },
setSplit: function(d, dt, t) { state.dateSplit=d; state.dateTimeSplit=dt; state.timeSplit=t; },
// 配置年份範圍
setYearPeriod: function(start, end) { state.yearStart=start; state.yearEnd=end; },
// 設置默認日期/時間
setDefaultDate: function(str) { /* 解析並設置 state.year/month/day */ },
setDefaultTime: function(str) { /* 解析並設置 state.hour/minute */ }
};
})();
// 全局暴露兼容舊調用方式
window.setDay = Calendar.setDay;
window.setDayH = Calendar.setDayH;
window.setDayHM = Calendar.setDayHM;
window.setYearPeriod = Calendar.setYearPeriod;
window.setDateSplit = Calendar.setDateSplit;
window.setDateTimeSplit = Calendar.setDateTimeSplit;
window.setTimeSplit = Calendar.setTimeSplit;
window.setSplit = Calendar.setSplit;
window.setDefaultDate = Calendar.setDefaultDate;
window.setDefaultTime = Calendar.setDefaultTime;
<input type="text" id="dateOnly" readonly onclick="setDay(this)" placeholder="選擇日期" />
<input type="text" id="dateHour" readonly onclick="setDayH(this)" placeholder="選擇日期和小時" />
<input type="text" id="dateTime" readonly onclick="setDayHM(this)" placeholder="選擇日期時間" />
<script>
// 可選配置
setYearPeriod(2000, 2030);
setSplit('-', ' ', ':'); // 日期分隔符, 日期時間分隔符, 時間分隔符
</script>
class DateTimePicker {
constructor(options = {}) {
this.options = Object.assign({
triggers: '[data-datepicker]', // 選擇器
mode: 'datetime', // date | datetime | time
format: 'YYYY-MM-DD HH:mm',
// ... 其他配置
}, options);
this.state = { /* ... */ };
this.init();
}
// 使用現代 API: class, arrow functions, const/let, template literals
// 模塊化導出: export default DateTimePicker
// 構建工具打包, 支持 Tree-shaking
}
這個升級版日曆控件解決了傳統方案的核心痛點:**時間選擇缺失、IE6-8 遮擋元素問題、格式化靈活性不足**。通過模塊化封裝、事件委托、狀態集中管理、CSS 隔離,代碼可維護性大幅提升。雖然現代項目多用成熟 UI 庫,但理解「遮擋元素處理」「日曆矩陣算法」「定位邏輯」「全局事件管理」等核心技術,對於排查庫問題、構建定制組件、面試考察都極具價值。