萬盛學電腦網

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

JavaScript 日期時間選擇控件升級版:支持時分選擇、Select/Object 遮擋處理、多格式輸出

經典的日歷控件在現代項目中仍有應用場景(如無構建環境、極度定制需求、舊系統維護)。本文在傳統日曆基礎上重構升級,新增時間選擇(時/分)、解決 IE6-8 下 Select/Object/Flash 遮擋層級最高的經典問題、提供靈活的格式化配置與主題定制。

核心升級點

  • 三模式支持:`setDay()` 僅日期、`setDayH()` 日期+時、`setDayHM()` 日期+時+分
  • 時間選擇面板:小時(0-23)下拉、分鐘(0-59)下拉,支持鍵盤輸入驗證
  • 遮擋元素處理:IE6-8 下 `' + '' + '' + '' + '' + '
' + '' + '' + '' + '
' + '' + ''; 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>

現代化重構方向 (ES6+ Class)


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 庫,但理解「遮擋元素處理」「日曆矩陣算法」「定位邏輯」「全局事件管理」等核心技術,對於排查庫問題、構建定制組件、面試考察都極具價值。

copyright © 萬盛學電腦網 all rights reserved