日期選擇器是表單必備元件,但多數成熟方案體積都不小。calendar.js 走的是極簡路線:只依賴一個 JS 檔與一份 CSS,支援 CMD 模組化載入,樣式表可自由替換成自訂皮膚。
引入 calendar.js 或壓縮後的 calendar.min.js,並掛上 calendar.css。樣式與邏輯分離得很乾淨,因此想換成自家設計語言時,只需改寫 CSS 而不必動腳本。此外它支援 CMD 規範,可與 SeaJS 一類的載入器搭配。
xvDate({ 'targetId':'date1',//時間寫入對象的id 'triggerId':['date1','dateBtn1'],//觸發事件的對象id 'alignId':'datesWrap1',//日歷對齊對象 'format':'-',//時間格式 默認'YYYY-MM-DD HH:MM:SS' 'min':'2014-09-20 10:00:00',//最大時間 'max':'2014-10-30 10:00:00'//最小時間 });
targetId 是日期寫入的目標元素 id,必填。triggerId 為觸發日曆的物件 id,可傳陣列同時對應多個觸發點,不設則預設等於 targetId。alignId 決定日曆彈出時以哪個元素為對齊基準,同樣預設為 targetId。
hms 控制是否啟用時分秒:'on'(預設)會產生 2014-09-20 10:00:00 這種格式,'off' 則只到日期。format 決定分隔符號,預設 '-' 即 2014-09-20,改為 '/' 則是 2014/09/20。min 與 max 分別設定可選的起訖時間,格式需與前面一致。zIndex 則是日曆層級,預設 9999。
若採用 CMD,在需要的地方 require 即可:
define('mod1',[],function(require, exports, module){ var xvDate = require("xvDate"); })
這類手寫日曆的優點是體積小、可依賴少、樣式好改;代價則是鍵盤操作、ARIA 標記與國際化通常不夠完整。若專案需要服務多元使用者,建議評估原生 <input type="date">,它自帶行動裝置的原生選擇器與基本驗證;若必須自訂外觀,則可考慮有完整無障礙支援的日期選擇套件。