DIV CSS 佈局教程網

Bootstrap DatePicker 實作日期區間限制:開始與結束日期互相牽制
編輯:AJAX基礎知識     

做日期選擇時,幾乎一定會遇到這類需求:兩個輸入框分別代表開始與結束日期,並且必須滿足「開始不大於結束」、「結束不小於開始」,有時還加上「兩者都不能晚於今天」。

你可以等使用者選完之後再驗證結果是否正確,但更好的做法是讓日期元件本身就把不合理的选择直接排除掉,從源頭避免錯誤輸入。

選哪個元件

Bootstrap 生態有兩個常見選擇:DatePicker 與 DateTimePicker。兩者功能相近、用法類似,其中 DatePicker 支援的事件與設定選項更完整。

查 API 可以發現,日期變動時會觸發 changeDate 事件,我們可以在回呼裡做出反應。不過有個遺憾:如果是直接在使用者於輸入框打字或刪除,這個事件似乎不會被觸發。因此實務上會把 input 加上 readonly 屬性,切換為唯讀狀態,並提供一個清除按鈕,讓日期變動只能透過日期元件本身發生,行為就可控了。

另一個實測踩到的坑:使用 DateTimePicker 並按下清除鈕時,會拋出 Uncaught TypeError: Cannot read property 'getTime' of null,結果連 changeDate 也一起失效。因此這裡改用 DatePicker。

做法

當其中一個輸入框的日期變動(包含被清除)時,changeDate 觸發,我們在回呼裡去調整另一個輸入框的可選範圍:改了開始日期,就設定結束日期的下界;改了結束日期,就設定開始日期的上界。

另外,若要讓 DatePicker 顯示中文介面,記得額外載入語言包 bootstrap-datepicker.zh-CN.min.js。

程式碼

function DatePicker(beginSelector, endSelector) {
    // 起始日:僅選日期
    $(beginSelector).datepicker({
        language: "zh-CN",
        autoclose: true,
        startView: 0,
        format: "yyyy-mm-dd",
        clearBtn: true,
        todayBtn: false,
        endDate: new Date()          // 不能晚於今天
    }).on('changeDate', function (ev) {
        if (ev.date) {
            // 開始日變了,結束日不可早於它
            $(endSelector).datepicker('setStartDate', new Date(ev.date.valueOf()));
        } else {
            $(endSelector).datepicker('setStartDate', null);
        }
    });

    // 結束日
    $(endSelector).datepicker({
        language: "zh-CN",
        autoclose: true,
        startView: 0,
        format: "yyyy-mm-dd",
        clearBtn: true,
        todayBtn: false,
        endDate: new Date()
    }).on('changeDate', function (ev) {
        if (ev.date) {
            // 結束日變了,開始日不可晚於它
            $(beginSelector).datepicker('setEndDate', new Date(ev.date.valueOf()));
        } else {
            $(beginSelector).datepicker('setEndDate', new Date());
        }
    });
}

DatePicker("#date_begin", "#date_end");

幾個容易忽略的細節

setStartDate 與 setEndDate 是「設定可選下界/上界」,不是「設定選中的值」,兩者不要混淆。要指定預設值請用 setDate。

清除按鈕的處理值得留意:使用者把開始日期清空後,結束日期原本被限制的下界必須放開,否則會出現「開始是空的、結束卻不能選」的尷尬狀態,程式中 setStartDate(null) 就是為了處理這點。

最後,這種雙向牽制永遠只是使用者體驗的優化。使用者仍可能撓過前端(例如直接改 DOM 或自己發請求),所以後端收到日期區間時,一定要再驗證一次 start 不大於 end。

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