jQuery UI 的 datepicker() 是網站後台最常出現的日曆元件。它的所有選項都遵循同一套「初始化 / 讀取 / 設定」三段式介面,先把這個規則記住,剩下的參數查表即可。
// 初始化
$('.selector').datepicker({ dateFormat: 'yy-mm-dd' });
// 讀取目前設定
var fmt = $('.selector').datepicker('option', 'dateFormat');
// 於執行期變更設定
$('.selector').datepicker('option', 'dateFormat', 'yy-mm-dd');
'mm/dd/yy'):控制日期字串的顯示格式,yy 為四位年、m 為月、d 為日。'(yyyy-mm-dd)'。+7 表示今天之後七天)或字串('+1m +7d')。'+10'):兩位數年份的判定門檻,超過則視為上一個世紀。'-10:+10'):年份下拉選單的範圍,支援相對(-nn:+nn)與絕對(2000:2010)兩種寫法。[2, 3] 代表兩列三欄。focus(預設)、button、both。show、fold、slideDown;若想關閉動畫可搭配 duration 設為 0。{ direction: 'up' }。slow/normal/fast 或毫秒數。'Done')與 currentText(預設 'Today'):分別設定關閉鈕與今天鈕的文字,兩者都需先開啟 showButtonPanel。Su Mo Tu。實務上很少手寫這些陣列,直接引入官方提供的 i18n 語言包(如 jquery.ui.datepicker-zh-TW.js)即可一次搞定。
面板顯示之前觸發,參數是目前的 input 元素,可用來動態調整設定。
面板上每一天在綁定時都會呼叫一次,必須回傳一個陣列:
[可選與否(true/false), 該日的 CSS class 名稱, 滑鼠移入的提示文字]
要「週六日不可預約」或「已額滿的日期標灰」,都靠這個回呼。
切換月份或年份時觸發,常用來同步更新旁邊的統計數字。
選定日期後觸發,dateText 為格式化後的字串,inst 為元件實例。
面板關閉時觸發,無論是否有選日期都會執行。
$("#date").datepicker({
dateFormat: "yy-mm-dd",
changeMonth: true,
changeYear: true,
showMonthAfterYear: true,
yearRange: "2020:2030",
minDate: 0, // 不可選過去
maxDate: "+1m",
showButtonPanel: true,
currentText: "今天",
closeText: "關閉",
beforeShowDay: function (date) {
var day = date.getDay();
return [day !== 0 && day !== 6, ""]; // 週末不可選
},
onSelect: function (dateText) {
console.log("已選擇:" + dateText);
}
});
把「格式、範圍、面板行為、多語系、事件」這五個維度分開思考,日曆元件就不再是一堆難以理解的參數,而是可以按需組裝的積木。