<!-- CSS -->
<link rel="stylesheet" href="calendar.css">
<!-- JS: 全局變量 -->
<script src="calendar.min.js"></script>
<!-- 或 AMD/CMD -->
<script>require(['calendar'], function(calendar) { ... });</script>
<!-- 或 ES Module -->
<script type="module">import Calendar from './calendar.esm.js'; ...</script>
<input type="text" id="dateInput" readonly>
<button id="dateBtn">選擇日期</button>
<script>
calendar.init({
targetId: 'dateInput', // 日期寫入目標 input
triggerId: ['dateInput', 'dateBtn'], // 觸發元素(可多個)
alignId: 'dateInput', // 定位基準元素
format: '-', // 日期分隔符:'-' | '/' | '.'
hms: 'on', // 'on' 含時分秒,'off' 僅日期
min: '2024-01-01 00:00:00', // 最小可選時間
max: '2025-12-31 23:59:59', // 最大可選時間
zIndex: 9999
});
</script>
| 參數 | 類型 | 默認值 | 說明 |
|---|---|---|---|
| targetId | String | 必填 | 日期寫入的 input id |
| triggerId | String/Array | targetId | 觸發彈出的元素 id |
| alignId | String | targetId | 彈層定位參考元素 id |
| format | String | '-' | 日期分隔符:'-'/'/'/'.' |
| hms | String | 'on' | 'on' 顯示時分秒,'off' 僅日期 |
| min | String | null | 最小時間,格式同輸出 |
| max | String | null | 最大時間 |
| zIndex | Number | 9999 | 彈層層級 |
| lang | String | 'zh-CN' | 語言:zh-CN/en-US/ja-JP... |
| firstDay | Number | 0 | 週起始日:0=周日,1=周一 |
| onSelect | Function | null | 選擇後回調 function(dateStr, dateObj) |
:root {
--cal-bg: #fff;
--cal-border: #e0e0e0;
--cal-header-bg: #007bff;
--cal-header-color: #fff;
--cal-week-color: #666;
--cal-day-color: #333;
--cal-day-hover: #e8f4fd;
--cal-day-selected: #007bff;
--cal-day-selected-color: #fff;
--cal-day-disabled: #f5f5f5;
--cal-day-disabled-color: #ccc;
--cal-today-ring: #007bff;
--cal-radius: 8px;
--cal-shadow: 0 4px 20px rgba(0,0,0,.15);
}
.dark-theme {
--cal-bg: #1e1e1e;
--cal-border: #333;
--cal-header-bg: #333;
--cal-day-color: #ddd;
--cal-day-hover: #333;
--cal-day-selected: #00bfff;
--cal-day-disabled: #2a2a2a;
--cal-day-disabled-color: #666;
}
運行時切換:document.documentElement.classList.add('dark-theme') 即可無縫換膚。
// Webpack/ESM
import Calendar from 'calendar.js';
const cal = new Calendar({
targetId: 'date1',
triggerId: 'date1',
onSelect: (str, date) => console.log('選中:', str, date)
});
// RequireJS
define(['calendar'], function(Calendar) {
new Calendar({ targetId: 'date2', hms: 'off' });
});
// CMD (SeaJS)
seajs.use('calendar', function(Calendar) {
new Calendar({ targetId: 'date3' });
});
// 單頁應用路由切換時銷毀
const cal = calendar.init({ targetId: 'dateInput', ... });
// 路由離開時
cal.destroy(); // 移除 DOM、事件監聽、定時器
alignId 元素必須可見且有佈局尺寸,隱藏元素無法定位。min/max 格式必須與 format + hms 一致。zIndex 或檢查父級 overflow:hidden/transform 產生新堆疊上下文。focus 滾動容器進視口,或用 position:fixed 彈層。calendar.js 以「輕量、零依賴、多模塊、CSS 變量主題」定位輕量級日期選擇需求。核心 API 極簡:init(config) + destroy()。現代項目可直接用 <input type="date/datetime-local"> 原生控件(樣式受限),或引入 Flatpickr/Date-fns 等功能更豐富的庫。