UI PATTERN

タブ切替

押したタブと対応パネルだけに is-active を付ける

STEP 1

タブを切り替える

タブを押すと、ボタンとパネルが一緒に切り替わります。

HTML

ボタンに data-tab、パネルに data-panel を付け、同じ名前で結びます。

const tabs = document.querySelectorAll('.tab-btn'); const panels = document.querySelectorAll('.tab-panel'); tabs.forEach((tab) => { tab.addEventListener('click', () => { const target = tab.dataset.tab; tabs.forEach((btn) => { const active = btn === tab; btn.classList.toggle('is-active', active); btn.setAttribute('aria-selected', active); }); panels.forEach((panel) => { const active = panel.dataset.panel === target; panel.classList.toggle('is-active', active); panel.hidden = !active; }); }); });
STEP 2

動きの3ステップ

やっていることは、クラスの付け替えだけです。

  1. 同じ名前で結ぶdata-tab="html" と data-panel="html" のように対応を作ります。
  2. 押されたタブを調べるtab.dataset.tab で、出すパネルの名前を取ります。
  3. 全部から外して、1つだけ付ける表示するパネル以外には hidden を付けます。
STEP 3

役割を伝える属性

次の属性を付けると、読み上げソフトにもタブだと伝わります。

属性付ける場所役割
role="tablist"ボタン列の親タブのまとまり
role="tab"各ボタン1つのタブ
aria-selected各ボタン選ばれているか(JSで更新)
role="tabpanel"各パネルタブの中身
hidden見せないパネル見た目も読み上げも隠す
jQueryで書く場合

押したボタンの順番(index())と同じ番号のパネルを表示します。既存サイトでよく見る書き方です。

$('.tab-btn').on('click', function () { const index = $(this).index(); $('.tab-btn').removeClass('is-active') .attr('aria-selected', 'false'); $(this).addClass('is-active') .attr('aria-selected', 'true'); $('.tab-panel').removeClass('is-active') .prop('hidden', true); $('.tab-panel').eq(index) .addClass('is-active') .prop('hidden', false); });
STEP 4

覚えておくこと

  • タブは button で作る同じページの中で表示を切り替えるだけなら、リンクより button が合っています。
  • 紐付けは data属性で順番に頼らないので、あとから並べ替えても壊れにくくなります。
  • 最初の表示はHTMLで決める最初に見せるボタンとパネルに is-active を付け、ほかのパネルには hidden を付けておきます。
COMMON MISTAKES

よくあるつまずき

つまずきやすいポイントと、その直し方です。

タブを押すと前のパネルも残ったまま

押したパネルに付けるだけで、ほかのパネルから外していません。先に全部から外してから、1つだけに付けます。

$('.tab-panel').eq(index).addClass('is-active'); $('.tab-panel').removeClass('is-active'); $('.tab-panel').eq(index).addClass('is-active');
ページを開いた直後にパネルが全部見える

最初の状態がHTMLに書かれていません。見せないパネルに hidden を付けておきます。

<div class="tab-panel" data-panel="css" hidden>
タブを並べ替えたら中身がずれた

index() の順番で結んでいると、並びが変わったときにずれます。data-tab と data-panel の値で結びます。

別のタブのグループまで一緒に切り替わる

ページ全体の .tab-btn を選んでいます。押したボタンの親のグループの中だけで探します。

const group = tab.closest('.js-tab-demo'); const panels = group.querySelectorAll('.tab-panel');