DIV CSS 佈局教程網

JavaScript 日曆控制項分享:JSLite Calendar 安裝與擴充用法
編輯:關於JavaScript     

本文分享一個外觀相當清爽的 JavaScript 日曆控制項,基於 JSLite 撰寫,同時相容 JSLite 與 jQuery 的呼叫風格,適合需要輕量方案又不想引入整套 jQuery UI 的專案。

搭配的底層函式庫:JSLite.js(官網 JSLite.io),可相容 JSLite 與 jQuery。

安裝方法

頁面上先準備容器,再依序引入 JSLite 與日曆外掛:

<div id="JSLiteCalenbar4"><input type="text"></div>

<script type="text/javascript" src="../JSLite.js"></script>
<script type="text/javascript" src="JSLite.Calendar.js"></script>
<script type="text/javascript">
var cal = new $.calendar($("#JSLiteCalenbar4")[0], function (date) {
  console.log(date);   // 回傳變更後的時間值,例如 2014-10-11
  $('#JSLiteCalenbar4 input').val(date);
})
.hide()
.time("yyyy/MM月dd日 hh:mm:ss", 'default');

console.log(cal);
</script>

可選的擴充方法

  • hidePrevBtn:隱藏「上一頁」按鈕,常用於只允許選擇未來日期、不讓使用者翻閱歷史的情境。
  • hide:改為點擊時才顯示面板,避免頁面載入時就佔據版面。
  • setDate:以 JSON 形式設定初始時間。
  • time:設定是否可選擇時分,第一個參數是顯示格式字串,第二個參數傳 'default' 會使用 input 中既有的值或指定時間作為初始值。

hide:點擊才顯示

<div id="JSLiteCalenbar2"><div>點擊顯示</div></div>

<script type="text/javascript">
var obj3 = document.getElementById("JSLiteCalenbar2");
new $.calendar(obj3, { "now": "2014-09-15" }, function (date) {
  console.log(date);   // 回傳變更後的時間值
}).hide();
</script>

進階用法一:指定可選日期與顯示範圍

透過回傳 JSON 的函式,可以告訴控制項「目前的伺服器時間」、「是否允許改動以前的內容」、「一次顯示幾個月的日曆」,以及「哪些日期是工作日」:

var cal = new JSLite.calendar(obj, function () {
  return {
    "now": "2014-09-15",   // 伺服器當前時間
    "change": true,        // 是否允許改動當前時間以前的內容
    "interfaceNum": 3,     // 一次顯示幾個月的日曆
    "workdate": [
      { "date": "2013-12", "day": ["1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "20"] },
      { "date": "2014-09", "day": ["10", "2", "3", "4", "5", "6", "20"] },
      { "date": "2014-05", "day": ["10", "2", "3", "4", "5", "6", "20"] },
      { "date": "2014-10", "day": ["12", "2", "3", "4", "5", "6", "20"] }
    ]
  };
}, function (date) {
  // 回傳被選到的日期,多選時為陣列,例如 ["2014-10-10,0", "2014-10-11,0"]
  console.log(date);
}).hidePrevBtn();

進階用法二:串起多個選項

這個控制項的設計不錯的一點是方法可以串接(method chaining),因此「只顯示未來、點擊才展開」可以一行寫完:

new JSLite.calendar(obj3, function (date) {
  console.log(date);
}).hidePrevBtn().hide();

使用建議

串接式 API 讀起來乾淨,但要注意 time() 這類會改變顯示格式的設定,最好放在鏈的最後呼叫,否則後續設定有可能把格式覆蓋掉。

另外提醒兩點實務考量。第一,程式把「伺服器時間」當作可選範圍的基準,這個設計是對的——用瀏覽器時間會被使用者本機時鐘影響,涉及訂單、報表等商業邏輯時容易出錯。第二,這個控制項屬於較早期的作品,若要在今日的專案中上線,建議先確認它在目標瀏覽器(尤其行動裝置)上的表現;行動端若要 Питанняate 體驗,直接改用 <input type="date"> 會讓系統原生選擇器接手,通常更符合使用者習慣。

以上就是本文的全部內容,希望對大家的學習有所幫助。

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