DIV CSS 佈局教程網

輕量原生 JS 日曆元件 calendar.js 使用指南
編輯:關於JavaScript     

日期選擇器是表單必備元件,但多數成熟方案體積都不小。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">,它自帶行動裝置的原生選擇器與基本驗證;若必須自訂外觀,則可考慮有完整無障礙支援的日期選擇套件。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved