Bootstrap 從 2013 年開始流行,除了本身完整又漂亮的 UI,社群為它開發的外掛與主題也非常豐富,擴充性極高。公司偏愛這類開源免費的框架,我也用得很順手。這次遇到需求是「開始時間與結束時間兩個選擇器,結束時間不能早於開始時間」,折騰了大半天才搞定,把過程記錄下來。
問題出在命名衝突:專案同時引入了 jQuery 與 jQuery UI,而 jQuery UI 裡也有一個叫 datepicker 的元件。我照著網路上的教學一直嘗試綁定 onSelect 事件,卻怎麼都不生效——查了才知道那些文章講的是 jQuery UI 的版本。翻了 lib 資料夾才發現,我們專案用的其實是 bootstrap_datepicker,API 完全不同。⊙﹏⊙b 汗
這也提醒一件事:引入多套 UI 函式庫時,同名元件互相覆蓋是很常見的問題,除錯前先確認「我用的到底是哪一個」。
$('#starttime').datepicker({
format: 'yyyy.mm.dd',
weekStart: 1,
autoclose: true,
todayBtn: 'linked',
language: 'zh-CN'
}).on('changeDate', function(ev){
var startTime = ev.date.valueOf();
if (startTime > end) {
alert("「評估開始時間」不能晚於「結束時間」!");
$("#starttime").focus();
}
start = startTime;
});
$('#endtime').datepicker({
format: 'yyyy.mm.dd',
weekStart: 1,
autoclose: true,
todayBtn: 'linked',
language: 'zh-CN'
}).on('changeDate', function(ev){
var endTime = ev.date.valueOf();
if (endTime < start) {
alert("「評估結束時間」不能早於「評估開始時間」!");
}
end = endTime;
});
Bootstrap 版的事件名稱是 changeDate,而不是 jQuery UI 的 onSelect,這是兩者最容易搞混的地方。事件回呼物件上的 date 是一個 Date instance,用 valueOf() 轉成毫秒數再比較最省事。
<div id="starttime_main" class="control-group"> <label class="control-label" for="starttime">開始時間:</label> <div class="date form_datetime controls" data-date="2013.05.10" id="starttimeDiv"> <input type="text" class="span9" value="" id="starttime" readonly> <span class="add-on"><i class="icon-calendar"></i></span> </div> </div> <div id="endtime_main" class="control-group"> <label class="control-label" for="endtime">結束時間:</label> <div class="controls date form_datetime" data-date="2013.05.10" id="endtimeDiv"> <input type="text" class="span9" value="" id="endtime" readonly> <span class="add-on"><i class="icon-calendar"></i></span> </div> </div>
輸入框加上 readonly 可以避免使用者手打不合格式的日期,是搭配日期選擇器時的實用小技巧。
除了事後跳出 alert,Bootstrap Datepicker 也支援用 setStartDate 與 setEndDate 直接限制可選範圍,讓使用者在日曆上根本選不到違規日期,體驗比彈窗提示好得多:
$('#starttime').datepicker(...).on('changeDate', function(ev){
$('#endtime').datepicker('setStartDate', ev.date);
});
另外,正式環境建議改用原生 <input type="date"> 或已停止維護的替代方案,Bootstrap Datepicker 這類老舊外掛在新版 Bootstrap 與現代瀏覽器上未必有維護支援。