DIV CSS 佈局教程網

JS 日期時間選擇控件升級版:加上時與分,還能避開遮擋
編輯:JavaScript綜合知識     

網路上找到的幾個日期選擇程式總有些毛病,於是決定重寫一個,順手加上時間選擇功能。大部分思路仍借鑑前人的經驗,但加了兩項實用改進:可選到時與分,以及在彈出時自動隱藏會遮擋它的 select 與 object 標籤。

為什麼不用 createPopup

一開始想用 window.createPopup() 彈出日曆,這樣就能跨過任何標籤、永遠在最上層。做到中途發現理論上行不通,有兩個原因:

一是 popup 視窗在窗體外單擊任何地方都會關閉。而使用者用下拉框選年份時,很可能會滑到窗體外——雖然可以自己寫 select 來避開,但麻煩。

二是 popup 的寬高只能在彈出時設定,而日曆在不同年月下高度會改變(某些月只占四列、某些占五列),無法動態調整。

於是改回普通的絕對定位 div 方案。

樣式集中管理

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;";
var s_tiannet_day = "width:21px;height:20px;background-color:#D8F0FC;font-size:10pt;";

用變數組出樣式字串,共用基底再加上差異部分。這是在 CSS 預處理器普及之前的常見做法——用 JavaScript 變數拼接來達到「樣式繼承」的效果。今天用 Sass 的 @extend 或 placeholder 會乾淨得多。

狀態與設定

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;       // 是否顯示分鐘

三個分隔符各自獨立,讓輸出格式可以客製成 2026/08/26 14:30 或其他樣式。注意 tiannetHour 預設是 8 而不是現在時間——原作者刻意讓時間欄位有個整齊的預設值,避免開啟時出現奇怪的分秒。

三個對外的主函式

// 只選日期
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 arr = strValue.substring(11, 16).split(tiannetTimeSplit);
    tiannetHour = arr[0];
    tiannetMinute = arr[1];
  }
  tiannetPopCalendar();
}

三個函式共用同一份 UI,只靠兩個布林旗標決定要不要顯示時、分。這種「一個元件、多種模式」的設計,比寫三份日曆程式好維護太多。而且每個函式開頭都先讀輸入框現有的值來初始化狀態——使用者第二次打開時,游標會停在上次選的位置,而不是跳回今天。

閏年與每月天數

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 isPinYear(year) {
  if (0 == year % 4 && ((year % 100 != 0) || (year % 400 == 0))) return true;
  return false;
}

function getMonthCount(year, month) {
  var c = m_aMonHead[month - 1];
  if ((month == 2) && isPinYear(year)) c++;
  return c;
}

閏年判斷寫得正確:「能被 4 整除,但不能被 100 整除,除非也能被 400 整除」。這個規則很多人只記得前半段,於是 1900 年會被誤判為閏年。順帶一提,用 new Date(year, month, 0).getDate() 也能拿到天數,是更不容易寫錯的替代方案。

切換日曆時的日期修正

function setRealDayCount() {
  if (tiannetDay > getMonthCount(tiannetYear, tiannetMonth)) {
    tiannetDay = getMonthCount(tiannetYear, tiannetMonth);
  }
}

這是個容易忽略的邊界情況:使用者在 1 月 31 日,按下「下一月」,2 月沒有 31 日。若不處理,日期會變成 2 月 31 日這種不存在的組合。這裡的做法是夾到當月的最後一天。翻年月時都會先呼叫這個函式。

隱藏會遮擋的標籤

function tiannetHideObject(strTagName) {
  x = document.all.divTiannetDate.offsetLeft;
  y = document.all.divTiannetDate.offsetTop;
  h = document.all.divTiannetDate.offsetHeight;
  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;
    // 取得元素相對於 BODY 的座標
    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";
    }
  }
}

這個函式是整份程式最有意思的部分。它做的是矩形碰撞偵測:算出日曆的包圍盒(x, y, w, h),再逐一比對每個 select/object 的位置,判斷兩者是否重疊。那四個條件合起來就是標準的 AABB 相交測試——「A 的右邊在 B 的左邊之外,且 A 的下邊在 B 的上邊之外……」全部成立才算重疊。

被判定為重疊的標籤會記錄到 arrTiannetHide 陣列並設為 visibility: hidden;關閉日曆時 tiannetShowObject() 再把它們逐一還原。用「記錄起來再還原」而不是「一律還原」,是為了不干擾本來就被隱藏的元素。

這個問題的存在完全是因為 IE6 的 select 是原生視窗元件、不受 z-index 約束。在現代瀏覽器裡,這一整段都可以刪掉了。

點擊外部與 ESC 關閉

function document.onclick() {
  with (window.event.srcElement) {
    if (tagName != "INPUT" && getAttribute("Author") != "tiannet")
      tiannetHideControl();
  }
}
function document.onkeypress() {
  if (event.keyCode == 27) { tiannetHideControl(); }
}

這兩個函式實作了兩個基本的互動期待:點其他地方關閉、按 ESC 關閉。用自訂的 Author="tiannet" 屬性來標記「這是我自己的元素,不要當成外部點擊」,是個聰明但需要寫註解說明的技巧——否則後人完全看不懂這個屬性的用途。

頁面掛載

<script src="./Calendar.js"></script>
<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>

全部邏輯都在外部 js 檔,頁面只要三個 input 和三次函式呼叫。加上 readOnly 確保格式統一,這才是元件該有的樣子。

讀這份程式碼的價值

今天你只需要寫 <input type="datetime-local">,瀏覽器會給你完整的日期時間選擇器,還附帶鍵盤操作與行動裝置體驗。

但這份程式仍然值得讀完,因為裡面的問題都是真實且會再出現的:跨月時日期溢出怎麼辦、閏年怎麼判斷、浮層如何避免被其他元件遮蓋、點擊外部關閉如何不誤觸自己、狀態如何保留讓使用者回到上次的位置。這些跟你用什麼框架、寫在哪個年代毫無關係。

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