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']);
<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">(支援度已足夠)。