平常只有下班時間能寫程式,閒著沒事就動手做了一個純 JavaScript 版的日曆控件。只要引入 calendar.js,再把要變成日曆的 input 的 id 設為 calendar,該輸入框就會變成日曆控件。

HTML
<!doctype html> <html> <head> <meta charset="utf-8"> <title>日曆控件</title> <script src="js/calendar.js" defer></script> </head> <body> <input id="calendar" type="text" /> </body> </html>
引入 calendar.js 時,一定要加上 defer 屬性。原因很單純:腳本一開始就執行 document.getElementById("calendar"),若此時 DOM 還沒解析到那個 input,就會拿到 null 而整段失效。defer 會讓腳本等到 DOM 就緒後才執行,正好解決這個問題。
calendar.js 原始碼
// JavaScript Document var days = new Array("日","一","二","三","四","五","六");//星期 var today = new Date();//當天日期,備用 var month_big = new Array("1","3","5","7","8","10","12"); //大月 var month_small = new Array("4","6","9","11"); //小月 var separator = "-";//分隔符號 var calendar = document.getElementById("calendar"); var cal_parent = calendar.parentNode;//取得父元素 var cal_width = ((calendar.clientWidth<150) ? 150 : calendar.clientWidth);//input 寬度小於 150 時調整為 150(日曆塊最小寬度) var cal_height = calendar.clientHeight;//input 高度 var cal_X = calendar.offsetLeft;//距父元素左側的距離 var cal_Y = calendar.offsetTop;//距父元素頂部的距離 calendar.style.cursor = "pointer";//游標改為小手 calendar.readOnly = "readOnly";//設為唯讀,避免使用者手打 calendar.onblur = hideCalendar; //失去焦點時隱藏 calendar.onclick = showCalendar;//點擊時顯示 //取 input 寬度的七分之一再減一作為方格邊長 var pane_height = cal_width/7 - 1; function hideCalendar(){ var cal_body = document.getElementById("cal_body"); if(cal_body != undefined){ cal_body.parentNode.removeChild(cal_body); } } //顯示日曆主體 function showCalendar(){ var cal_body = document.getElementById("cal_body"); if(cal_body != undefined){ cal_body.parentNode.removeChild(cal_body); } else{ var cal_body = document.createElement("DIV"); cal_body.id = "cal_body"; cal_body.style.width = cal_width + "px"; cal_body.style.height = "auto"; cal_body.style.overflow = "hidden"; cal_body.style.position = "absolute"; cal_body.style.zIndex = "9"; cal_body.style.left = cal_X + "px"; cal_body.style.top = (cal_Y + cal_height + 5) + "px"; cal_body.style.border = "solid 1px #CCCCCC"; //游標移到日曆上時,暫時停用 input 的 onblur,避免日曆因失焦而被隱藏 cal_body.onmouseover = function(){ calendar.onblur = undefined; } //游標移出時恢復 onblur;先讓 input 取回焦點,否則在日曆空白處點擊後再移出, //input 因為沒有焦點而無法觸發 onblur cal_body.onmouseout = function(){ calendar.focus(); calendar.onblur = hideCalendar; } cal_parent.appendChild(cal_body); //第一行:年份與左右切換 var line1 = document.createElement("DIV"); line1.style.width = cal_width + "px"; line1.style.height = pane_height + "px"; line1.style.backgroundColor = "#0FF"; var btn1 = document.createElement("DIV"); btn1.style.width = (cal_width/3 - 3) + "px"; btn1.style.height = pane_height + "px"; btn1.style.lineHeight = pane_height + "px"; btn1.style.textAlign = "center"; btn1.innerHTML = "<"; btn1.style.cursor = "pointer"; btn1.style.cssFloat = "left"; btn1.onclick = function(){ if(isValidated()){ var old_year = parseInt(document.getElementById("input_year").value); if(old_year > 1960){ var year = old_year - 1; var month = parseInt(document.getElementById("input_month").value); var val = year + separator + month + separator + 1; init(val); } } }; line1.appendChild(btn1); var input_year = document.createElement("INPUT"); input_year.id = "input_year"; input_year.style.width = (cal_width/3) + "px"; input_year.style.height = "70%"; input_year.style.cssFloat = "left"; input_year.style.textAlign = "center"; input_year.onchange = function(){ changed(); }; line1.appendChild(input_year); var btn2 = document.createElement("DIV"); btn2.style.width = (cal_width/3 - 3) + "px"; btn2.style.height = pane_height + "px"; btn2.style.lineHeight = pane_height + "px"; btn2.style.textAlign = "center"; btn2.innerHTML = ">"; btn2.style.cursor = "pointer"; btn2.style.cssFloat = "left"; btn2.onclick = function(){ if(isValidated()){ var old_year = parseInt(document.getElementById("input_year").value); if(old_year < 2050){ var year = old_year + 1; var month = parseInt(document.getElementById("input_month").value); var val = year + separator + month + separator + 1; init(val); } } }; line1.appendChild(btn2); //第二行:月份與左右切換 var line2 = document.createElement("DIV"); line2.style.width = cal_width + "px"; line2.style.height = pane_height + "px"; line2.style.backgroundColor = "#0FF"; var btn3 = document.createElement("DIV"); btn3.style.width = (cal_width/3 - 3) + "px"; btn3.style.height = pane_height + "px"; btn3.style.lineHeight = pane_height + "px"; btn3.style.textAlign = "center"; btn3.innerHTML = "<"; btn3.style.cursor = "pointer"; btn3.style.cssFloat = "left"; btn3.onclick = function(){ if(isValidated()){ var old_month = parseInt(document.getElementById("input_month").value) if(old_month > 1){ var year = parseInt(document.getElementById("input_year").value); var month = old_month - 1; var val = year + separator + month + separator + 1; init(val); } else { //往前跨年到去年 12 月 var year = parseInt(document.getElementById("input_year").value) - 1; var month = 12; var val = year + separator + month + separator + 1; init(val); } } }; line2.appendChild(btn3); var input_month = document.createElement("INPUT"); input_month.id = "input_month"; input_month.style.width = (cal_width/3) + "px"; input_month.style.height = "70%"; input_month.style.cssFloat = "left"; input_month.style.textAlign = "center"; input_month.onchange = function(){ changed(); }; line2.appendChild(input_month); var btn4 = document.createElement("DIV"); btn4.style.width = (cal_width/3 - 3) + "px"; btn4.style.height = pane_height + "px"; btn4.style.lineHeight = pane_height + "px"; btn4.style.textAlign = "center"; btn4.innerHTML = ">"; btn4.style.cursor = "pointer"; btn4.style.cssFloat = "left"; btn4.onclick = function(){ if(isValidated()){ var old_month = parseInt(document.getElementById("input_month").value) if(old_month < 12){ var year = parseInt(document.getElementById("input_year").value); var month = parseInt(document.getElementById("input_month").value) + 1; var val = year + separator + month + separator + 1; init(val); } else { //往後跨年到明年 1 月 var year = parseInt(document.getElementById("input_year").value) + 1; var month = 1; var val = year + separator + month + separator + 1; init(val); } } }; line2.appendChild(btn4); cal_body.appendChild(line1); cal_body.appendChild(line2); //星期標題列 for(var i=0; i < 7; i++){ var pane = document.createElement("DIV"); pane.className = "pane"; pane.style.width = pane_height + "px"; pane.style.height = pane_height + "px"; pane.style.lineHeight = pane_height + "px"; pane.style.textAlign = "center"; pane.style.cssFloat = "left"; pane.innerHTML = days[i]; cal_body.appendChild(pane); } init(calendar.value); } } //依指定日期繪製日曆 function init(val){ clearPane(); var cal_body = document.getElementById("cal_body"); var temp_date; var year; var month; var date; if(val == ""){ //input 沒值時以今天為基準 temp_date = today; calendar.value = today.toFormatString(separator); } else{ year = val.year(); month = val.month(separator); date = val.date(separator); temp_date = new Date(year,month,date); } year = temp_date.getFullYear(); month = temp_date.getMonth() + 1; date = temp_date.getDate(); temp_date.setDate(1); //先把日期設為 1 號,才能正確取得該月第一天是星期幾 var start = temp_date.getDay() + 7; var end; //依月份大小與閏年決定天數 if(array_contain(month_big, month)){ end = start + 31; } else if(array_contain(month_small, month)){ end = start + 30; } else{ if(isLeapYear(year)){ end = start + 29; } else{ end = start + 28; } } //補出月初之前的空白格 for(var i = 7; i < start; i++){ var pane = document.createElement("DIV"); pane.className = "pane"; pane.style.width = pane_height + "px"; pane.style.height = pane_height + "px"; pane.style.lineHeight = pane_height + "px"; pane.style.textAlign = "center"; pane.style.cssFloat = "left"; cal_body.appendChild(pane); } //產生日期格 for(var i = start; i < end; i++){ var pane = document.createElement("DIV"); pane.className = "pane"; pane.style.width = pane_height + "px"; pane.style.height = pane_height + "px"; pane.style.lineHeight = pane_height + "px"; pane.style.textAlign = "center"; pane.style.cssFloat = "left"; pane.innerHTML = i - start + 1; pane.style.cursor = "pointer"; pane.onmouseover = function(){ this.style.backgroundColor = '#0FF'; } if(date == (i - start + 1)) pane.style.backgroundColor = '#0FF'; //當天高亮 else{ pane.onmouseout = function(){ this.style.backgroundColor = ''; } } pane.onclick = function(){ calendar.value = year + separator + month + separator + this.innerHTML; cal_body.parentNode.removeChild(cal_body); } cal_body.appendChild(pane); document.getElementById("input_year").value = year; document.getElementById("input_month").value = month; } } //格式化輸出 Date.prototype.toFormatString = function(separator){ var result = this.getFullYear() + separator + (this.getMonth() + 1) + separator + this.getDate(); return result; }; //從格式化字串中取出年份 String.prototype.year = function(){ var str = this.substring(0,4); return str; }; //從格式化字串中取出月份 String.prototype.month = function(separator){ var start = this.indexOf(separator) + 1; var end = this.lastIndexOf(separator); return parseInt(this.substring(start, end)) - 1; }; //從格式化字串中取出日期 String.prototype.date = function(separator){ var start = this.lastIndexOf(separator) + 1; return this.substring(start); }; //判斷陣列中是否包含元素 obj function array_contain(array, obj){ for (var i = 0; i < array.length; i++){ if (array[i] == obj) return true; } return false; } //判斷是否為閏年 function isLeapYear(year){ var a = year % 4; var b = year % 100; var c = year % 400; if( ( (a == 0) && (b != 0) ) || (c == 0) ){ return true; } return false; } //清除日期格 function clearPane(){ var limit = document.getElementsByClassName("pane").length; for(var i=7; i < limit; i++){ var pane = document.getElementsByClassName("pane").item(7); pane.parentNode.removeChild(pane); } } //檢查輸入是否合法 function isValidated(){ var year = document.getElementById("input_year").value; var month = document.getElementById("input_month").value; if(isNaN(year) || isNaN(month)){ alert("請輸入正確的年份/月份"); return false; } else{ if(year%1 != 0 || month%1 != 0){ alert("請輸入正確的年份/月份"); return false; } else{ year = parseInt(year); if(year < 1960 || year > 2050){ alert("請輸入1960~2050之間的年份!"); return false; } else if(month < 1 || month >12){ alert("請輸入正確的月份!"); return false; } else{ return true; } } } } //年份月份變動時的處理 function changed(){ if(isValidated()){ var year = document.getElementById("input_year").value; var month = document.getElementById("input_month").value; var val = year + separator + month + separator + 1; init(val); } }
整體架構拆解如下:showCalendar 負責建立日曆容器與年月切換列;init 依指定日期算出該月第一天是星期幾(start)與應繪製的格數(end),再補出空白格與日期格;clearPane 在重繪前清掉舊的日期格。
幾個設計細節值得留意:
temp_date.setDate(1) 這一步是關鍵。若直接拿「今天」去算 getDay(),得到的是今天星期幾,而不是「這個月 1 號星期幾」,整月排列就會錯位。先把日期設為 1 號再取 getDay(),才是正確做法。
onmouseover / onmouseout 那組切換 onblur 的寫法,是為了處理「日曆是浮層、點擊日曆會讓 input 失焦」這個矛盾。這也是手做浮層最麻煩的部分之一。
不過這份程式碼有幾個地方,若要在正式專案中使用建議改掉:
它大量擴充了 Date.prototype 與 String.prototype(toFormatString、year、month、date),這會汙染內建物件。尤其 String.prototype.year 這種命名極具碰撞風險,其他函式庫若定義同名方法就會出問題。建議改為獨立工具函式。
id 寫死為 calendar、cal_body、input_year 等固定值,因此同一頁面只能有一個日曆控件。若要支援多個實例,需要改成以 DOM 參照傳遞而非全域查詢。
1960~2050 的年份限制、pane 寬度靠 JS 計算,都讓它在不同解析度與字型縮放下容易走位。現代做法會改用 CSS 類別控制樣式,並以 position 與 transform 處理浮層定位。
最後,鍵盤操作與 ARIA 屬性完全沒有實作,純靠滑鼠。無障礙要求高的專案,直接採用成熟函式庫會省下大量工。這個版本的價值主要在於把「月曆排列與閏年判斷」的邏輯攤開來看,理解之後再挑工具會更有判斷力。