萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery UI Datepicker 中文化與進階應用:日期範圍選擇實作

前言

jQuery UI Datepicker 是經典日期選擇元件。本文涵蓋中文化設定、雙日期欄位(起始/結束)聯動、圖示觸發、唯讀防鍵盤輸入等實務技巧。

中文化設定

$.datepicker.regional['zh-TW'] = {
  closeText: '關閉',
  prevText: '<上月',
  nextText: '下月>',
  currentText: '今天',
  monthNames: ['一月','二月','三月','四月','五月','六月',
               '七月','八月','九月','十月','十一月','十二月'],
  monthNamesShort: ['一月','二月','三月','四月','五月','六月',
                    '七月','八月','九月','十月','十一月','十二月'],
  dayNames: ['星期日','星期一','星期二','星期三','星期四','星期五','星期六'],
  dayNamesShort: ['週日','週一','週二','週三','週四','週五','週六'],
  dayNamesMin: ['日','一','二','三','四','五','六'],
  weekHeader: '週',
  dateFormat: 'yy/mm/dd',
  firstDay: 1,
  isRTL: false,
  showMonthAfterYear: true,
  yearSuffix: '年'
};
$.datepicker.setDefaults($.datepicker.regional['zh-TW']);

HTML 結構

<label for="start-date">起始日期:</label>
<input type="text" id="start-date" class="datepicker" readonly>
<label for="end-date">結束日期:</label>
<input type="text" id="end-date" class="datepicker" readonly>

聯動初始化

let startDateVal = '2024/01/01';
let endDateVal = new Date();

$('#start-date, #end-date').datepicker({
  changeMonth: true,
  changeYear: true,
  showOn: 'both',
  buttonImage: 'calendar.gif',
  buttonImageOnly: true,
  showButtonPanel: true,
  onSelect: function(dateText, inst) {
    const id = this.id;
    if (id === 'start-date') {
      startDateVal = dateText;
      $('#end-date').datepicker('option', 'minDate', dateText);
    } else {
      endDateVal = dateText;
      $('#start-date').datepicker('option', 'maxDate', dateText);
    }
  }
});

$('#start-date').datepicker('setDate', startDateVal);
$('#end-date').datepicker('setDate', endDateVal);

常用選項速查

選項說明
minDate/maxDate限制可選日期範圍
beforeShowDay自訂每日樣式/可用性(如禁用週末)
onChangeMonthYear月份/年份切換回呼
numberOfMonths顯示多個月曆

總結

Datepicker 功能強大但體積較大。現代專案可考慮輕量替代方案:flatpickr、date-fns + 自訂 UI、或原生 <input type="date">(支援度已足夠)。

copyright © 萬盛學電腦網 all rights reserved