Tab 標籤切換是常見 UI 元件。本文從原生 JS 基礎實作出發,逐步演進至無障礙 (WAI-ARIA) 合規、鍵盤導航、響應式設計、動畫過渡、多實例管理的完整生產級方案。
<div id="container">
<ul class="tabs" role="tablist">
<li role="tab" aria-selected="true" aria-controls="panel-news" id="tab-news">新聞</li>
<li role="tab" aria-selected="false" aria-controls="panel-sports" id="tab-sports">體育</li>
<li role="tab" aria-selected="false" aria-controls="panel-military" id="tab-military">軍事</li>
<li role="tab" aria-selected="false" aria-controls="panel-bbs" id="tab-bbs">論壇</li>
</ul>
<div class="panels">
<div role="tabpanel" id="panel-news" aria-labelledby="tab-news">新聞內容...</div>
<div role="tabpanel" id="panel-sports" aria-labelledby="tab-sports" hidden>體育內容...</div>
<div role="tabpanel" id="panel-military" aria-labelledby="tab-military" hidden>軍事內容...</div>
<div role="tabpanel" id="panel-bbs" aria-labelledby="tab-bbs" hidden>論壇內容...</div>
</div>
</div>
class TabSwitcher {
constructor(container) {
this.container = container;
this.tabs = container.querySelectorAll('[role="tab"]');
this.panels = container.querySelectorAll('[role="tabpanel"]');
this.init();
}
init() {
this.tabs.forEach(tab => {
tab.addEventListener('click', () => this.activate(tab));
tab.addEventListener('keydown', e => this.handleKeydown(e, tab));
});
// 初始啟動第一個
this.activate(this.tabs[0]);
}
activate(selectedTab) {
// 更新 Tab 狀態
this.tabs.forEach(tab => {
const isSelected = tab === selectedTab;
tab.setAttribute('aria-selected', isSelected);
tab.tabIndex = isSelected ? 0 : -1; // 鍵盤導航只進入啟動的 tab
});
// 顯示/隱藏對應面板
const panelId = selectedTab.getAttribute('aria-controls');
this.panels.forEach(panel => {
const isActive = panel.id === panelId;
panel.hidden = !isActive;
// 可選:動畫類別切換
panel.classList.toggle('is-active', isActive);
});
}
handleKeydown(e, currentTab) {
const tabs = Array.from(this.tabs);
const index = tabs.indexOf(currentTab);
let nextIndex = index;
switch (e.key) {
case 'ArrowRight': nextIndex = (index + 1) % tabs.length; break;
case 'ArrowLeft': nextIndex = (index - 1 + tabs.length) % tabs.length; break;
case 'Home': nextIndex = 0; break;
case 'End': nextIndex = tabs.length - 1; break;
default: return;
}
e.preventDefault();
tabs[nextIndex].focus();
this.activate(tabs[nextIndex]);
}
}
// 使用:支援頁面多組 Tab
document.querySelectorAll('[data-tab-container]').forEach(el => {
new TabSwitcher(el);
});
[role="tablist"] { display: flex; border-bottom: 2px solid #ddd; margin: 0; padding: 0; list-style: none; }
[role="tab"] {
padding: 12px 20px; cursor: pointer; border: none; background: transparent;
font: inherit; color: #666; border-bottom: 3px solid transparent; margin-bottom: -2px;
transition: color 0.2s, border-color 0.2s;
}
[role="tab"]:hover { color: #333; }
[role="tab"][aria-selected="true"] {
color: #007bff; border-bottom-color: #007bff; font-weight: 600;
}
[role="tab"]:focus { outline: 2px solid #007bff; outline-offset: -2px; z-index: 1; }
[role="tabpanel"] { padding: 20px 0; }
[role="tabpanel"]:not([hidden]) { animation: fadeIn 0.2s ease; }
@keyframes fadeIn { from { opacity: 0; transform: translateY(4px); } to { opacity: 1; transform: none; } }
/* 響應式:小螢幕變捲動標籤 */
@media (max-width: 600px) {
[role="tablist"] { overflow-x: auto; white-space: nowrap; -webkit-overflow-scrolling: touch; }
[role="tab"] { flex-shrink: 0; }
}
class AutoTabSwitcher extends TabSwitcher {
constructor(container, interval = 3000) {
super(container);
this.interval = interval;
this.timer = null;
this.container.addEventListener('mouseenter', () => this.stop());
this.container.addEventListener('mouseleave', () => this.start());
this.start();
}
start() { this.stop(); this.timer = setInterval(() => this.next(), this.interval); }
stop() { clearInterval(this.timer); }
next() {
const tabs = Array.from(this.tabs);
const current = tabs.find(t => t.getAttribute('aria-selected') === 'true');
const next = tabs[(tabs.indexOf(current) + 1) % tabs.length];
this.activate(next);
}
}
class HashTabSwitcher extends TabSwitcher {
activate(selectedTab) {
super.activate(selectedTab);
history.replaceState(null, '', '#' + selectedTab.id); // 更新 URL
}
init() {
super.init();
// 頁面載入時根據 hash 啟動
const hash = location.hash.slice(1);
if (hash) {
const tab = this.container.querySelector('#' + hash);
if (tab) this.activate(tab);
}
window.addEventListener('hashchange', () => {
const tab = this.container.querySelector('#' + location.hash.slice(1));
if (tab) this.activate(tab);
});
}
}
@media (max-width: 480px) {
[role="tablist"] { flex-direction: column; border-bottom: none; border-right: 2px solid #ddd; }
[role="tab"] { border-bottom: 1px solid #eee; border-right: 3px solid transparent; margin: 0; }
[role="tab"][aria-selected="true"] { border-right-color: #007bff; border-bottom-color: transparent; }
}
role="tablist" 包裹 Tab 列表role="tab" 每個標籤,aria-selected 標示狀態aria-controls 指向對應面板 idrole="tabpanel" 面板,aria-labelledby 反向指向 Tabhidden 屬性控制面板可見性 (螢幕閱讀器會忽略)tabIndex 管理:啟動 Tab=0,其他=-1 (Roving tabindex)| 框架 | 推薦做法 |
|---|---|
| React | 使用 react-tabs、@reach/tabs 或自建 Hook 封裝邏輯 |
| Vue | vue-tabs-component 或 <Teleport> 實作無障礙版本 |
| Svelte | svelte-tabs 或原生 bind:group 實作 |
| Angular | Angular Material MatTabGroup 內建無障礙 |
Tab 切換看似簡單,但生產級元件需考量:語意化 HTML、ARIA 屬性、鍵盤操作、焦點管理、動畫效能、響應式、多實例隔離、URL 同步。建立可復用的 TabSwitcher 類別,配合繼承擴充功能,是長期維護的最佳策略。