DIV CSS 佈局教程網

Bootstrap Datepicker 使用心得:起訖時間連動與踩雷記錄
編輯:關於JavaScript     

Bootstrap 從 2013 年開始流行,除了本身完整又漂亮的 UI,社群為它開發的外掛與主題也非常豐富,擴充性極高。公司偏愛這類開源免費的框架,我也用得很順手。這次遇到需求是「開始時間與結束時間兩個選擇器,結束時間不能早於開始時間」,折騰了大半天才搞定,把過程記錄下來。

踩到的坑

問題出在命名衝突:專案同時引入了 jQuery 與 jQuery UI,而 jQuery UI 裡也有一個叫 datepicker 的元件。我照著網路上的教學一直嘗試綁定 onSelect 事件,卻怎麼都不生效——查了才知道那些文章講的是 jQuery UI 的版本。翻了 lib 資料夾才發現,我們專案用的其實是 bootstrap_datepicker,API 完全不同。⊙﹏⊙b 汗

這也提醒一件事:引入多套 UI 函式庫時,同名元件互相覆蓋是很常見的問題,除錯前先確認「我用的到底是哪一個」。

JavaScript 部分

$('#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() 轉成毫秒數再比較最省事。

HTML 結構

<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 與現代瀏覽器上未必有維護支援。

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