画像を切り替えるトグルスイッチを作る方法【HTML/CSS/JavaScript・サンプルコード付き】

ラベル・外枠・サイズ・色・角丸・切り替え速度などを設定して、HTML・CSSを自動生成できます。

画像を切り替えるトグルスイッチを作る方法

画像を切り替えるトグルスイッチを作る方法を紹介します。このサンプルでは、トグルスイッチのON・OFF状態に応じて表示する画像を切り替えます。JavaScriptで状態を判定し、2枚の画像を切り替えるシンプルな構成なので、初心者でも仕組みを理解しやすく、そのまま実際のWebサイトへ導入できます。

商品画像の切り替え、テーマ画像の変更、イラストの比較表示、ビフォー・アフター画像の表示など、さまざまな場面で利用できます。トグルスイッチを操作するだけで画像が切り替わるため、ボタンを複数配置する必要がなく、直感的な操作が可能です。お問い合わせページや紹介ページ、ECサイトの商品説明などでも活用できます。

HTMLでは画像や説明文を変更でき、CSSでは画像サイズや余白、角丸、影などを自由に調整できます。JavaScriptでは切り替える画像の指定を変更できるため、用途に合わせて簡単にカスタマイズできます。レスポンシブにも対応しているため、スマートフォン・タブレット・PCでも見やすく利用できます。

コードについて 本記事のコードはサンプルコードです。ご利用前に必ず動作確認を行ってください。

免責事項 本コードの利用により発生した損害について、当サイトは一切の責任を負いません。

デモ

画像切り替えデモ

トグルスイッチを切り替えると表示画像が変わります。

トグルスイッチをON・OFFに切り替えると、「山と湖」と「海と青空」の画像が切り替わります。

コードをコピーして使おう！

<!DOCTYPE html>
<html lang="ja">
<head>

  <!-- 文字コード -->
  <meta charset="UTF-8">

  <!-- スマートフォン対応 -->
  <meta name="viewport" content="width=device-width, initial-scale=1.0">

  <!-- ページタイトル -->
  <title>画像を切り替えるトグルスイッチ</title>

  <!-- CSSファイル -->
  <link rel="stylesheet" href="style.css">

</head>
<body>

  <!-- 画像切り替え全体 -->
  <div class="toggle-switch-image_wrap">

    <!-- タイトル -->
    <div class="toggle-switch-image_title">
      画像切り替え
    </div>

    <!-- 説明文 -->
    <p class="toggle-switch-image_text">
      トグルスイッチを切り替えると表示画像が変わります。
    </p>

    <!-- トグルスイッチの設定項目 -->
    <div class="toggle-switch-image_row">

      <!-- 項目名 -->
      <span class="toggle-switch-image_label-text">
        画像を切り替える
      </span>

      <!-- トグルスイッチ -->
      <label class="toggle-switch-image_switch">

        <!-- ON・OFF状態を管理するチェックボックス -->
        <input
          id="image-toggle"
          class="toggle-switch-image_checkbox"
          type="checkbox"
          aria-label="表示画像を切り替える">

        <!-- スイッチの背景と丸いノブ -->
        <span class="toggle-switch-image_slider"></span>

      </label>

    </div>

    <!-- 切り替える画像 -->
    <img
      id="switch-image"
      class="toggle-switch-image_image"
      src="https://picsum.photos/id/1015/800/450"
      alt="山と湖のサンプル画像">

  </div>

  <!-- JavaScriptファイル -->
  <script src="script.js"></script>

</body>
</html>

/* ページ全体 */
body{
  margin:0; /* ブラウザ標準の外側余白を削除 */
  padding:40px 20px; /* 上下40px・左右20px。値を大きくすると画面端との間隔が広がる */
  background:#ffffff; /* ページ全体の背景色 */
  color:#111827; /* ページ全体の基本文字色 */
  font-family:sans-serif; /* ページ全体で使用するフォント */
}

/* 画像切り替え全体 */
.toggle-switch-image_wrap{
  width:100%; /* 画面幅に合わせて横幅を縮小 */
  max-width:720px; /* 最大横幅。値を大きくすると全体が横へ広がる */
  margin:40px auto; /* 上下40pxの余白を付けて左右中央へ配置 */
  padding:32px; /* 内側余白。値を大きくすると内容と枠線の間隔が広がる */
  border:1px solid #dbe4f0; /* 全体を囲む枠線 */
  border-radius:18px; /* 全体の角丸。値を大きくすると丸みが強くなる */
  background:#f8fbff; /* 全体の背景色 */
  box-sizing:border-box; /* paddingとborderを横幅へ含める */
}

/* タイトル */
.toggle-switch-image_title{
  margin:0 0 12px; /* 下側12pxの余白。値を大きくすると説明文との間隔が広がる */
  color:#111827; /* タイトルの文字色 */
  font-size:22px; /* タイトルの文字サイズ。値を大きくすると文字が大きくなる */
  font-weight:700; /* タイトルを太字にする */
  line-height:1.5; /* タイトルの行間 */
  text-align:center; /* タイトルを中央揃えにする */
}

/* 説明文 */
.toggle-switch-image_text{
  margin:0 0 28px; /* 下側28pxの余白。値を大きくすると設定項目との間隔が広がる */
  color:#4b5563; /* 説明文の文字色 */
  font-size:16px; /* 説明文の文字サイズ */
  line-height:1.8; /* 説明文の行間。値を大きくすると行間が広がる */
  text-align:center; /* 説明文を中央揃えにする */
}

/* トグルスイッチの設定項目 */
.toggle-switch-image_row{
  display:flex; /* 項目名とスイッチを横並びにする */
  align-items:center; /* 項目名とスイッチを上下中央へ揃える */
  justify-content:space-between; /* 項目名とスイッチを左右へ配置 */
  gap:20px; /* 項目名とスイッチの間隔。値を大きくすると広がる */
  margin-bottom:28px; /* 下側28pxの余白。値を大きくすると画像との間隔が広がる */
}

/* 項目名 */
.toggle-switch-image_label-text{
  color:#111827; /* 項目名の文字色 */
  font-size:16px; /* 項目名の文字サイズ */
  font-weight:700; /* 項目名を太字にする */
  line-height:1.5; /* 項目名の行間 */
}

/* トグルスイッチ */
.toggle-switch-image_switch{
  position:relative; /* チェックボックスとスライダーの配置基準にする */
  display:inline-block; /* 横幅と高さを指定できるようにする */
  flex-shrink:0; /* 画面幅が狭くなってもスイッチを縮めない */
  width:88px; /* スイッチの横幅。値を大きくすると横長になる */
  height:46px; /* スイッチの高さ。値を大きくすると高くなる */
  cursor:pointer; /* マウスポインターを指型にする */
}

/* チェックボックス */
.toggle-switch-image_checkbox{
  position:absolute; /* スライダーと同じ位置へ配置 */
  width:1px; /* 画面上では見えないサイズにする */
  height:1px; /* 画面上では見えないサイズにする */
  margin:-1px; /* レイアウトへの影響をなくす */
  padding:0; /* 内側余白を削除 */
  overflow:hidden; /* はみ出した部分を非表示 */
  clip:rect(0 0 0 0); /* 視覚的に非表示にする */
  white-space:nowrap; /* 改行を防ぐ */
  border:0; /* 枠線を削除 */
}

/* スイッチの背景 */
.toggle-switch-image_slider{
  position:absolute; /* スイッチ全体へ重ねる */
  inset:0; /* 上下左右を0にして全面へ広げる */
  border-radius:999px; /* 両端を完全に丸くする */
  background:#cbd5e1; /* OFF時の背景色 */
  transition:background-color 0.3s ease;
  /*
    0.3秒で背景色を切り替える。
    値を大きくすると遅くなり、小さくすると速くなる。
  */
}

/* 丸いノブ */
.toggle-switch-image_slider::before{
  content:""; /* 疑似要素を表示 */
  position:absolute; /* スイッチ内へ配置 */
  top:5px; /* 上側から5pxの位置 */
  left:5px; /* 左側から5pxの位置 */
  width:36px; /* ノブの横幅。値を大きくするとノブが大きくなる */
  height:36px; /* ノブの高さ。値を大きくするとノブが大きくなる */
  border-radius:50%; /* ノブを円形にする */
  background:#ffffff; /* ノブの背景色 */
  box-shadow:0 2px 6px rgba(15,23,42,0.18); /* ノブの影。6pxを大きくすると影が広がる */
  transition:transform 0.3s ease;
  /*
    0.3秒でノブを移動する。
    値を大きくすると遅くなり、小さくすると速くなる。
  */
}

/* ON時のスイッチ背景 */
.toggle-switch-image_checkbox:checked
+ .toggle-switch-image_slider{
  background:#2563eb; /* ON時の背景色 */
}

/* ON時の丸いノブ */
.toggle-switch-image_checkbox:checked
+ .toggle-switch-image_slider::before{
  transform:translateX(42px); /* ノブを右へ42px移動する */
}

/* キーボード操作時 */
.toggle-switch-image_checkbox:focus-visible
+ .toggle-switch-image_slider{
  box-shadow:0 0 0 4px rgba(37,99,235,0.16); /* フォーカス時の強調範囲。4pxを大きくすると広がる */
}

/* 切り替える画像 */
.toggle-switch-image_image{
  display:block; /* 画像下に発生する余白を防ぐ */
  width:100%; /* 親要素の横幅に合わせて縮小 */
  max-width:520px; /* 画像の最大横幅。値を大きくすると画像が広がる */
  aspect-ratio:16 / 9; /* 画像を16:9の比率で表示 */
  margin:0 auto; /* 画像を左右中央へ配置 */
  border-radius:14px; /* 画像の角丸。値を大きくすると丸みが強くなる */
  object-fit:cover; /* 表示領域を埋めるように画像を切り抜く */
  box-shadow:0 10px 24px rgba(15,23,42,0.12); /* 画像の影。24pxを大きくすると影が広がる */
}

/* 画面幅640px以下 */
@media screen and (max-width:640px){

  /* ページ全体 */
  body{
    padding:24px 12px; /* 上下24px・左右12pxへ縮小 */
  }

  /* 画像切り替え全体 */
  .toggle-switch-image_wrap{
    margin:24px auto; /* 上下余白を24pxへ縮小 */
    padding:24px 18px; /* 上下24px・左右18pxへ縮小 */
  }

  /* トグルスイッチの設定項目 */
  .toggle-switch-image_row{
    flex-direction:column; /* 項目名とスイッチを縦並びにする */
    align-items:flex-start; /* 内容を左揃えにする */
  }

}

// 画像を切り替えるトグルスイッチを取得
const imageToggle=
  document.getElementById("image-toggle");

// 切り替え対象の画像を取得
const switchImage=
  document.getElementById("switch-image");

// OFF時に表示する画像URL
const imageOffUrl=
  "https://picsum.photos/id/1015/800/450";

// ON時に表示する画像URL
const imageOnUrl=
  "https://picsum.photos/id/1025/800/450";

/*
  トグルスイッチが切り替わったときに
  ON・OFF状態に合わせて画像を変更する
*/
imageToggle.addEventListener("change",function(){

  // ONの場合は2枚目、OFFの場合は1枚目の画像を表示
  switchImage.src=
    imageToggle.checked
      ? imageOnUrl
      : imageOffUrl;

  // 表示画像に合わせて代替テキストも変更
  switchImage.alt=
    imageToggle.checked
      ? "犬のサンプル画像"
      : "山と湖のサンプル画像";

});

ファイル構成と設置方法

このサンプルはHTML・CSS・JavaScriptの3ファイルで構成されています。HTMLではトグルスイッチと切り替え対象の画像を配置し、CSSではスイッチの見た目や画像サイズ、余白、角丸などを設定します。JavaScriptではトグルスイッチのON・OFF状態を取得し、状態に合わせて表示する画像URLと代替テキストを切り替えます。

sample/
├── index.html
├── style.css
└── script.js

各ファイルの役割
index.htmlは画像切り替え全体を構成するファイルです。「画像切り替え」のタイトル、説明文、「画像を切り替える」の項目名、トグルスイッチ、表示画像を配置しています。表示する画像にはid="switch-image"を指定し、JavaScriptから画像を切り替えられるようにしています。

style.cssはトグルスイッチと画像のデザインを設定するファイルです。全体の横幅や余白、背景色、スイッチの横幅・高さ・色、ノブの大きさや移動量、画像の横幅、比率、角丸、影などを変更できます。

script.jsはトグルスイッチの状態に合わせて画像を切り替えるファイルです。changeイベントでON・OFFを判定し、ONの場合はimageOnUrl、OFFの場合はimageOffUrlで指定した画像へ変更します。同時に画像のaltも表示内容に合わせて変更します。

設置方法・使い方
sampleフォルダへindex.html、style.css、script.jsを同じ階層で配置します。3つのファイルを保存したあと、sample/index.htmlをブラウザで開いてください。初期状態ではトグルスイッチがOFFになっており、imageOffUrlで指定した画像が表示されます。

トグルスイッチをONにすると、表示画像がimageOnUrlで指定した画像へ切り替わります。もう一度OFFにすると、最初の画像へ戻ります。このサンプルでは外部の画像URLを直接指定しているため、imagesフォルダへ画像を配置する必要はありません。

カスタマイズできる内容
index.htmlでは「画像切り替え」のタイトル、「トグルスイッチを切り替えると表示画像が変わります。」の説明文、「画像を切り替える」の項目名を変更できます。また、初期表示画像を変更する場合はsrcとaltを変更します。

script.jsではimageOffUrlとimageOnUrlを書き換えることで、OFF時とON時に表示する画像を変更できます。画像に合わせて、"犬のサンプル画像"と"山と湖のサンプル画像"の代替テキストも変更してください。

style.cssでは全体の最大横幅、余白、背景色、トグルスイッチのサイズ、OFF・ON時の背景色、ノブのサイズ、画像の最大横幅、縦横比、角丸、影などを変更できます。

数値調整
style.css
max-width:720px;
画像切り替え全体の最大横幅です。値を大きくすると全体が横へ広がり、小さくするとコンパクトになります。

margin:40px auto;
全体の上下余白です。40pxを大きくすると上下の間隔が広がり、小さくすると狭くなります。

padding:32px;
全体の内側余白です。値を大きくすると内容と外枠の間隔が広がります。

border-radius:18px;
全体を囲むエリアの角丸です。値を大きくすると丸みが強くなります。

font-size:22px;
タイトルの文字サイズです。値を大きくするとタイトルが大きく表示されます。

margin:0 0 28px;
説明文の下側余白です。28pxを大きくするとトグルスイッチとの間隔が広がります。

gap:20px;
項目名とトグルスイッチの間隔です。値を大きくすると間隔が広がります。

width:88px;・height:46px;
トグルスイッチ本体の横幅と高さです。値を大きくするとスイッチ全体が大きくなります。

top:5px;・left:5px;
丸いノブの初期位置です。それぞれスイッチの上端と左端からの間隔を設定しています。

width:36px;・height:36px;
丸いノブの大きさです。値を大きくするとノブが大きくなります。

transition:0.3s;
スイッチの背景色とノブが切り替わる時間です。0.3秒で変化し、値を大きくするとゆっくり、小さくすると速くなります。

transform:translateX(42px);
ON時にノブを右へ移動する距離です。42pxを変更するとON時のノブの停止位置が変わります。

max-width:520px;
表示画像の最大横幅です。値を大きくすると画像を大きく表示できます。

aspect-ratio:16 / 9;
表示画像の縦横比です。このサンプルでは16:9で表示します。

border-radius:14px;
表示画像の角丸です。値を大きくすると画像の丸みが強くなります。

box-shadow:0 10px 24px rgba(15,23,42,0.12);
表示画像の影です。10pxや24pxを変更すると影の位置や広がりを調整できます。

レスポンシブ対応
このサンプルはレスポンシブ対応です。style.cssでは全体にwidth:100%とmax-width:720px、画像にwidth:100%とmax-width:520pxを指定しているため、画面幅に合わせて縮小されます。

画面幅640px以下ではページ全体の余白を24px 12px、画像切り替え全体の余白を24px 18pxへ縮小します。また、項目名とトグルスイッチをflex-direction:columnで縦並びに変更するため、スマートフォン・タブレット・PCで利用できます。