萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript Tab 切換元件完整實作:原理、無障礙、響應式與現代寫法

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>

核心 JS 邏輯 (原生、無依賴)

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);
});

CSS 基礎樣式與動畫

[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; }
}

進階功能擴充

1. 自動輪播

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);
    }
}

2. URL Hash 同步 (深層連結)

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);
        });
    }
}

3. 垂直/手風琴模式響應式切換

@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; }
}

無障礙 (WAI-ARIA) 合規檢查清單

  • ✅ role="tablist" 包裹 Tab 列表
  • ✅ role="tab" 每個標籤,aria-selected 標示狀態
  • ✅ aria-controls 指向對應面板 id
  • ✅ role="tabpanel" 面板,aria-labelledby 反向指向 Tab
  • ✅ hidden 屬性控制面板可見性 (螢幕閱讀器會忽略)
  • ✅ tabIndex 管理:啟動 Tab=0,其他=-1 (Roving tabindex)
  • ✅ 鍵盤導航:←/→ 切換,Home/End 首尾,Enter/Space 啟動
  • ✅ 焦點指示器可見

框架整合提示

框架推薦做法
React使用 react-tabs、@reach/tabs 或自建 Hook 封裝邏輯
Vuevue-tabs-component 或 <Teleport> 實作無障礙版本
Sveltesvelte-tabs 或原生 bind:group 實作
AngularAngular Material MatTabGroup 內建無障礙

總結

Tab 切換看似簡單,但生產級元件需考量:語意化 HTML、ARIA 屬性、鍵盤操作、焦點管理、動畫效能、響應式、多實例隔離、URL 同步。建立可復用的 TabSwitcher 類別,配合繼承擴充功能,是長期維護的最佳策略。

copyright © 萬盛學電腦網 all rights reserved