DIV CSS 佈局教程網

輕量原生 JS 日曆元件 calendar.js 使用指南
編輯:JavaScript綜合知識     

日期選擇器是表單必備的元件。這個以原生 JavaScript 寫成的日曆 plugin 體積小、依賴少,點一下文字提示就會彈出含年月的日曆視窗,可切換年、月並點選日期,各大瀏覽器都能正常運作。

使用步驟

  1. 引入 calendar.js 或壓縮版 calendar.min.js。
  2. 引入 calendar.css 樣式表;想要換皮膚的話直接改這份 CSS 即可。
  3. 此日曆支援 CMD 模組化規範。

呼叫方式

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' 則只到日期(2014-09-20)。
  • format:日期分隔符號,預設 '-';設為 '/' 則輸出 2014/09/20。
  • min:最小時間限制,格式需與前面設定一致。
  • max:最大時間限制,格式需與前面設定一致。
  • zIndex:日曆層級,預設 9999。

模組化寫法

若使用 CMD/SeaJS 之類的載入器,在依賴模組中引入即可:

define('mod1', [], function (require, exports, module) {
    var xvDate = require("xvDate");
});

使用提醒

設定 min 與 max 時務必注意格式要與 format 一致,混用 - 與 / 是最常見的踩坑點。另外這個元件年代較早,若用於新專案,建議評估原生 <input type="date"> 或 date-fns、flatpickr 等現代方案——原生 date input 自帶行動裝置的原生滾輪選擇器,行動體驗通常更好。

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