問題現象
// jQuery 方式修改標題
$('title').html('新標題'); // 或 $('title').text('新標題')
// 後果:後續其他 jQuery 代碼失效、控制台報錯、頁面行為異常
根本原因
<title> 元素內容是**純文本節點**,不支持 HTML 子元素
- jQuery
.html()/.text() 內部操作 innerHTML/textContent,對 <title> 行為未定義/異常
- 可能觸發 jQuery 內部清理邏輯錯誤,汙染全局 jQuery 狀態
正確解法:原生 document.title
// ✅ 正確、標準、跨瀏覽器、無副作用
document.title = '新標題';
// 獲取標題
var currentTitle = document.title;
為什麼 document.title 是標準?
- DOM Level 1 標準屬性,所有瀏覽器完美支持
- 直接映射
<title> 文本內容,無 HTML 解析開銷
- 修改即時生效,瀏覽器標籤頁、收藏夾、歷史記錄同步更新
- 不依賴任何庫,零依賴、零風險
延伸:動態標題最佳實踐
1. 頁面可見性切換標題 (吸引用戶返回)
var originalTitle = document.title;
var hiddenTitle = '👋 回來看看呀!';
document.addEventListener('visibilitychange', function() {
document.title = document.hidden ? hiddenTitle : originalTitle;
});
2. 未讀消息計數顯示
function setUnreadCount(count) {
if (count > 0) {
document.title = '(' + count + ') ' + originalTitle;
} else {
document.title = originalTitle;
}
}
// WebSocket 推送新消息時
socket.on('message', function() {
unreadCount++;
setUnreadCount(unreadCount);
});
3. SPA 路由切換更新標題
// Vue Router / React Router 通用模式
router.afterEach((to) => {
document.title = to.meta.title || '默認標題';
});
總結
永遠使用 document.title 讀寫頁面標題。jQuery 無法正確處理 <title> 元素,會導致難以診斷的副作用。