在網頁顯示實時更新的日期時間(年月日、星期、時分秒),作為頁面裝飾或業務時間參考。
/**
* 實時時鐘組件
* @param {string|HTMLElement} container - 容器選擇器或 DOM 元素
* @param {Object} options - 配置選項
*/
class RealTimeClock {
constructor(container, options = {}) {
this.container = typeof container === 'string'
? document.querySelector(container)
: container;
if (!this.container) {
throw new Error('容器元素不存在');
}
this.options = {
format: 'YYYY年MM月DD日 dddd HH:mm:ss', // 格式模板
interval: 1000, // 更新間隔(ms)
locale: 'zh-CN', // 本地化
...options
};
this.timerId = null;
this._init();
}
_init() {
// 初始渲染
this._render();
// 啟動定時器
this.start();
}
_render() {
const now = new Date();
const formatted = this._formatDate(now);
this.container.textContent = formatted; // 使用 textContent 防 XSS
}
_formatDate(date) {
const opt = this.options;
const year = date.getFullYear();
const month = String(date.getMonth() + 1).padStart(2, '0');
const day = String(date.getDate()).padStart(2, '0');
const hours = String(date.getHours()).padStart(2, '0');
const minutes = String(date.getMinutes()).padStart(2, '0');
const seconds = String(date.getSeconds()).padStart(2, '0');
const weekDays = ['星期日', '星期一', '星期二', '星期三', '星期四', '星期五', '星期六'];
const week = weekDays[date.getDay()];
// 簡易模板替換
return opt.format
.replace('YYYY', year)
.replace('MM', month)
.replace('DD', day)
.replace('HH', hours)
.replace('mm', minutes)
.replace('ss', seconds)
.replace('dddd', week);
}
start() {
if (this.timerId) return; // 防止重複啟動
this.timerId = setInterval(() => this._render(), this.options.interval);
}
stop() {
if (this.timerId) {
clearInterval(this.timerId);
this.timerId = null;
}
}
destroy() {
this.stop();
this.container = null;
}
}
// 使用示例
document.addEventListener('DOMContentLoaded', () => {
// 方式一:自動掛載到 data-clock 容器
document.querySelectorAll('[data-clock]').forEach(el => {
new RealTimeClock(el, {
format: 'YYYY-MM-DD dddd HH:mm:ss'
});
});
// 方式二:手動實例化
// const clock = new RealTimeClock('#clock-container', { interval: 500 });
// clock.stop(); // 停止
// clock.destroy(); // 銷毀
});
<!-- 自動初始化模式 -->
<div data-clock class="clock-display"></div>
<!-- 或手動指定容器 -->
<div id="clock-container" class="clock-display"></div>
<style>
.clock-display {
font-family: 'Monospace', 'Consolas', monospace;
font-size: 1.2rem;
color: #2c3e50;
background: linear-gradient(135deg, #f5f7fa 0%, #c3cfe2 100%);
padding: 0.5rem 1rem;
border-radius: 8px;
display: inline-block;
box-shadow: 0 2px 8px rgba(0,0,0,0.1);
font-variant-numeric: tabular-nums; /* 數字等寬,防止跳動 */
}
</style>
| 陷阱 | 錯誤寫法 | 正確做法 | 原因 |
|---|---|---|---|
| 年份獲取 | date.getYear() |
date.getFullYear() |
getYear() 返回年份-1900,已廢棄 |
| 月份索引 | 直接使用 getMonth() |
getMonth() + 1 |
JS 月份 0-11,1月為 0 |
| 數字補零 | 手動 if(m<10) m='0'+m |
String(m).padStart(2,'0') |
ES2017 標準方法,簡潔無誤 |
| 定時器漂移 | setTimeout(fn, 1000) 遞歸 |
setInterval(fn, 1000) |
遞歸 setTimeout 累積誤差;setInterval 固定間隔 |
| 內存洩漏 | 頁面卸載未清理定時器 | 在 beforeunload 或組件銷毀時 clearInterval |
|
| XSS 風險 | innerHTML = timeStr |
textContent = timeStr |
純文本內容無需解析 HTML |
| 時區問題 | 直接使用本地時間 | 按需使用 toLocaleString() 或 Intl.DateTimeFormat |
class AdvancedClock extends RealTimeClock {
_formatDate(date) {
const formatter = new Intl.DateTimeFormat(this.options.locale, {
year: 'numeric',
month: '2-digit',
day: '2-digit',
weekday: 'long',
hour: '2-digit',
minute: '2-digit',
second: '2-digit',
hour12: false
});
return formatter.format(date);
}
}
// 效果:2024年12月25日 星期三 14:30:05
優勢:原生國際化、自動處理時區/夏令時、格式符合用戶地區習慣、無需手動拼接字符串。
requestIdleCallback(() => this._render()) 非關鍵更新不阻塞主線程document.hidden 時暫停定時器,頁面可見時恢復@keyframes 更流暢實時時鐘看似簡單,實則涉及日期 API 正確使用、定時器管理、XSS 防護、性能優化、國際化等多個工程細節。封裝為可復用類(RealTimeClock),配合 Intl.DateTimeFormat 與現代語法,即可獲得健壯、優雅、可維護的解決方案。