DIV CSS 佈局教程網

打造簡約的純 JS 日曆選擇元件
編輯:關於JavaScript     

日期選擇器是表單必備元件。這個範例用純 JavaScript 實作了一個輕量日曆:點擊輸入框彈出,可切換年月、選日期、清空或關閉,不需要任何外部函式庫。

使用方式

<input type="text" id="add_date" onclick="choose_date_czw('add_date')" />

只要給輸入框一個 id,並在點擊時呼叫 choose_date_czw('輸入框id') 即可。

程式碼

<script type="text/javascript" language="javascript">
function choose_date_czw(date_id, objtd){
    // 關閉
    if (date_id == "choose_date_czw_close"){
        document.getElementById("choose_date_czw_id").style.display = "none";
        return;
    }

    // 點選了某個日期格子
    if (objtd != undefined){
        if (objtd == "choose_date_czw_empty"){
            document.getElementById(date_id).value = "";
        } else {
            var year1  = document.getElementById("choose_date_czw_year").value;
            var month1 = document.getElementById("choose_date_czw_month").value;
            document.getElementById(date_id).value = year1 + "-" + month1 + "-" + objtd.innerHTML;
        }
        document.getElementById("choose_date_czw_id").style.display = "none";
        return;
    }

    // 一般情況:渲染日曆
    var nstr = new Date();          // 預設為今天
    if (document.getElementById("choose_date_czw_year") != null){
        // 若日曆已開啟,沿用使用者目前選擇的年月
        var year  = document.getElementById("choose_date_czw_year").value;
        var month = document.getElementById("choose_date_czw_month").value;
        nstr = new Date(year + "/" + month + "/1");
    }

    var ynow = nstr.getFullYear();
    var mnow = nstr.getMonth();          // 0~11
    var dnow = nstr.getDate();
    var n1str = new Date(ynow, mnow, 1);
    var firstday = n1str.getDay();       // 當月 1 號是星期幾(0=週日)

    function is_leap(year) {
        return (year % 4 == 0 && year % 100 != 0) || (year % 400 == 0);
    }

    // 年份下拉選單
    var dstr = "<select id=\"choose_date_czw_year\" onchange=\"choose_date_czw('"+date_id+"')\">";
    for (var y = 1901; y < 2050; y++){
        dstr += "<option value='" + y + "'" + (y == ynow ? " selected" : "") + ">" + y + "</option>";
    }
    dstr += "</select> ";

    // 月份下拉選單
    dstr += "<select id=\"choose_date_czw_month\" onchange=\"choose_date_czw('"+date_id+"')\">";
    for (var m = 1; m < 13; m++){
        dstr += "<option value='" + m + "'" + (parseInt(mnow + 1) == m ? " selected" : "") + ">" + m + "</option>";
    }
    dstr += "</select> ";
    dstr += "<span style='cursor:pointer;' onclick=\"choose_date_czw('choose_date_czw_close')\">關閉</span>";
    dstr += "|<span style='cursor:pointer;' onclick=\"choose_date_czw('"+date_id+"','choose_date_czw_empty')\">清空</span>";

    // 一三五七八十臘(十二月)三十一日永不差;四六九冬(十一月)三十日;唯有閏年二月廿九
    var m_days = new Array(31, 28 + is_leap(ynow), 31, 30, 31, 30, 31, 31, 30, 31, 30, 31);
    var tr_str = Math.ceil((m_days[mnow] + firstday) / 7);

    dstr += "<table border='0' cellpadding='5' cellspacing='0'>";
    dstr += "<tr><td>日</td><td>一</td><td>二</td><td>三</td>"
          + "<td>四</td><td>五</td><td>六</td></tr>";

    var dqdate = new Date();          // 今天,用來標示
    for (var i = 0; i < tr_str; i++) {          // 外層:tr
        dstr += "<tr>";
        for (var k = 0; k < 7; k++) {           // 內層:td
            var idx = i * 7 + k;                // 儲存格的自然序號
            var date_str = idx - firstday + 1;  // 反推日期數字
            if (date_str <= 0 || date_str > m_days[mnow]){
                dstr += "<td>&nbsp;</td>";      // 非本月的格子留空
            } else {
                var isToday = (ynow == dqdate.getFullYear()
                            && mnow == dqdate.getMonth()
                            && dqdate.getDate() == date_str);
                dstr += "<td onclick=\"choose_date_czw('"+date_id+"',this)\""
                      + " style='cursor:pointer;"
                      + (isToday ? " background-color:#6FF;" : "") + "'"
                      + " onmouseover=\"this.style.backgroundColor='#6FF'\""
                      + " onmouseout=\"this.style.backgroundColor='"
                      + (isToday ? '#6FF' : '#fff') + "'\""
                      + ">" + date_str + "</td>";
            }
        }
        dstr += "</tr>";
    }
    dstr += "</table>";

    // 建立或更新日曆容器
    if (document.getElementById("choose_date_czw_id") == null){
        var obj  = document.getElementById(date_id);
        var odiv = document.createElement("div");
        odiv.id = "choose_date_czw_id";
        odiv.innerHTML = dstr;
        odiv.style.position  = "absolute";
        odiv.style.border    = "1px #0CF solid";
        odiv.style.fontSize  = "12px";
        odiv.style.zIndex    = 99999;
        odiv.style.top  = obj.offsetTop + obj.offsetHeight + "px";
        odiv.style.left = obj.offsetLeft + "px";
        document.body.appendChild(odiv);
    } else {
        document.getElementById("choose_date_czw_id").style.display = "block";
        document.getElementById("choose_date_czw_id").innerHTML = dstr;
    }
}
</script>

演算法解析

閏年判斷。原文的 is_leap 寫法有明顯錯誤(year0、@0 都是無效語法),正確規則是:四年一閏、百年不閏、四百年再閏。上面已修正。

每月天數。[31, 28+is_leap, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31] 對應那句 traditional 韻語「一三五七八十臘,三十一日永不差;四六九冬三十日,唯有閏年二月廿九」。

日期推算。firstday 是當月一號是星期幾。第 i 列第 k 格的序號是 i*7+k,減去 firstday 再加 1 就是該格的日期數字。若結果 ≤ 0 或超過當月天數,就輸出空格子。這是月曆渲染最經典的做法。

列數計算。Math.ceil((天數 + firstday) / 7) 得出這個月需要幾列。例如 31 天且一號是週六(firstday=6),(31+6)/7 向上取整為 6 列。

定位。用 position: absolute 加上輸入框的 offsetTop/offsetLeft 把日曆擺在輸入框正下方。

原範例的幾個問題

getElementByIdx_x_x 是刻意改寫的。原文把 getElementById 寫成 getElementByIdx_x_x、createElement 寫成 document_createElement_x_x、appendChild 寫成 a(),這是為了避開部落格平台的關鍵字過濾。使用前必須全部改回正確名稱,否則完全跑不動。

日期格式不補零。year-month-day 會產生 2026-8-6 而非 2026-08-06,若要與資料庫或後端對齊,應該補零。

innerHTML 組字串。整份日曆用字串拼接,每次切月都重建 40 多個 td。這個規模還算可接受,但更現代的寫法是用 DOM API 建立後再更新文字。

id 是全域唯一的假設。日曆容器用固定 id choose_date_czw_id,代表同一頁只能有一個日曆實例。

現代替代方案

今天有兩個更好的選擇。第一是原生 <input type="date">,瀏覽器自帶日曆、 keyboard 操作、本地化、行動裝置的原生滾輪選擇器,全都免費:

<input type="date" id="add_date" />

第二是 <input type="date"> 搭配 min/max/step 屬性限制可選範圍,並用 CSS ::-webkit-calendar-picker-indicator 微調圖示。

若需要更豐富的功能(日期範圍選擇、 disable 特定日期、時區、月/週檢視),Flatpickr 是體積最小的選擇,Day.js 搭配自訂面板則是另一條路線。自己實作日曆的價值在於理解曆法計算與月曆渲染的邏輯,但正式專案請善用成熟方案——尤其是國際化(週起始日、月名、農曆)與可近性(鍵盤導覽、ARIA 標記)這兩塊,自製版本往往做得不夠完整。

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