萬盛學電腦網

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

原生 JavaScript 實現無障礙 Tab 選項卡組件(支援鍵盤導航與動態增減)

Tab 選項卡是高頻 UI 模式。本文實現一個符合 WAI-ARIA Authoring Practices 的標準 Tab 組件:支援鍵盤操作(左右鍵切換、Home/End 跳轉)、動態增減面板、自動生成 ID 關聯、單一職責封裝。

HTML 語意結構

<div class="tabs" role="tablist" aria-label="產品規格">
  <button role="tab" aria-selected="true" aria-controls="panel-1" id="tab-1">規格一</button>
  <button role="tab" aria-selected="false" aria-controls="panel-2" id="tab-2">規格二</button>
  <button role="tab" aria-selected="false" aria-controls="panel-3" id="tab-3">規格三</button>
</div>
<div role="tabpanel" id="panel-1" aria-labelledby="tab-1">內容一</div>
<div role="tabpanel" id="panel-2" aria-labelledby="tab-2" hidden>內容二</div>
<div role="tabpanel" id="panel-3" aria-labelledby="tab-3" hidden>內容三</div>

核心邏輯:TabController 類別

class TabController {
  constructor(container) {
    this.tablist = container.querySelector('[role="tablist"]');
    this.tabs = [...this.tablist.querySelectorAll('[role="tab"]')];
    this.panels = this.tabs.map(tab => document.getElementById(tab.getAttribute('aria-controls')));
    this._bind();
    this._activate(this.tabs.find(t => t.getAttribute('aria-selected') === 'true') || this.tabs[0]);
  }

  _bind() {
    this.tablist.addEventListener('click', e => {
      const tab = e.target.closest('[role="tab"]');
      if (tab) this._activate(tab);
    });

    this.tablist.addEventListener('keydown', e => {
      const index = this.tabs.indexOf(e.target.closest('[role="tab"]'));
      if (index === -1) return;
      let newIndex = index;
      switch (e.key) {
        case 'ArrowRight': newIndex = (index + 1) % this.tabs.length; break;
        case 'ArrowLeft':  newIndex = (index - 1 + this.tabs.length) % this.tabs.length; break;
        case 'Home': newIndex = 0; break;
        case 'End': newIndex = this.tabs.length - 1; break;
        default: return;
      }
      e.preventDefault();
      this.tabs[newIndex].focus();
      this._activate(this.tabs[newIndex]);
    });
  }

  _activate(tab) {
    this.tabs.forEach(t => {
      const selected = t === tab;
      t.setAttribute('aria-selected', selected);
      t.tabIndex = selected ? 0 : -1;
    });
    this.panels.forEach((p, i) => {
      p.hidden = this.tabs[i] !== tab;
    });
  }

  // 動態新增
  addTab(label, panelHTML) {
    const index = this.tabs.length;
    const tabId = `tab-${index + 1}`;
    const panelId = `panel-${index + 1}`;
    const btn = document.createElement('button');
    btn.role = 'tab';
    btn.id = tabId;
    btn.setAttribute('aria-controls', panelId);
    btn.setAttribute('aria-selected', 'false');
    btn.tabIndex = -1;
    btn.textContent = label;
    this.tablist.appendChild(btn);

    const panel = document.createElement('div');
    panel.role = 'tabpanel';
    panel.id = panelId;
    panel.setAttribute('aria-labelledby', tabId);
    panel.hidden = true;
    panel.innerHTML = panelHTML;
    this.tablist.parentNode.appendChild(panel);

    this.tabs.push(btn);
    this.panels.push(panel);
  }
}

// 初始化
document.querySelectorAll('[role="tablist"]').forEach(el => new TabController(el.parentElement));

樣式建議

[role="tab"] { padding: 8px 16px; border: none; background: #eee; cursor: pointer; }
[role="tab"][aria-selected="true"] { background: #0066cc; color: #fff; }
[role="tab"]:focus { outline: 2px solid #0066cc; outline-offset: -2px; }
[role="tabpanel"] { padding: 16px; border: 1px solid #ddd; border-top: none; }
copyright © 萬盛學電腦網 all rights reserved