DIV CSS 佈局教程網

Bootstrap 日期元件實戰:datetimepicker 與 daterangepicker 怎麼選
編輯:關於JavaScript     

Bootstrap 生態裡的日期元件大致分兩類:擅長「單一時間點」的 DateTimePicker,以及擅長「一段時間區間」的 DateRangePicker。搞懂兩者的定位,就不會為了選一個日期而引入龐大的區間控制項。

一、DateTimePicker:官方風格的單點選擇器

它需要先載入樣式、腳本、中文語系檔,以及底層依賴的 moment.js。順序有講究:moment 必須在元件之前。

 <link rel="stylesheet" href="css/bootstrap-datetimepicker.min.css">
<script src="js/moment.min.js"></script>
<script src="js/bootstrap-datetimepicker.min.js"></script>
<script src="js/bootstrap-datetimepicker.zh-CN.js"></script>

參數說明可對照官方文件:https://www.bootcss.com/p/bootstrap-datetimepicker/。

二、DateRangePicker:專為時間區間而生

這類元件最實用的地方是「常用區間快速鍵」,例如今日、昨日、最近七日、最近三十日,對報表查詢場景特別合適。

 <link rel="stylesheet" href="css/daterangepicker-bs3.css">
<script src="js/moment.min.js"></script>
<script src="js/daterangepicker.js"></script>

HTML 部分只需要一個容器,元件會自行注入內容:

 <div class="container-fluid">
 <div class="row-fluid" style="margin-top:5px">
  <div class="span4">
   <div class="control-group">
    <label class="control-label">日期:</label>
    <div class="controls">
     <div id="reportrange" class="pull-left dateRange" style="width:350px">
      <i class="glyphicon glyphicon-calendar fa fa-calendar"></i>
      <span id="searchDateRange"></span>
      <b class="caret"></b>
     </div>
    </div>
   </div>
  </div>
 </div>
</div>

三、初始化設定

幾個實務上常用的參數:maxDate 限制不能選未來、dateLimit 限制區間跨度、timePicker 打開時分選擇、locale 一次搞定所有中文標籤。

 $(document).ready(function (){
 //預設顯示「一小時前 ~ 現在」
 $('#reportrange span').html(
  moment().subtract('hours', 1).format('YYYY-MM-DD HH:mm:ss') + ' - ' +
  moment().format('YYYY-MM-DD HH:mm:ss')
 );

 $('#reportrange').daterangepicker({
  maxDate: moment(),          //最大時間:不允許選未來
  dateLimit: { days: 30 },     //起訖最大間隔
  showDropdowns: true,
  showWeekNumbers: false,
  timePicker: true,
  timePickerIncrement: 60,     //時間增量,單位分鐘
  timePicker12Hour: false,     //使用 24 小時制
  ranges: {
   '今日': [moment().startOf('day'), moment()],
   '昨日': [moment().subtract('days', 1).startOf('day'), moment().subtract('days', 1).endOf('day')],
   '最近7日': [moment().subtract('days', 6), moment()],
   '最近30日': [moment().subtract('days', 29), moment()]
  },
  opens: 'right',
  buttonClasses: ['btn btn-default'],
  applyClass: 'btn-small btn-primary blue',
  cancelClass: 'btn-small',
  format: 'YYYY-MM-DD HH:mm:ss',
  separator: ' to ',
  locale: {
   applyLabel: '確定',
   cancelLabel: '取消',
   fromLabel: '起始時間',
   toLabel: '結束時間',
   customRangeLabel: '自定義',
   daysOfWeek: ['日','一','二','三','四','五','六'],
   monthNames: ['一月','二月','三月','四月','五月','六月','七月','八月','九月','十月','十一月','十二月'],
   firstDay: 1
  }
 }, function(start, end, label){
  $('#reportrange span').html(
   start.format('YYYY-MM-DD HH:mm:ss') + ' - ' + end.format('YYYY-MM-DD HH:mm:ss')
  );
 });
 });

四、與 DataTables 搭配:選完時間就重查

報表頁最常見的組合是「日期控制項 + 表格」。做法是把日期字串塞進 DataTables 的額外參數,再監聽 apply.daterangepicker 事件觸發 ajax.reload()。

 var table;
$(function () {
 table = $('#example').DataTable({
  "ajax": {
   "url": "/example/resources/server_processing_customCUrl.php",
   "data": function ( d ) {
    //把日期區間當成額外參數送給後端
    d.extra_search = $('#reportrange span').html();
   }
  },
  "processing": true,
  "serverSide": true,
  "language": {
   "sProcessing": "處理中...",
   "sLengthMenu": "顯示 _MENU_ 項結果",
   "sZeroRecords": "沒有匹配結果",
   "sInfo": "顯示第 _START_ 至 _END_ 項結果,共 _TOTAL_ 項",
   "sInfoEmpty": "顯示第 0 至 0 項結果,共 0 項",
   "sInfoFiltered": "(由 _MAX_ 項結果過濾)",
   "sSearch": "搜索:",
   "sEmptyTable": "表中數據為空",
   "sLoadingRecords": "載入中...",
   "oPaginate": { "sFirst": "首頁", "sPrevious": "上頁", "sNext": "下頁", "sLast": "末頁" }
  },
  "dom": "<'row'<'span9'l<'#mytoolbox'>><'span3'f>r>t<'row'<'span6'i><'span6'p>>",
  initComplete: initComplete
 });

 function initComplete(){
  var dataPlugin =
   '<div id="reportrange" class="pull-left dateRange" style="width:400px;margin-left:10px">' +
   '日期:<i class="glyphicon glyphicon-calendar fa fa-calendar"></i>' +
   '<span id="searchDateRange"></span><b class="caret"></b></div>';
  $('#mytoolbox').append(dataPlugin);

  $('#reportrange span').html(
   moment().subtract('hours', 1).format('YYYY-MM-DD HH:mm:ss') + ' - ' +
   moment().format('YYYY-MM-DD HH:mm:ss')
  );

  $('#reportrange').daterangepicker({
   maxDate: moment(),
   dateLimit: { days: 30 },
   showDropdowns: true,
   timePicker: true,
   timePickerIncrement: 60,
   timePicker12Hour: false,
   ranges: {
    '今日': [moment().startOf('day'), moment()],
    '昨日': [moment().subtract('days', 1).startOf('day'), moment().subtract('days', 1).endOf('day')],
    '最近7日': [moment().subtract('days', 6), moment()],
    '最近30日': [moment().subtract('days', 29), moment()]
   },
   opens: 'right',
   format: 'YYYY-MM-DD HH:mm:ss',
   separator: ' to ',
   locale: {
    applyLabel: '確定', cancelLabel: '取消',
    fromLabel: '起始時間', toLabel: '結束時間', customRangeLabel: '自定義',
    daysOfWeek: ['日','一','二','三','四','五','六'],
    monthNames: ['一月','二月','三月','四月','五月','六月','七月','八月','九月','十月','十一月','十二月'],
    firstDay: 1
   }
  }, function(start, end){
   $('#reportrange span').html(
    start.format('YYYY-MM-DD HH:mm:ss') + ' - ' + end.format('YYYY-MM-DD HH:mm:ss')
   );
  });

  //可選:依後端回傳的條件,反白對應的快速鍵
  var dateOption;
  if ("${riqi}" == 'day')      { dateOption = "今日"; }
  else if ("${riqi}" == 'yday')   { dateOption = "昨日"; }
  else if ("${riqi}" == 'week')   { dateOption = "最近7日"; }
  else if ("${riqi}" == 'month')  { dateOption = "最近30日"; }
  else if ("${riqi}" == 'year')   { dateOption = "最近一年"; }
  else                 { dateOption = "自定義"; }
  $(".daterangepicker").find("li").each(function (){
   if ($(this).hasClass("active")) { $(this).removeClass("active"); }
   if (dateOption == $(this).html()) { $(this).addClass("active"); }
  });

  //選完時間就重新拉資料
  $("#reportrange").on('apply.daterangepicker', function(){
   table.ajax.reload();
   var args = table.ajax.params();
   console.log("額外傳到後台的參數 extra_search:" + args.extra_search);
  });
 }
});

關於漢化與選型的小提醒

月份名稱顯示異常時,優先檢查 moment 的語系檔是否正確載入,而不是直接改 moment.min.js——壓縮檔一改,下次升版就白工。透過 locale 參數或載入對應語系檔才是長久之計。

至於選哪一個:daterangepicker.com 官網文件最完整,但操作習慣偏重;若是 Bootstrap 3 專案,daterangepicker-bs3 的整合度更順手。先想清楚你要的是「一個時間點」還是「一段區間」,答案通常就出來了。

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