JS

ネイティブネタ帳

UI

モーダル

タブ

ドロワー

スライダー

スクロール

アコーディオン

目次

ローディングアニメーション

ツールチップ

ヘッダー

テーブル

グラフ

背景

ニュースティッカー

フォーム

フォーム

文字

文字の装飾

文字の操作

文字のカウント

数字の操作

ウィンドウ

ウィンドウ操作

タイトルの操作

ページ遷移時の動き

class

classの操作

要素

要素の操作

要素の追加

API

WP REST API

Google Books APIs

楽天市場API

openBD

画像・動画

画像の操作

YouTube

リンク

Google Analytics

cookie

検索

検索

お気に入り登録

タブ+Swiperで作る、切り替え式カルーセルUIの実装方法

お気に入り登録をすると、お気に入り記事一覧に登録することができます。

classList.add() ・ classList.remove()

タブ+Swiperで作る、切り替え式カルーセルUIの実装方法

11分

タブ+Swiperで作る、切り替え式カルーセルUIの実装方法

SHARE

この記事では、タブを切り替えることで、表示されるカルーセル（Swiper）も一緒に切り替わるUIの作成について解説しています。

HTMLでタブとカルーセルの入れ物を作り、JavaScriptでタブの切り替えとSwiperの初期化を行います。そして、CSSで見た目を整えます。

かかかず
かかかず

Swiperというライブラリを、CDNから読み込んで使います。

classList.add() ・ classList.remove()

JavaScriptのclassListは、要素が持つclass属性を操作するためのプロパティです。要素.classList.add('クラス名')でクラスを追加し、要素.classList.remove('クラス名')で取り除くことができます。

例えば、あるボタンをクリックしたときに、そのボタンだけに「選択中」を表す見た目を付けたい場合、以下のように使用します:

const btn = document.querySelector('.myButton');

btn.classList.add('is-active');
// → <button class="myButton is-active">になる

btn.classList.remove('is-active');
// → <button class="myButton">に戻る

今回のタブ切り替えでは、このadd()とremove()を組み合わせて、「クリックされたタブ・パネルだけにis-activeを付け、それ以外からは外す」という処理を行っています。

かかかず
かかかず

似たようなことができるclassList.toggle()というメソッドもありますが、今回は「他のタブを必ず非アクティブにする」処理なので、add／removeを分けて書いています。

タブ切り替え×カルーセルのサンプル

それでは、早速サンプルです。

タブをクリックすると、表示されるカルーセルが切り替わります。カルーセル自体も、左右にスワイプ（またはドラッグ）して動かせます。

かかかず
かかかず

タブを切り替えると、カルーセルの中身も一緒に切り替わります。切り替えた直後にカルーセルのコマ数がズレないよう、裏側でswiper.update()を呼んでいます。

実装の手順と方法

手順と方法

コードの詳細の前に、実装の手順と方法について解説していきます。

HTMLを記述

まずは、タブのボタンと、タブごとのカルーセルを入れる箱をHTMLで用意します。

カルーセル自体は、Swiperが要求する.swiper → .swiper-wrapper → .swiper-slideという決まった入れ子構造にしておきます。

<div class="jsSample-tabCarousel">
  <div class="tab-carousel-tabs">
    <button class="tab-carousel-tabBtn is-active" data-tab="tab1">おすすめ</button>
    <button class="tab-carousel-tabBtn" data-tab="tab2">新着</button>
    <button class="tab-carousel-tabBtn" data-tab="tab3">セール</button>
  </div>

  <div class="tab-carousel-panel is-active" id="tab1">
    <div class="swiper tabSwiper1">
      <div class="swiper-wrapper">
        <div class="swiper-slide">おすすめ 1</div>
        <div class="swiper-slide">おすすめ 2</div>
        <div class="swiper-slide">おすすめ 3</div>
        <div class="swiper-slide">おすすめ 4</div>
      </div>
      <div class="swiper-pagination"></div>
    </div>
  </div>

  <div class="tab-carousel-panel" id="tab2">
    <div class="swiper tabSwiper2">
      <div class="swiper-wrapper">
        <div class="swiper-slide">新着 1</div>
        <div class="swiper-slide">新着 2</div>
        <div class="swiper-slide">新着 3</div>
      </div>
      <div class="swiper-pagination"></div>
    </div>
  </div>

  <div class="tab-carousel-panel" id="tab3">
    <div class="swiper tabSwiper3">
      <div class="swiper-wrapper">
        <div class="swiper-slide">セール 1</div>
        <div class="swiper-slide">セール 2</div>
      </div>
      <div class="swiper-pagination"></div>
    </div>
  </div>
</div>
Swiperの読み込みとCSSを記述

SwiperはCDNから読み込みます。<link>でCSSを、<script>でJS本体を読み込んでおきましょう。

あわせて、タブとパネルの見た目を整えるCSSも記述します。

<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/swiper@11/swiper-bundle.min.css" />

<style>
.jsSample-tabCarousel { margin-top: 20px; }
.tab-carousel-tabs { display: flex; gap: 10px; margin-bottom: 20px; flex-wrap: wrap; }
.tab-carousel-tabBtn { padding: 10px 20px; border: none; border-radius: 6px; background: #eee; cursor: pointer; font-weight: 600; transition: 0.2s; }
.tab-carousel-tabBtn.is-active { background: #5ba9f7; color: #fff; }
.tab-carousel-panel { display: none; }
.tab-carousel-panel.is-active { display: block; }
.jsSample-tabCarousel .swiper-slide { background: #f5f5f5; border-radius: 8px; padding: 40px 0; text-align: center; font-weight: 600; font-size: 1.1rem; }
.jsSample-tabCarousel .swiper { padding-bottom: 30px; }
</style>

<script src="https://cdn.jsdelivr.net/npm/swiper@11/swiper-bundle.min.js"></script>
JavaScriptを記述

最後に、タブをクリックしたときの切り替え処理と、Swiperの初期化処理を書きます。

document.addEventListener('DOMContentLoaded', function () {
  // 3つのカルーセルに共通するオプション
  const swiperOptions = {
    slidesPerView: 2,
    spaceBetween: 16,
    pagination: { clickable: true },
  };

  // タブごとにSwiperインスタンスを作成し、対応付けておく
  const swiperMap = {
    tab1: new Swiper('.tabSwiper1', swiperOptions),
    tab2: new Swiper('.tabSwiper2', swiperOptions),
    tab3: new Swiper('.tabSwiper3', swiperOptions),
  };

  const tabButtons = document.querySelectorAll('.tab-carousel-tabBtn');
  const panels = document.querySelectorAll('.tab-carousel-panel');

  tabButtons.forEach((btn) => {
    btn.addEventListener('click', () => {
      const target = btn.dataset.tab;

      // 一旦すべてのタブ・パネルからis-activeを外す
      tabButtons.forEach((b) => b.classList.remove('is-active'));
      panels.forEach((p) => p.classList.remove('is-active'));

      // クリックされたタブと対応するパネルにis-activeを付ける
      btn.classList.add('is-active');
      document.getElementById(target).classList.add('is-active');

      // 非表示の間にサイズがずれていることがあるのでupdateしておく
      if (swiperMap[target]) swiperMap[target].update();
    });
  });
});

ざっくりとしたコードの解説

コードは、HTML・CSS・JavaScriptの3種類です。ざっくりですが、順に解説していきます。

HTML

タブのボタン（.tab-carousel-tabBtn）には、data-tab属性で対応するパネルのIDを持たせています。

パネル側（.tab-carousel-panel）は、その中にそれぞれ独立したSwiperの構造（.swiper / .swiper-wrapper / .swiper-slide）を持たせている形です。

<div class="jsSample-tabCarousel">
  <div class="tab-carousel-tabs">
    <button class="tab-carousel-tabBtn is-active" data-tab="tab1">おすすめ</button>
    <button class="tab-carousel-tabBtn" data-tab="tab2">新着</button>
    <button class="tab-carousel-tabBtn" data-tab="tab3">セール</button>
  </div>

  <div class="tab-carousel-panel is-active" id="tab1">
    <div class="swiper tabSwiper1">
      <div class="swiper-wrapper">
        <div class="swiper-slide">おすすめ 1</div>
        <div class="swiper-slide">おすすめ 2</div>
        <div class="swiper-slide">おすすめ 3</div>
        <div class="swiper-slide">おすすめ 4</div>
      </div>
      <div class="swiper-pagination"></div>
    </div>
  </div>

  <div class="tab-carousel-panel" id="tab2">
    <div class="swiper tabSwiper2">
      <div class="swiper-wrapper">
        <div class="swiper-slide">新着 1</div>
        <div class="swiper-slide">新着 2</div>
        <div class="swiper-slide">新着 3</div>
      </div>
      <div class="swiper-pagination"></div>
    </div>
  </div>

  <div class="tab-carousel-panel" id="tab3">
    <div class="swiper tabSwiper3">
      <div class="swiper-wrapper">
        <div class="swiper-slide">セール 1</div>
        <div class="swiper-slide">セール 2</div>
      </div>
      <div class="swiper-pagination"></div>
    </div>
  </div>
</div>

CSS・Swiperの読み込み

CDNから読み込んだSwiperの基本スタイルに、タブの見た目や、非表示のパネルを隠すためのスタイルを追加しています。

.jsSample-tabCarousel { margin-top: 20px; }
.tab-carousel-tabs { display: flex; gap: 10px; margin-bottom: 20px; flex-wrap: wrap; }
.tab-carousel-tabBtn { padding: 10px 20px; border: none; border-radius: 6px; background: #eee; cursor: pointer; font-weight: 600; transition: 0.2s; }
.tab-carousel-tabBtn.is-active { background: #5ba9f7; color: #fff; }
.tab-carousel-panel { display: none; }
.tab-carousel-panel.is-active { display: block; }
.jsSample-tabCarousel .swiper-slide { background: #f5f5f5; border-radius: 8px; padding: 40px 0; text-align: center; font-weight: 600; font-size: 1.1rem; }
.jsSample-tabCarousel .swiper { padding-bottom: 30px; }

JavaScript

data-tab属性は、JavaScript側では要素.dataset.tabという形で取得できます。クリックされたボタンのdataset.tabを見て、対応するIDのパネルだけを表示する、という流れです。

また、あらかじめ3つ分のSwiperインスタンスをすべて作成しておき、swiperMapというオブジェクトにまとめておくことで、タブ切り替え時にどのSwiperをupdate()すればいいかを、すぐに参照できるようにしています。

document.addEventListener('DOMContentLoaded', function () {
  // 3つのカルーセルに共通するオプション
  const swiperOptions = {
    slidesPerView: 2,
    spaceBetween: 16,
    pagination: { clickable: true },
  };

  // タブごとにSwiperインスタンスを作成し、対応付けておく
  const swiperMap = {
    tab1: new Swiper('.tabSwiper1', swiperOptions),
    tab2: new Swiper('.tabSwiper2', swiperOptions),
    tab3: new Swiper('.tabSwiper3', swiperOptions),
  };

  const tabButtons = document.querySelectorAll('.tab-carousel-tabBtn');
  const panels = document.querySelectorAll('.tab-carousel-panel');

  tabButtons.forEach((btn) => {
    btn.addEventListener('click', () => {
      const target = btn.dataset.tab;

      // 一旦すべてのタブ・パネルからis-activeを外す
      tabButtons.forEach((b) => b.classList.remove('is-active'));
      panels.forEach((p) => p.classList.remove('is-active'));

      // クリックされたタブと対応するパネルにis-activeを付ける
      btn.classList.add('is-active');
      document.getElementById(target).classList.add('is-active');

      // 非表示の間にサイズがずれていることがあるのでupdateしておく
      if (swiperMap[target]) swiperMap[target].update();
    });
  });
});
かかかず
かかかず

各コードの詳細はコメントアウトにも記載しているので、チェックしてみてください。

さいごに

さいごに

今回は、タブの切り替えに連動してSwiperのカルーセルも切り替わるUIの作り方についての解説でした。

今回のサンプルでは、最初から3つ分のSwiperを作成していますが、スライド枚数や画像が多い場合は、タブが選択されたタイミングで初めてSwiperを初期化する「遅延初期化」にすると、初期表示のパフォーマンスを抑えられます。

是非あわせてチェックしてみてください。

前の記事

業務スピード
案件の進行が長引くのは「作るスピード」のせいじゃない、とAI時…

次の記事

IntersectionObserverで、PCのhover×…
YouTubeAPI

UI

  • 他のウィンドウが開くことができないポップアップのUIです。

    モーダル

    モーダル

  • 並列な関係を持つ情報を1つずつ格納するUIです。

    タブ

    タブ

  • サイドから全体を覆うほど大きいメニュー表示するUIです。

    ドロワー

    ドロワー

  • 画像などのコンテンツをスライド表示させるUIです。

    スライダー

    スライダー

  • スクロールで表示が変化するスニペットです。

    スクロール

    スクロール

  • クリックすると隠れていた部分が開閉するUIです。

    アコーディオン

    アコーディオン

  • ページのhタグを取得して目次を生成するスニペットです。

    目次

    目次

  • ページの読み込み時にアニメーションをするスニペットです。

    ローディングアニメーション

    ローディングアニメーション

  • マウスオーバーした際に表示される補足説明です。

    ツールチップ

    ツールチップ

  • ページ内上部にあるナビゲーションUIです。

    ヘッダー

    ヘッダー

  • 行と列の組み合わせでできているUIです。

    テーブル

    テーブル

  • データを表やグラフで可視化して見せるUIです。

    グラフ

    グラフ

  • 背景をアニメーションで動かすスニペットです。

    背景

    背景

  • 短いテキスト情報をスクロール表示するUIです。

    ニュースティッカー

    ニュースティッカー

フォーム

  • ラジオボタン、チェックボックス、ドロップダウンリストなどを通じて、ユーザーが入力できるUIです。

    フォーム

    フォーム

文字

  • 文字列をJavaScriptで装飾・動きをつけるスニペットです。

    文字の装飾

    文字の装飾

  • 文字列の操作をして、置換・変更を行うスニペットです。

    文字の操作

    文字の操作

  • 文字列をカウントして表示などを行うスニペットです。

    文字のカウント

    文字のカウント

  • 数字の要素を取得して、変更するスニペットです。

    数字の操作

    数字の操作

ウィンドウ

classの操作

  • 要素を取得して、classを追加・削除するスニペットです。

    classの操作

    classの操作

要素の操作

API

  • WordPressのAPIを取得して表示するスニペットです。

    WP REST API

    WP REST API

  • Google Books APIsで書籍の情報を表示するスニペットです。

    Google Books APIs

    Google Books APIs

  • 楽天市場のAPIを取得して表示するスニペットです。

    楽天市場API

    楽天市場API

  • openBDのAPIを取得して表示するスニペットです。

    openBD

    openBD

画像・動画

  • 画像を取得して、アニメーションなどの変化を加えるスニペットです。

    画像の操作

    画像の操作

  • YouTubeの動画を表示するスニペットです。

    YouTube

    YouTube

リンク

  • ページ内のリンクを取得して変更・操作するスニペットです。

    リンク

    リンク

  • Google Analyticsとの連携をするスニペットです。

    Google Analytics

    Google Analytics

cookie

  • ブラウザのcookieを利用するスニペットです。

    cookie

    cookie

検索

  • 指定した要素の中から検索を行うスニペットです。

    検索

    検索