jQuery 的 Datepicker 是許多開發者愛用的日期選擇元件,但預設顯示的是英文介面,而且點擊「Today」按鈕時,往往只是把日曆跳轉到當月,還得再點一次日期才能真正選中,操作起來相當不順手。以下整理了兩個實用技巧,一次解決這兩個惱人問題。
最簡單的方式是引入官方提供的語言包;若不想多發一個請求,也可以直接在 script 標籤後方註冊一份中文語系設定,重點是透過 regional 註冊後,再用 setDefaults 套用為全域預設。
jQuery(function ($) {
$.datepicker.regional['zh-CN'] = {
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-CN']);
});
原生的 _gotoToday 行為只會把游標移到今天,並不會把日期寫進輸入框。想要「一鍵完成」,只要覆寫這個內部方法,讓它在定位到今天之後,順便把日期選取並回傳給 input 即可。
$.datepicker._gotoToday = function (id) {
var target = $(id);
var inst = this._getInst(target[0]);
if (this._get(inst, 'gotoCurrent') && inst.currentDay) {
inst.selectedDay = inst.currentDay;
inst.drawMonth = inst.selectedMonth = inst.currentMonth;
inst.drawYear = inst.selectedYear = inst.currentYear;
}
else {
var date = new Date();
inst.selectedDay = date.getDate();
inst.drawMonth = inst.selectedMonth = date.getMonth();
inst.drawYear = inst.selectedYear = date.getFullYear();
this._setDateDatepicker(target, date);
this._selectDate(id, this._getDateDatepicker(target));
}
this._notifyChange(inst);
this._adjustDate(target);
}
套用後,使用者點一次「今天」,日期就會立刻出現在輸入框裡,省下多餘的點擊步驟。