DIV CSS 佈局教程網

淘寶旅行風格通用日曆組件:以 YUI 模組方式載入
編輯:關於JavaScript     

訂房、訂票這類網站對日曆的要求遠高於一般表單:要能一次顯示多個月、要標出節假日、要限定可選日期區間,還得支援下拉式快速跳年月。淘寶旅行開放的這套通用日曆組件把這些都包好了,本文說明它的載入方式與常用設定。

線上預覽

https://demo.jb51.net/js/2015/trip-calendar/demo.html

使用時需要一併取得 trip-calendar.js 與 trip-calendar.css 兩個檔案。

組件的幾個亮點

1. 支援一次渲染 1 至 4 個月的日曆,跨月選日期很方便。

2. 可切換是否顯示節假日資訊。

3. 支援 minDate / maxDate / afterDays 三種日期區間限制方式。

4. 可切換成下拉表單選年月,或直接嵌入頁面成為非彈出式日曆。

完整示例程式碼

<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="author" content="angtian">
<meta name="description" content="淘寶旅行通用日曆組件 Demo1">
<meta name="keywords" content="日曆, 日曆組件, 淘寶旅行日曆">
<title>淘寶旅行通用日曆組件 Demo1</title>
<style>
  body{padding:0;margin:0 10px;text-align:center;}
  .title{padding:0;margin:10px 0;font:700 18px/1.5 微軟雅黑;}
  .title a{font:400 14px/1.5 Tahoma;margin-left:20px;}
  .example{margin-top:10px;}
  .example button{margin:0 5px 10px 0;}
  .calendar{display:inline-block;}
</style>

<!-- 以 YUI 的模組 loader 按需載入 -->
<script src="https://yui.yahooapis.com/3.5.1/build/yui/yui-min.js"></script>
<script>
var root = 'https://fgm.cc/learn/calendar/trip-calendar/';

YUI({
  modules: {
    'trip-calendar': {
      fullpath: root + 'trip-calendar.js',
      type: 'js',
      requires: ['trip-calendar-css']
    },
    'trip-calendar-css': {
      fullpath: root + 'trip-calendar.css',
      type: 'css'
    }
  }
}).use('trip-calendar', function (Y) {

  /**
   * 非彈出式日曆實例
   * 直接將日曆插入到頁面指定容器內
   */
  var oCal = new Y.TripCalendar({
    container: '#J_Calendar',   // 非彈出式日曆時必選
    selectedDate: new Date      // 指定預選日期
  });

  // 日期點擊事件
  oCal.on('dateclick', function () {
    var selectedDate = this.get('selectedDate');
    alert(selectedDate + '\u3010' + this.getDateInfo(selectedDate) + '\u3011');
  });

  // 用事件委派處理所有控制按鈕
  Y.one('#J_Example').delegate('click', function (e) {
    var oTarget = e.currentTarget;
    var value = oTarget.getAttribute('data-value');

    switch (true) {
      case oTarget.hasClass('J_Count'):        // 日曆個數
        this.set('count', value).render();
        break;
      case oTarget.hasClass('J_showHoliday'):  // 顯示節假日
        this.set('isHoliday', true).render();
        break;
      case oTarget.hasClass('J_hideHoliday'):  // 隱藏節假日
        this.set('isHoliday', false).render();
        break;
      case oTarget.hasClass('J_Limit'):        // 時間範圍限定
        this.set('minDate', new Date())
            .set('maxDate', '')
            .set('afterDays', value)
            .set('date', new Date());
        break;
      case oTarget.hasClass('J_InitDate'):     // 指定初始日期
        this.set('minDate', value)
            .set('maxDate', '2012-12-21')
            .set('date', value);
        break;
      case oTarget.hasClass('J_Select'):       // 下拉表單選擇時間
        this.set('isSelect', true).render();
        Y.all('.J_Count').slice(1).set('disabled', true);
        break;
      case oTarget.hasClass('J_SelectOff'):    // 取消下拉表單選擇
        this.set('isSelect', false).render();
        Y.all('.J_Count').slice(1).set('disabled', false);
        break;
    }
  }, 'button', oCal);
});
</script>
</head>
<body>
<h1 class="title">淘寶旅行通用日曆組件 Demo1
  <a href="Demo1.html">Demo1</a>
  <a href="Demo2.html">Demo2</a>
  <a href="Demo3.html">Demo3</a>
  <a href="api.html" target="_blank">API 文檔</a>
</h1>

<div id="J_Example" class="example">
  <button class="J_Count" data-value="1">單日曆</button>
  <button class="J_Count" data-value="2">雙日曆</button>
  <button class="J_Count" data-value="3">三日曆</button>
  <button class="J_Count" data-value="4">四日曆</button>
  <br />
  <button class="J_showHoliday">顯示節假日</button>
  <button class="J_hideHoliday">隱藏節假日</button>
  <br />
  <button class="J_Limit" data-value="90">限定範圍(今天 → 90 天)</button>
  <button class="J_InitDate" data-value="2012-10-01">指定初始日期(2012 年 10 月)</button>
  <button class="J_InitDate" data-value="">取消範圍限定</button>
  <br />
  <button class="J_Select">下拉表單選擇時間</button>
  <button class="J_SelectOff">取消下拉表單選擇</button>
</div>

<div id="J_Calendar" class="calendar"></div>
</body>
</html>

幾個實作上的提醒

1. container 只在非彈出式時必填。若要以彈出視窗形式使用,改傳 input 元素的參考即可。

2. 改設定後記得呼叫 render()。count、isHoliday 這類屬性變更不會自動重繪,必須顯式渲染。

3. afterDays 與 minDate/maxDate 是互斥思路。要「今天起 90 天內」就用 afterDays;要指定絕對區間就用 min/max,兩者同時給可能互相打架。

4. 用事件委派綁控制項。範例中把 click 綁在容器上而非每顆按鈕,之後動態增減按鈕也不必重新綁定,是很值得沿用的做法。

5. 範例中的 YUI 與 fgm.cc 資源位址年代較早,實際導入時請替換為可訪問的 CDN 或自行下載部署。

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