トグルスイッチの状態を保存する方法
トグルスイッチの状態を保存する方法を紹介します。このサンプルでは、スイッチをONまたはOFFへ切り替えたときに、その状態をブラウザのlocalStorageへ保存します。ページを再読み込みしても保存した状態が復元されるため、利用者が毎回同じ設定を選び直す必要がありません。
通知設定、ダークモード、表示項目の切り替え、管理画面の機能設定など、前回選択した内容を次回も維持したい場面で利用できます。スイッチを操作するたびに状態が自動保存され、ページを閉じてから再度開いた場合でも、同じブラウザ内で前回のON・OFF状態を引き継げます。
タイトル、説明文、項目名はHTMLから変更でき、CSSではトグルスイッチの大きさ、色、余白、角丸などを調整できます。JavaScriptではlocalStorageへ保存するキー名や初期状態を変更できるため、複数の設定項目へ応用しやすく、状態保存の基本を学びたい初心者にも導入しやすいサンプルです。
コードについて
本記事のコードはサンプルコードです。ご利用前に必ず動作確認を行ってください。
免責事項
本コードの利用により発生した損害について、当サイトは一切の責任を負いません。
デモ
通知設定
トグルスイッチの状態を保存し、ページを再読み込みしても維持します。
メール通知
現在の状態:OFF
スイッチを切り替えてからページを再読み込みすると、保存された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="save-toggle-switch-state_wrap">
<!-- タイトル -->
<div class="save-toggle-switch-state_title">
通知設定
</div>
<!-- 説明文 -->
<p class="save-toggle-switch-state_text">
トグルスイッチの状態を保存し、ページを再読み込みしても維持します。
</p>
<!-- トグルスイッチの設定項目 -->
<div class="save-toggle-switch-state_row">
<!-- 項目名 -->
<span class="save-toggle-switch-state_label-text">
メール通知
</span>
<!-- トグルスイッチ -->
<label class="save-toggle-switch-state_switch">
<!-- ON・OFF状態を管理するチェックボックス -->
<input
id="notification-toggle"
class="save-toggle-switch-state_checkbox"
type="checkbox"
aria-label="メール通知のONとOFFを切り替える">
<!-- スイッチの背景と丸いノブ -->
<span class="save-toggle-switch-state_slider"></span>
</label>
</div>
</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; /* ページ全体で使用するフォント */
}
/* 通知設定エリア全体 */
.save-toggle-switch-state_wrap{
width:100%; /* 画面幅に合わせて横幅を縮小 */
max-width:700px; /* 最大横幅。値を大きくすると全体が横へ広がる */
margin:40px auto; /* 上下40pxの余白を付けて左右中央へ配置 */
padding:32px; /* 内側余白。値を大きくすると内容と枠線の間隔が広がる */
border:1px solid #dbe4f0; /* 全体を囲む枠線 */
border-radius:18px; /* 全体の角丸。値を大きくすると丸みが強くなる */
background:#f8fbff; /* 通知設定エリアの背景色 */
color:#111827; /* 通知設定エリアの文字色 */
box-sizing:border-box; /* paddingとborderを横幅へ含める */
}
/* タイトル */
.save-toggle-switch-state_title{
margin:0 0 12px; /* 下側12pxの余白。値を大きくすると説明文との間隔が広がる */
font-size:22px; /* タイトルの文字サイズ。値を大きくすると文字が大きくなる */
font-weight:700; /* タイトルを太字にする */
line-height:1.5; /* タイトルの行間 */
text-align:center; /* タイトルを中央揃えにする */
}
/* 説明文 */
.save-toggle-switch-state_text{
margin:0 0 28px; /* 下側28pxの余白。値を大きくすると設定項目との間隔が広がる */
color:#4b5563; /* 説明文の文字色 */
font-size:16px; /* 説明文の文字サイズ */
line-height:1.8; /* 説明文の行間。値を大きくすると行間が広がる */
text-align:center; /* 説明文を中央揃えにする */
}
/* トグルスイッチの設定項目 */
.save-toggle-switch-state_row{
display:flex; /* 項目名とスイッチを横並びにする */
align-items:center; /* 上下中央へ揃える */
justify-content:space-between; /* 項目名とスイッチを左右へ配置 */
gap:20px; /* 項目名とスイッチの間隔。値を大きくすると広がる */
}
/* 項目名 */
.save-toggle-switch-state_label-text{
font-size:16px; /* 項目名の文字サイズ */
font-weight:700; /* 項目名を太字にする */
line-height:1.5; /* 項目名の行間 */
}
/* トグルスイッチ */
.save-toggle-switch-state_switch{
position:relative; /* チェックボックスとスライダーの配置基準にする */
display:inline-block; /* 横幅と高さを指定できるようにする */
flex-shrink:0; /* 画面幅が狭くてもスイッチを縮めない */
width:88px; /* スイッチの横幅。値を大きくすると横長になる */
height:46px; /* スイッチの高さ。値を大きくすると高くなる */
cursor:pointer; /* マウスポインターを指型にする */
}
/* チェックボックス */
.save-toggle-switch-state_checkbox{
position:absolute; /* スライダーと同じ位置へ配置 */
width:1px; /* 画面上では見えないサイズにする */
height:1px; /* 画面上では見えないサイズにする */
margin:-1px; /* レイアウトへの影響をなくす */
padding:0; /* 内側余白を削除 */
overflow:hidden; /* はみ出した部分を非表示 */
clip:rect(0 0 0 0); /* 視覚的に非表示にする */
white-space:nowrap; /* 改行を防ぐ */
border:0; /* 枠線を削除 */
}
/* スイッチの背景 */
.save-toggle-switch-state_slider{
position:absolute; /* スイッチ全体へ重ねる */
inset:0; /* 上下左右を0にして全面へ広げる */
border-radius:999px; /* 両端を完全に丸くする */
background:#cbd5e1; /* OFF時の背景色 */
transition:background-color 0.3s ease; /* 0.3秒で背景色を切り替える。値を大きくすると遅くなる */
}
/* 丸いノブ */
.save-toggle-switch-state_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); /* ノブの影 */
transition:transform 0.3s ease; /* 0.3秒でノブを移動する。値を大きくすると遅くなる */
}
/* ON時の背景 */
.save-toggle-switch-state_checkbox:checked + .save-toggle-switch-state_slider{
background:#2563eb; /* ON時の背景色 */
}
/* ON時のノブ */
.save-toggle-switch-state_checkbox:checked + .save-toggle-switch-state_slider::before{
transform:translateX(42px); /* ノブを右へ42px移動する */
}
/* キーボード操作時 */
.save-toggle-switch-state_checkbox:focus-visible + .save-toggle-switch-state_slider{
box-shadow:0 0 0 4px rgba(37,99,235,0.16); /* フォーカス時の強調範囲 */
}
/* 画面幅640px以下 */
@media screen and (max-width:640px){
/* ページ全体 */
body{
padding:24px 12px; /* 上下24px・左右12pxへ縮小 */
}
/* 通知設定エリア全体 */
.save-toggle-switch-state_wrap{
margin:24px auto; /* 上下余白を24pxへ縮小 */
padding:24px 18px; /* 上下24px・左右18pxへ縮小 */
}
/* トグルスイッチの設定項目 */
.save-toggle-switch-state_row{
flex-direction:column; /* 項目名とスイッチを縦並びにする */
align-items:flex-start; /* 左揃えにする */
}
}
// ON・OFF状態を保存するトグルスイッチを取得
const notificationToggle=
document.getElementById("notification-toggle");
// localStorageで使用する保存キー
const toggleStateStorageKey=
"notification-toggle-state";
/*
localStorageに保存されている
前回のON・OFF状態を取得する
*/
const savedToggleState=
localStorage.getItem(toggleStateStorageKey);
/*
保存された状態が存在する場合は
文字列のtrue・falseをチェック状態へ変換する
*/
if(savedToggleState !== null){
notificationToggle.checked=
savedToggleState === "true";
}
/*
トグルスイッチが切り替わるたびに
現在の状態をlocalStorageへ保存する
*/
notificationToggle.addEventListener("change",function(){
// checkedのtrue・falseを文字列として保存
localStorage.setItem(
toggleStateStorageKey,
notificationToggle.checked
);
});
コードをコピーする場合
使用するコードのタブを選び、「このタブをコピー」をクリックすると、現在表示中のコードをコピーできます。
サンプル一式を取得する場合
HTML・CSSなどすべてのファイルが必要な場合は、「サンプル一式をダウンロード」をクリックしてください。
ファイル構成と設置方法
このサンプルはHTML・CSS・JavaScriptの3ファイルで構成されています。HTMLでトグルスイッチと状態表示を配置し、CSSでデザインを設定します。JavaScriptではトグルスイッチのON・OFF状態をlocalStorageへ保存し、ページを再読み込みしたときも前回の状態を復元します。簡単な構成のため、初心者でも状態保存の仕組みを学びながら導入できます。
sample/
├── index.html
├── style.css
└── script.js
各ファイルの役割
index.htmlは画面に表示するタイトル、説明文、トグルスイッチ、現在の状態表示を配置するファイルです。表示する文章や項目名を自由に変更できます。
style.cssはカード全体のデザインやトグルスイッチの見た目、配色、サイズ、余白、角丸、アニメーションを設定するファイルです。デザインを用途に合わせて調整できます。
script.jsはトグルスイッチのON・OFF状態を切り替え、現在の状態表示を更新する処理と、localStorageへ状態を保存・復元する処理を担当します。
設置方法・使い方
sampleフォルダへindex.html、style.css、script.jsを配置してください。3つのファイルを同じ階層へ保存したあと、sample/index.htmlをブラウザで開くと利用できます。トグルスイッチを切り替えると状態が自動的に保存され、ページを再読み込みしても前回のON・OFF状態が維持されます。
カスタマイズできる内容
index.htmlではタイトル、説明文、項目名、状態表示の文章を変更できます。通知設定以外にも、ダークモード設定や各種オプション設定など用途に合わせた内容へ変更できます。
style.cssではカード全体の横幅、背景色、文字色、余白、角丸、スイッチのサイズ、ON・OFF時の色、影、アニメーション速度を変更できます。
script.jsでは保存キー名を変更できるため、複数のトグルスイッチを個別に保存するような構成にも対応できます。また、状態表示の内容も用途に合わせて変更できます。
数値調整
style.css
max-width:700px;
カード全体の最大横幅です。値を大きくすると横幅が広がり、小さくするとコンパクトになります。
padding:32px;
カード内側の余白です。値を大きくすると余白が広がり、小さくすると内容が詰まります。
width:88px;
トグルスイッチの横幅です。値を変更するとスイッチ全体の長さが変わります。
height:46px;
トグルスイッチの高さです。値を大きくするとスイッチが大きく表示されます。
width:36px;
丸いノブの大きさです。値を変更するとノブのサイズが変わります。
transform:translateX(42px);
ON時にノブが移動する距離です。スイッチのサイズを変更した場合は、この値も合わせて調整してください。
transition:0.3s;
背景色とノブが切り替わる時間です。0.3秒で変化します。値を大きくするとゆっくり、小さくすると速く切り替わります。
レスポンシブ対応
このサンプルはレスポンシブ対応です。style.cssのwidth:100%とmax-width:700pxによって画面幅に応じてカード全体が縮小されます。また、640px以下ではmedia queryを使用して余白を小さくし、設定項目を縦並びへ変更しています。そのため、スマートフォン・タブレット・PCでも快適に利用できます。
コメント