DIV CSS 佈局教程網

自製 JS 日期時間選擇控件(升級版)
編輯:關於JavaScript     

網路上能找到的日期選擇程式多少都有點問題,於是決定重寫一個,順手加上時間選擇功能。大部分思路仍借鑑前人的日曆控件,在此基礎上補上了幾件事:時間選擇、自動隱藏會遮擋控件的 select 與 object 標籤,還有一些小調整。

一開始想用 window.createPopup() 彈出日曆,這樣就能跨過任何標籤的層級問題。做到中途發現理論上行不通:

一是視窗在表單外單擊任何地方都會關閉,而使用者用下拉框選年份時很可能就點到外面去了——雖然可以自己寫一個 select 來避開,但太麻煩;

二是視窗寬高只能在彈出時設定,而顯然切換不同年月時控件高度是要變的。

基於以上原因,最後還是採一般做法。

使用方法

載入 Calendar.js 後,依需求選擇對應的呼叫方式:

// (1) 只選擇日期
<input type="text" name="date" readOnly onClick="setDay(this);">

// (2) 選擇日期和小時
<input type="text" name="dateh" readOnly onClick="setDayH(this);">

// (3) 選擇日期、小時及分鐘
<input type="text" name="datehm" readOnly onClick="setDayHM(this);">

可設定的參數:

(1) 日期分隔符 setDateSplit(strSplit),預設 "-"
(2) 日期與時間之間的分隔符 setDateTimeSplit(strSplit),預設 " "
(3) 時間分隔符 setTimeSplit(strSplit),預設 ":"
(4) 一次設定以上三者 setSplit(strDateSplit, strDateTimeSplit, strTimeSplit)
(5) 可選年份區間 setYearPeriod(intDateBeg, intDateEnd)

預設輸出的格式如:2005-02-02 08:08

Calendar.js 核心結構

// ---------------- 樣式定義 ----------------
var s_tiannet_turn_base = "height:16px;font-size:9pt;color:white;border:0 solid #CCCCCC;cursor:hand;background-color:#2650A6;";
var s_tiannet_turn  = "width:28px;" + s_tiannet_turn_base;  // 翻年、月按鈕
var s_tiannet_turn2 = "width:22px;" + s_tiannet_turn_base;  // 關閉、清空按鈕
var s_tiannet_select  = "width:64px;display:none;";         // 年下拉框
var s_tiannet_select2 = "width:46px;display:none;";         // 月、時、分下拉框
var s_tiannet_body = "width:150;background-color:#2650A6;display:none;z-index:9998;position:absolute;" +
  "border-left:1 solid #CCCCCC;border-top:1 solid #CCCCCC;border-right:1 solid #999999;border-bottom:1 solid #999999;";
var s_tiannet_day  = "width:21px;height:20px;background-color:#D8F0FC;font-size:10pt;";
var s_tiannet_font = "color:#FFCC00;font-size:9pt;cursor:hand;";
var s_tiannet_link = "text-decoration:none;font-size:9pt;color:#2650A6;";
var s_tiannet_line = "border-bottom:1 solid #6699CC";

// ---------------- 變數定義 ----------------
var tiannetYearSt = 1950;   // 可選擇的開始年份
var tiannetYearEnd = 2010;  // 可選擇的結束年份
var tiannetDateNow = new Date();
var tiannetYear   = tiannetDateNow.getFullYear();
var tiannetMonth  = tiannetDateNow.getMonth() + 1;
var tiannetDay    = tiannetDateNow.getDate();
var tiannetHour   = 8;
var tiannetMinute = 0;
var tiannetArrDay = new Array(42);
var tiannetDateSplit     = "-";
var tiannetDateTimeSplit = " ";
var tiannetTimeSplit     = ":";
var tiannetOutObject;             // 接收日期時間的物件
var arrTiannetHide = new Array(); // 被強制隱藏的標籤
var m_bolShowHour   = false;
var m_bolShowMinute = false;
var m_aMonHead = new Array(12);
m_aMonHead[0]=31; m_aMonHead[1]=28; m_aMonHead[2]=31; m_aMonHead[3]=30;
m_aMonHead[4]=31; m_aMonHead[5]=30; m_aMonHead[6]=31; m_aMonHead[7]=31;
m_aMonHead[8]=30; m_aMonHead[9]=31; m_aMonHead[10]=30; m_aMonHead[11]=31;

// ---------------- 對外函式 ----------------
// 只選日期
function setDay(obj) {
  tiannetOutObject = obj;
  var strValue = tiannetTrim(tiannetOutObject.value);
  if (strValue != "") tiannetInitDate(strValue);
  tiannetPopCalendar();
}

// 選日期和小時
function setDayH(obj) {
  tiannetOutObject = obj;
  m_bolShowHour = true;
  var strValue = tiannetTrim(tiannetOutObject.value);
  if (strValue != "") {
    tiannetInitDate(strValue.substring(0, 10));
    var hour = strValue.substring(11, 13);
    if (hour < 10) tiannetHour = hour.substring(1, 2);
  }
  tiannetPopCalendar();
}

// 選日期、小時和分鐘
function setDayHM(obj) {
  tiannetOutObject = obj;
  m_bolShowHour = true;
  m_bolShowMinute = true;
  var strValue = tiannetTrim(tiannetOutObject.value);
  if (strValue != "") {
    tiannetInitDate(strValue.substring(0, 10));
    var time = strValue.substring(11, 16);
    var arr = time.split(tiannetTimeSplit);
    tiannetHour = arr[0];
    tiannetMinute = arr[1];
    if (tiannetHour < 10) tiannetHour = tiannetHour.substring(1, 2);
    if (tiannetMinute < 10) tiannetMinute = tiannetMinute.substring(1, 2);
  }
  tiannetPopCalendar();
}

function setYearPeriod(intDateBeg, intDateEnd) {
  tiannetYearSt = intDateBeg;
  tiannetYearEnd = intDateEnd;
}
function setDateSplit(strDateSplit)         { tiannetDateSplit = strDateSplit; }
function setDateTimeSplit(strDateTimeSplit) { tiannetDateTimeSplit = strDateTimeSplit; }
function setTimeSplit(strTimeSplit)         { tiannetTimeSplit = strTimeSplit; }
function setSplit(d, dt, t) {
  tiannetDateSplit(d); tiannetDateTimeSplit(dt); tiannetTimeSplit(t);
}
function setDefaultDate(strDate) { // YYYY-MM-DD
  tiannetYear  = strDate.substring(0, 4);
  tiannetMonth = strDate.substring(5, 7);
  tiannetDay   = strDate.substring(8, 10);
}
function setDefaultTime(strTime) { // HH24:MI
  tiannetHour   = strTime.substring(0, 2);
  tiannetMinute = strTime.substring(3, 5);
}

// ---------------- 日期計算工具 ----------------
// 判斷是否為閏年
function isPinYear(year) {
  return (0 == year % 4 && ((year % 100 != 0) || (year % 400 == 0)));
}
// 取得某月天數,閏年二月為 29 天
function getMonthCount(year, month) {
  var c = m_aMonHead[month - 1];
  if ((month == 2) && isPinYear(year)) c++;
  return c;
}
// 重新校正當前的日,防止翻月後日大於該月最大日
function setRealDayCount() {
  if (tiannetDay > getMonthCount(tiannetYear, tiannetMonth)) {
    tiannetDay = getMonthCount(tiannetYear, tiannetMonth);
  }
}
function addZero(value) {
  if (value < 10) value = "0" + value;
  return value;
}
function tiannetTrim(str) {
  return str.replace(/(^\s*)|(\s*$)/g, "");
}
function createOption(objSelect, value, text) {
  var option = document.createElement("OPTION");
  option.value = value;
  option.text = text;
  objSelect.options.add(option);
}

// ---------------- 翻年、翻月 ----------------
function tiannetPrevYear() {
  if (tiannetYear > 999 && tiannetYear < 10000) { tiannetYear--; }
  else { alert("年份超出範圍(1000-9999)!"); }
  tiannetSetDay(tiannetYear, tiannetMonth);
  if (tiannetYear < tiannetYearSt) {
    tiannetYearSt = tiannetYear;
    createOption(document.all.selTianYear, tiannetYear, tiannetYear + "年");
  }
  checkSelect(document.all.selTianYear, tiannetYear);
  tiannetWriteHead();
}
function tiannetNextYear() {
  if (tiannetYear > 999 && tiannetYear < 10000) { tiannetYear++; }
  else { alert("年份超出範圍(1000-9999)!"); return; }
  tiannetSetDay(tiannetYear, tiannetMonth);
  if (tiannetYear > tiannetYearEnd) {
    tiannetYearEnd = tiannetYear;
    createOption(document.all.selTianYear, tiannetYear, tiannetYear + "年");
  }
  checkSelect(document.all.selTianYear, tiannetYear);
  tiannetWriteHead();
}
function tiannetPrevMonth() {
  if (tiannetMonth > 1) { tiannetMonth-- } else { tiannetYear--; tiannetMonth = 12; }
  tiannetSetDay(tiannetYear, tiannetMonth);
  checkSelect(document.all.selTianMonth, tiannetMonth);
  tiannetWriteHead();
}
function tiannetNextMonth() {
  if (tiannetMonth == 12) { tiannetYear++; tiannetMonth = 1 } else { tiannetMonth++ }
  tiannetSetDay(tiannetYear, tiannetMonth);
  checkSelect(document.all.selTianMonth, tiannetMonth);
  tiannetWriteHead();
}
function tiannetToday() {
  tiannetYear  = tiannetDateNow.getFullYear();
  tiannetMonth = tiannetDateNow.getMonth() + 1;
  tiannetDay   = tiannetDateNow.getDate();
  tiannetSetValue(true);
}

// ---------------- 寫入標題與日期格 ----------------
function tiannetWriteHead() {
  document.all.tiannetYearHead.innerText  = tiannetYear + "年";
  document.all.tiannetMonthHead.innerText = tiannetMonth + "月";
  if (m_bolShowHour)   document.all.tiannetHourHead.innerText   = " " + tiannetHour + "時";
  if (m_bolShowMinute) document.all.tiannetMinuteHead.innerText = tiannetMinute + "分";
  tiannetSetValue(false); // 給文字框賦值,但不隱藏控件
}

function tiannetSetDay(yy, mm) {
  setRealDayCount();
  tiannetWriteHead();
  var strDateFont1 = "", strDateFont2 = "";
  for (var i = 0; i < 37; i++) { tiannetArrDay[i] = ""; }
  var day1 = 1;
  var firstday = new Date(yy, mm - 1, 1).getDay(); // 該月第一天的星期幾
  for (var i = firstday; day1 < getMonthCount(yy, mm) + 1; i++) {
    tiannetArrDay[i] = day1;
    day1++;
  }
  for (var i = 0; i < 37; i++) {
    var da = eval("document.all.tdTiannetDay" + i);
    if (tiannetArrDay[i] != "") {
      // 週末用紅字
      if (i % 7 == 0 || (i + 1) % 7 == 0) {
        strDateFont1 = "<font color=#ff0000>"; strDateFont2 = "</font>";
      } else {
        strDateFont1 = ""; strDateFont2 = "";
      }
      da.innerHTML = strDateFont1 + tiannetArrDay[i] + strDateFont2;
      // 目前選中的天改底色
      da.style.backgroundColor = (tiannetArrDay[i] == tiannetDay) ? "#CCCCCC" : "#EFEFEF";
      da.style.cursor = "hand";
    } else {
      da.innerHTML = "";
      da.style.backgroundColor = "";
      da.style.cursor = "default";
    }
  }
  tiannetSetValue(false);
}

// ---------------- 下拉框同步 ----------------
function checkSelect(objSelect, selectValue) {
  var count = parseInt(objSelect.length);
  if (selectValue < 10 && selectValue.toString().length == 2) {
    selectValue = selectValue.substring(1, 2);
  }
  for (var i = 0; i < count; i++) {
    if (objSelect.options[i].value == selectValue) {
      objSelect.selectedIndex = i;
      break;
    }
  }
}

// ---------------- 賦值與顯示控制 ----------------
function tiannetSetValue(bolHideControl) {
  var value = "";
  if (!tiannetDay || tiannetDay == "") {
    tiannetOutObject.value = value;
    return;
  }
  var mm = tiannetMonth, day = tiannetDay;
  if (mm < 10 && mm.toString().length == 1)  mm  = "0" + mm;
  if (day < 10 && day.toString().length == 1) day = "0" + day;
  value = tiannetYear + tiannetDateSplit + mm + tiannetDateSplit + day;
  if (m_bolShowHour) {
    var hour = tiannetHour;
    if (hour < 10 && hour.toString().length == 1) hour = "0" + hour;
    value += tiannetDateTimeSplit + hour;
  }
  if (m_bolShowMinute) {
    var minute = tiannetMinute;
    if (minute < 10 && minute.toString().length == 1) minute = "0" + minute;
    value += tiannetTimeSplit + minute;
  }
  tiannetOutObject.value = value;
  if (bolHideControl) tiannetHideControl();
}

function tiannetPopCalendar() {
  hideElementsById(new Array("selTianYear", "selTianMonth", "selTianHour", "selTianMinute"), true);
  hideElementsById(new Array("tiannetYearHead", "tiannetMonthHead", "tiannetHourHead", "tiannetMinuteHead"), false);
  tiannetSetDay(tiannetYear, tiannetMonth);
  tiannetWriteHead();
  showTime();

  var dads = document.all.divTiannetDate.style;
  var iX, iY;
  var h = document.all.divTiannetDate.offsetHeight;
  var w = document.all.divTiannetDate.offsetWidth;
  // 計算 left
  if (window.event.x + h > document.body.offsetWidth - 10) iX = window.event.x - h - 5;
  else iX = window.event.x + 5;
  if (iX < 0) iX = 0;
  // 計算 top
  if (window.event.y + w > document.body.offsetHeight - 10)
    iY = document.body.scrollTop + document.body.offsetHeight - w - 5;
  else
    iY = document.body.scrollTop + window.event.y + 5;
  if (iY < 0) iY = 0;
  dads.left = iX;
  dads.top = iY;
  tiannetShowControl();
  selectObject();
}

function tiannetHideControl() {
  document.all.divTiannetDate.style.display = "none";
  tiannetShowObject();
  arrTiannetHide = new Array();
}
function tiannetShowControl() {
  document.all.divTiannetDate.style.display = "";
  tiannetHideObject("SELECT");
  tiannetHideObject("OBJECT");
}

// 依標籤名隱藏會遮住控件的元素
function tiannetHideObject(strTagName) {
  var x = document.all.divTiannetDate.offsetLeft;
  var y = document.all.divTiannetDate.offsetTop;
  var h = document.all.divTiannetDate.offsetHeight;
  var w = document.all.divTiannetDate.offsetWidth;
  for (var i = 0; i < document.all.tags(strTagName).length; i++) {
    var obj = document.all.tags(strTagName)[i];
    if (!obj || !obj.offsetParent) continue;
    var objLeft = obj.offsetLeft, objTop = obj.offsetTop;
    var objHeight = obj.offsetHeight, objWidth = obj.offsetWidth;
    var objParent = obj.offsetParent;
    while (objParent.tagName.toUpperCase() != "BODY") {
      objLeft += objParent.offsetLeft;
      objTop  += objParent.offsetTop;
      objParent = objParent.offsetParent;
    }
    var bolHide = true;
    if (obj.style.display == "none" || obj.style.visibility == "hidden" ||
        obj.getAttribute("Author") == "tiannet") {
      bolHide = false; // 本來就隱藏,或是控件自己的下拉框
    }
    if (((objLeft + objWidth) > x && (y + h + 20) > objTop &&
         (objTop + objHeight) > y && objLeft < (x + w)) && bolHide) {
      arrTiannetHide[arrTiannetHide.length] = obj;
      obj.style.visibility = "hidden";
    }
  }
}
function tiannetShowObject() {
  for (var i = 0; i < arrTiannetHide.length; i++) {
    arrTiannetHide[i].style.visibility = "";
  }
}

function tiannetInitDate(strDate) {
  var arr = strDate.split(tiannetDateSplit);
  tiannetYear  = arr[0];
  tiannetMonth = arr[1];
  tiannetDay   = arr[2];
}
function tiannetClear() {
  tiannetOutObject.value = "";
  tiannetHideControl();
}
// 任意點擊時關閉控件
function document.onclick() {
  with (window.event.srcElement) {
    if (tagName != "INPUT" && getAttribute("Author") != "tiannet") tiannetHideControl();
  }
}
// 按 ESC 關閉
function document.onkeypress() {
  if (event.keyCode == 27) tiannetHideControl();
}

Calendar.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<title>日曆控件示例</title>
<script src="./Calendar.js"></script>
</head>
<body>
(1) 只選擇日期 <input type="text" name="date" readOnly onClick="setDay(this);"><br/>
(2) 選擇日期和小時 <input type="text" name="dateh" readOnly onClick="setDayH(this);"><br/>
(3) 選擇日期和小時及分鐘 <input type="text" name="datehm" readOnly onClick="setDayHM(this);">
</body>
</html>

幾個設計上的說明

為什麼要隱藏 select 與 object:在舊版 IE 中,select 是視窗級元件,z-index 對它無效,一定會蓋在浮層之上。程式的做法是計算每個 select 與日曆的矩形是否相交,若相交就暫時設為 visibility: hidden,關閉時再還原。

日期格為何是 37 格:最壞情況下,一個月從週六開始且有 31 天,會需要 6 列共 42 格。這裡只配置了 37 格(5 列 + 2 格),部分情境下最後幾天可能顯示不出來——這是可以修正的地方。

今日觀點:這份程式碼大量依賴 document.all 與 window.event,都是 IE 專屬的舊式 API,且用 eval 動態取元素,效能與可讀性都不理想。今天要實作同樣的功能,直接用 <input type="date"> 或 datetime-local 即可,瀏覽器已內建完整的日曆與時間選擇 UI;若需要更豐富的呈現,也有多個成熟且維護中的日期選擇函式庫可用。保留這份程式碼的價值,主要在於理解一個日曆控件需要處理哪些邊界情況。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved