【定番UI】【JavaScript】data 属性を使ったタブ切り替えUIの作り方!

限られた画面スペースの中で、「お知らせ」「イベント」「キャンペーン」のように複数のコンテンツをスッキリ整理して表示できる「タブ切り替えUI」は、Webサイト制作で最も頻繁に実装する定番パーツのひとつです。

タブ切り替えを実装する際、ボタンの順番(インデックス番号)だけで無理やり制御しようとすると、後からタブの順番を入れ替えたり増やしたりした時にバグの原因になりがちです。 スマートな実装方法は、HTMLの data-* 属性(カスタムデータ属性) に表示したいパネルのIDを持たせ、JavaScriptで動的に紐付けるアプローチです!

今回は、タブが何個に増えてもJSコードの修正が一切不要になる、シンプルでスマートなタブ切り替えの実装方法とデモをご紹介します!

デモ動作

See the Pen 【定番UI】JSとdata属性で作るタブ切り替え by mikanbako (@mikanbako) on CodePen.

全画面でのデモ動作は以下のリンクからご確認下さい!(別タブで開かれます)

実装コード紹介

【HTML】

<div class="l-wrap">
  <h2>シンプルなタブ切り替えデモ</h2>
  <p class="p-desc">上のタブボタンをクリックすると、data-target属性に紐付いたコンテンツへ切り替わります!</p>
  
  <div class="p-tab-container">
    
    <!-- 💡 1. タブボタン群(data-target に表示したいパネルの id を指定) -->
    <div class="c-tab-list" role="tablist">
      <button class="c-tab-btn is-active js-tab-btn" data-target="panel-html" type="button">
        🌐 HTMLの役割
      </button>
      <button class="c-tab-btn js-tab-btn" data-target="panel-css" type="button">
        🎨 CSSの役割
      </button>
      <button class="c-tab-btn js-tab-btn" data-target="panel-js" type="button">
        ⚡ JavaScriptの役割
      </button>
    </div>

    <!-- 💡 2. タブコンテンツ(パネル)群(ボタンの data-target と同じ id を指定) -->
    <div class="c-tab-panels">
      
      <div id="panel-html" class="c-tab-panel is-active js-tab-panel">
        <span class="c-badge">Target ID: #panel-html</span>
        <h3>HTML:Webページの「骨組み」を作る</h3>
        <p>見出しや段落、ボタンなどの要素を配置し、文書の構造を定義します。タブ切り替えでは、ボタンに <code>data-target</code> 属性を持たせてパネルの <code>id</code> と紐付ける役割を担います。</p>
      </div>

      <div id="panel-css" class="c-tab-panel js-tab-panel">
        <span class="c-badge">Target ID: #panel-css</span>
        <h3>CSS:見た目と「表示・非表示」を整える</h3>
        <p>色やレイアウトを装飾します。タブ切り替えでは、通常時のパネルを <code>display: none;</code> で隠しておき、<code>.is-active</code> が付いたパネルだけを <code>display: block;</code> で表示します。</p>
      </div>

      <div id="panel-js" class="c-tab-panel js-tab-panel">
        <span class="c-badge">Target ID: #panel-js</span>
        <h3>JavaScript:クリック操作で「クラスを付け替える」</h3>
        <p>クリックされたボタンの <code>dataset.target</code> を読み取り、該当するIDのパネルを探して <code>.is-active</code> クラスを付け替える司令塔の役割を担います。</p>
      </div>

    </div>

  </div>
</div>

【CSS】

/* ベース装飾 */
.l-wrap {
  padding: 40px 20px;
  max-width: 600px;
  margin: 0 auto;
  color: #3e3e3e;
  text-align: center;
}

h2 {
  margin-bottom: 10px;
  font-size: 16px;
  color: #1bb4d4;
}

.p-desc {
  margin-bottom: 25px;
  font-size: 16px;
  font-weight: bold;
  color: #666;
  line-height: 1.6;
}

/* タブ全体のコンテナ */
.p-tab-container {
  padding: 30px;
  text-align: left;
  background: #fff;
  border-radius: 12px;
  box-shadow: 0 4px 15px rgb(0 0 0 / 5%);
}

/* 💡 1. タブボタンのスタイル */
.c-tab-list {
  display: grid;
  grid-template-columns: repeat(3, 1fr);
  gap: 8px;
  border-bottom: 3px solid #1bb4d4;
}

.c-tab-btn {
  padding: 1em;
  font-family: inherit;
  font-size: 13px;
  font-weight: bold;
  color: #666;
  cursor: pointer;
  background: #f1f3f5;
  border-radius: 8px 8px 0 0;
  transition: 0.2s;
}

.c-tab-btn:hover {
  color: #333;
  background: #e2e6ea;
}

/* 選択中(アクティブ)のボタンスタイル */
.c-tab-btn.is-active {
  color: #fff;
  background: #1bb4d4;
}

/* 💡 2. タブパネルのスタイル */
.c-tab-panels {
  padding: 25px;
  background: #f8f9fa;
  border: 1px solid #e9ecef;
  border-top: none;
  border-radius: 0 0 8px 8px;
}

/* 初期状態はすべて非表示にしておく */
.c-tab-panel {
  display: none;
}

/* ⭕ is-active が付いたパネルだけを表示し、ふわっとフェードインさせる */
.c-tab-panel.is-active {
  display: block;
  animation: fade-in 0.4s ease-out;
}

@keyframes fade-in {
  from {
    opacity: 0;
    transform: translateY(5px);
  }

  to {
    opacity: 1;
    transform: translateY(0);
  }
}

/* パネル内の装飾 */
.c-badge {
  display: inline-block;
  padding: 3px 10px;
  margin-bottom: 10px;
  font-family: monospace;
  font-size: 13px;
  font-weight: bold;
  color: #e83e8c;
  background: #ffe4e1;
  border-radius: 20px;
}

.c-tab-panel h3 {
  margin-bottom: 10px;
  font-size: 16px;
  color: #1bb4d4;
}

.c-tab-panel p {
  font-size: 14px;
  line-height: 1.5;
  color: #555;
}

.c-tab-panel code {
  padding: 2px 6px;
  font-size: 14px;
  font-weight: bold;
  color: #d6336c;
  background: #e9ecef;
  border-radius: 4px;
}

【JavaScript】

// DOM要素の取得
const tabButtons = document.querySelectorAll('.js-tab-btn');
const tabPanels = document.querySelectorAll('.js-tab-panel');

tabButtons.forEach(button => {
  button.addEventListener('click', () => {
    // すでにアクティブなボタンがクリックされた場合は何もしない(無駄な処理の防止)
    if (button.classList.contains('is-active')) return;

    // 💡 ステップ1:すべてのボタンとパネルから「is-active」クラスを一旦外す(リセット)
    tabButtons.forEach(btn => btn.classList.remove('is-active'));
    tabPanels.forEach(panel => panel.classList.remove('is-active'));

    // 💡 ステップ2:クリックされたボタン自身に「is-active」を付ける
    button.classList.add('is-active');

    // 💡 ステップ3:ボタンの data-target 属性の値を取得し、同じ id を持つパネルを表示する!
    const targetId = button.dataset.target;
    const targetPanel = document.getElementById(targetId);

    // 対象のパネルが存在すれば「is-active」を付ける(オプショナルチェーンで安全に!)
    targetPanel?.classList.add('is-active');
  });
});

タブ切り替え実装の3つの要点

要点①:HTMLの data-* 属性と id でボタンとパネルを紐付ける

拡張性の高いタブUIを作る最大のコツは、HTML側で「どのボタンがどのパネルを開くか」の対応関係を持たせておくことです。

<!-- ボタン側:data-target に開きたいパネルのID名を書いておく -->
<button class="js-tab-btn" data-target="panel-1">タブ1</button>

<!-- パネル側:対応する id を設定しておく -->
<div id="panel-1" class="js-tab-panel">タブ1のコンテンツ</div>

JavaScriptからは button.dataset.target と書くだけで "panel-1" という文字列を取得できるため、そのまま document.getElementById() に渡して目的のパネルをピンポイントで特定できます!この仕組みなら、後からタブの順番を入れ替えたり数を増やしたりしても、JSのコードを一切変更する必要がありません。

要点②:JSの処理は「全員リセット ➔ 対象だけアクティブ化」の2ステップ!

タブ切り替えのJavaScriptロジックは、「前回どのタブが開いていたか」を記憶する必要はありません。クリックされた瞬間に以下の順番で処理を行うのが最もシンプルでバグのない鉄板パターンです。

  1. 全員リセット
    forEach を使って、すべてのタブボタンとパネルから .is-active クラスを一旦すべて削除する。
  2. 対象だけアクティブ化
    クリックされたボタンと、data-target で指定されたパネルの2つにだけ .is-active クラスを付与する。
tabButtons.forEach(button => {
  button.addEventListener('click', () => {
    // すでにアクティブなボタンがクリックされた場合は何もしない(無駄な処理の防止)
    if (button.classList.contains('is-active')) return;

    // 💡 ステップ1:すべてのボタンとパネルから「is-active」クラスを一旦外す(リセット)
    tabButtons.forEach(btn => btn.classList.remove('is-active'));
    tabPanels.forEach(panel => panel.classList.remove('is-active'));

    // 💡 ステップ2:クリックされたボタン自身に「is-active」を付ける
    button.classList.add('is-active');

    // 💡 ステップ3:ボタンの data-target 属性の値を取得し、同じ id を持つパネルを表示する!
    const targetId = button.dataset.target;
    const targetPanel = document.getElementById(targetId);

    // 対象のパネルが存在すれば「is-active」を付ける(オプショナルチェーンで安全に!)
    targetPanel?.classList.add('is-active');
  });
});

また、一番最初に if (button.classList.contains('is-active')) return; という1行を入れておくことで、すでに開いているタブを連打された時にアニメーションが何度も再発火してしまうのを防げます!

要点③:CSSの @keyframes を1行足してリッチな切り替え演出に!

/* 初期状態はすべて非表示にしておく */
.c-tab-panel {
  display: none;
}

/* ⭕ is-active が付いたパネルだけを表示し、ふわっとフェードインさせる */
.c-tab-panel.is-active {
  display: block;
  animation: fade-in 0.4s ease-out;
}

@keyframes fade-in {
  from {
    opacity: 0;
    transform: translateY(5px);
  }

  to {
    opacity: 1;
    transform: translateY(0);
  }
}

display: none; と display: block; の切り替えには通常の transition が効きませんが、.is-active がついたパネルに animation: fade-in 0.4s ease-out; のように簡単なキーフレームアニメーションを指定してあげるだけで、パッと切り替わる味気なさが消え、ふわっと心地よいUIに仕上がります。

補足:さらに品質を高めるアクセシビリティ(WAI-ARIA)の知識

より本格的なWebサイト制作では、スクリーンリーダー(音声読み上げソフト)やキーボード操作にも対応させるため、以下のような属性を合わせて記述することが推奨されています。

  • 親のリストに role="tablist"、各ボタンに role="tab"、各パネルに role="tabpanel" を付与する。
  • クラスの付け替えと一緒に、ボタンの aria-selected="true / false"(選択状態の伝達)や、パネルの hidden 属性 を切り替える。

まずは基本の data-* 属性によるクラス切り替えをしっかりマスターし、慣れてきたらこうしたアクセシビリティ属性の制御も組み込んでみましょう!

まとめ

今回はWeb制作の定番UIである「タブ切り替え」の実装方法について解説しました。

  • HTML:ボタンの data-target とパネルの id を一致させて紐付ける
  • CSS:パネルを display: none で隠しておき、.is-active が付いた時だけ表示する
  • JS:「すべての .is-active を外す ➔ クリックされた対象にだけ .is-active を付ける」の2ステップで制御する

この「全員からクラスを外して、対象にだけクラスを付ける」という考え方は、タブ切り替えだけでなくアコーディオンメニューやスライダーなど、あらゆるUI実装の土台になる超重要パターンです。ぜひ自分のスニペットとして活用してみてください!

Prev
Next