jQuery Tools 內建的 dateinput 元件,只要一個 <input type="date"> 就能變出完整的日曆選擇面板,是早期前端開發相當省力的做法。本文整理它的引入方式、樣式套用以及中文化設定。
出發點可以參考官方文件,接著準備三個部分:jQuery Tools 主程式、日期語言包,以及面板樣式表。
<!DOCTYPE html>
<html>
<head>
<title>jQuery Tools dateinput demo</title>
<!-- 載入 jQuery Tools 主程式 -->
<script src="https://cdn.jquerytools.org/1.2.7/full/jquery.tools.min.js"></script>
<!-- 中文語言包 -->
<script src="./jquery.tools.date-zh-CN.js"></script>
<link rel="stylesheet" type="text/css"
href="https://jquerytools.org/media/css/dateinput/large.css"/>
<style>
.date { width: 357px; }
#calhead { padding-left: 95px; }
#caltitle { background-color: #fff; }
#calnext { float: left; }
</style>
</head>
<body>
<div style="width:360px; margin:0 auto;">
<!-- value 設為 0 時,會以預設格式帶入今天日期 -->
<input type="date" name="test" value="0" />
</div>
<script>
$(function () {
$(":date").dateinput({
lang: 'zh-CN',
format: 'dddd dd, mmmm yyyy',
offset: [30, 0]
});
});
</script>
</body>
</html>
不必自己重畫日曆外觀,樣式表可直接引用官方提供的 large.css,再視版面需求用幾行 CSS 微調寬度與位置即可,像上面的 .date、#calhead、#caltitle 就是常見的覆寫範例。
中文顯示靠的是一份語言包,內容其實非常單純,就是把月份與星期的文字換成中文:
jQuery(function () {
$.tools.dateinput.localize("zh-CN", {
months: '一月,二月,三月,四月,五月,六月,七月,' +
'八月,九月,十月,十一月,十二月',
shortMonths: '一,二,三,四,五,六,七,' +
'八,九,十,十一,十二',
days: '星期日,星期一,星期二,星期三,星期四,星期五,星期六',
shortDays: '日,一,二,三,四,五,六'
});
});
lang: 'zh-CN' 就能對應到上面註冊的 zh-CN。shortMonths 中「五」被誤植為「無」,實際使用時記得修正,否則五月會顯示成錯字。dateinput 的入門就到這裡,接下來可以接著看同系列的 tab、slideshow 等元件。