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