STEP 1
タブを切り替える
タブを押すと、ボタンとパネルが一緒に切り替わります。
HTML
ボタンに data-tab、パネルに data-panel を付け、同じ名前で結びます。
CSS
.is-active が付いたボタンとパネルだけを目立たせます。
JavaScript
押されたボタンの data-tab を読み、同じ値のパネルを表示します。
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ステップ
やっていることは、クラスの付け替えだけです。
- 同じ名前で結ぶ
data-tab="html"とdata-panel="html"のように対応を作ります。 - 押されたタブを調べる
tab.dataset.tabで、出すパネルの名前を取ります。 - 全部から外して、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');