【JavaScript】overflow: hidden でスクロールバーが消える時の「画面のガタつき」を防ぐ実装方法とデモ
モーダルウィンドウやドロワーメニューを開いた際、背面ページのスクロールを止めるために body 要素へ overflow: hidden; を指定するのは定番の手法です。
しかし、Windowsのブラウザなど「画面右端にスクロールバーが常時表示されている環境」でこれを行うと、スクロールバー(約15px〜17px)が消えた瞬間、その分だけ画面の横幅が広がり、ページ全体のコンテンツが右へ「ガタッ!」とズレてしまう現象が発生します。
近年ではCSSの scrollbar-gutter: stable; を使う方法もありますが、position: fixed で配置した固定ヘッダーのズレまでは防げないケースがあるため、「JavaScriptでスクロールバーの幅を正確に計算し、padding-right で余白を補填する」というアプローチが今も多く使われています。
今回は、JSを使ったスクロールバー幅の取得方法から、固定ヘッダーまで含めてガタつきを抑える実装デモをご紹介します!
デモ動作
See the Pen JSでoverflow:hidden時のスクロールバー消失による画面のガタつきを防ぐ方法 by mikanbako (@mikanbako) on CodePen.
demo: JSでoverflow:hidden時のスクロールバー消失による画面のガタつきを防ぐ方法
実装コード紹介
【HTML】
<!-- 💡 固定ヘッダー(position: fixed の要素もガタつかないように対策!) -->
<header class="p-fixed-header js-fixed-header">
<div class="p-header-inner">
<span>📌 固定ヘッダー (position: fixed)</span>
<span class="c-header-badge">右端の位置に注目👉</span>
</div>
</header>
<!-- 背面のページコンテンツ(スクロールバーを出すために高さを確保) -->
<main class="l-page">
<div class="l-wrap">
<h2>スクロールバー消失の「ガタつき」比較デモ</h2>
<p class="p-desc">2つのボタンを押し比べて、ロック時に画面中央のボックスや固定ヘッダーが右へズレるか確認してみよう!</p>
<!-- 現在のスクロールバー計算値の表示パネル -->
<div class="p-info-panel">
<div class="c-info-row">
<span>📏 現在のスクロールバー幅: <strong class="js-sb-width">0</strong> px</span>
<span class="c-formula"><code>window.innerWidth - document.documentElement.clientWidth</code></span>
</div>
<!-- Macやスマホなどスクロールバー幅が 0px の環境でもガタつきを体験できるスイッチ -->
<label class="c-sim-label">
<input type="checkbox" class="js-sim-check">
<span>幅が 0px の環境(Mac/スマホ等)向けに「16px」でシミュレートする</span>
</label>
</div>
<!-- 比較ボタンエリア -->
<div class="p-card">
<p class="c-card-title">👇 モーダルを開いて背面のガタつきを比較!</p>
<div class="c-btn-group">
<button class="c-btn c-btn--bad js-btn-bad" type="button">
❌ 対策なしでロック<br><small>(overflow: hidden のみ)</small>
</button>
<button class="c-btn c-btn--good js-btn-good" type="button">
⭕ JS対策ありでロック<br><small>(padding-right で幅を補填!)</small>
</button>
</div>
</div>
<!-- 中央配置の目印ガイド -->
<div class="p-guide-box">
<div class="c-guide-line"></div>
<p>🎯 <strong>中央基準ガイドボックス</strong><br>対策なしの場合、スクロールバーが消えた分だけこのボックスが右へガタッと動きます!</p>
</div>
<div class="p-dummy-area">
<p>🔽 ページにスクロールバーを発生させるためのダミー領域です 🔽</p>
<p>一番下までスクロールできます</p>
</div>
</div>
</main>
<!-- 確認用シンプルモーダル -->
<div class="c-modal js-modal">
<div class="c-modal__box">
<h3 class="js-modal-title">ロック中</h3>
<p class="js-modal-desc">背面のボックスや上の固定ヘッダーの位置がズレていないか確認してみてね!</p>
<button class="c-btn c-btn--close js-btn-close" type="button">ロックを解除して閉じる</button>
</div>
</div>
【CSS】
/* 💡 重要:スクロールロック用のクラス */
body.is-scroll-lock {
/* JSで計算した --scrollbar-width の分だけ右側に余白を作ってガタつきを防ぐ! */
padding-right: var(--scrollbar-width, 0);
overflow: hidden;
}
/* 固定ヘッダー */
.p-fixed-header {
position: fixed;
top: 0;
left: 0;
z-index: 100;
box-sizing: border-box;
width: 100%;
color: #fff;
background: #333;
/* 💡 ロック時は固定ヘッダーにも同じ分の padding-right を自動適用! */
padding-right: var(--scrollbar-width, 0);
}
.p-header-inner {
display: flex;
align-items: center;
justify-content: space-between;
max-width: 600px;
padding: 12px 20px;
margin: 0 auto;
font-size: 16px;
font-weight: bold;
}
.c-header-badge {
padding: 3px 10px;
font-size: 14px;
background: #1bb4d4;
border-radius: 20px;
}
/* メインレイアウト */
.l-page {
padding: 70px 20px 100px;
color: #3e3e3e;
text-align: center;
}
.l-wrap {
max-width: 600px;
margin: 0 auto;
}
h2 {
margin-bottom: 10px;
font-size: 16px;
color: #1bb4d4;
}
.p-desc {
margin-bottom: 20px;
font-size: 16px;
font-weight: bold;
color: #666;
line-height: 1.6;
}
/* 情報パネル */
.p-info-panel {
padding: 15px;
margin-bottom: 20px;
text-align: left;
background: #e0f7fa;
border: 2px solid #1bb4d4;
border-radius: 10px;
}
.c-info-row {
display: flex;
flex-wrap: wrap;
gap: 8px;
align-items: center;
justify-content: space-between;
margin-bottom: 10px;
font-size: 16px;
font-weight: bold;
}
.c-info-row strong {
font-family: monospace;
font-size: 20px;
color: #e83e8c;
}
.c-formula code {
padding: 4px 8px;
font-size: 14px;
color: #333;
background: #fff;
border-radius: 4px;
}
.c-sim-label {
display: flex;
gap: 6px;
align-items: center;
font-size: 14px;
font-weight: bold;
color: #00838f;
cursor: pointer;
}
/* チェックボックス */
input[type=checkbox] {
position: relative;
display: inline-block;
width: 16px;
aspect-ratio: 1;
margin-right: 4px;
font-family: inherit;
font-size: 14px;
border: 1px solid #333;
border-radius: 3px;
background-color: white;
cursor: pointer;
}
input[type=checkbox]::before {
position: absolute;
top: 50%;
left: 50%;
width: 80%;
height: 40%;
content: "";
border-bottom: 2px solid #333;
border-left: 2px solid #333;
opacity: 0;
transform: translate(-50%, calc(-50% - 2px)) rotate(-45deg);
transition: opacity 0.3s ease-out;
}
input[type=checkbox]:checked::before {
opacity: 1;
}
/* カードとボタン */
.p-card {
padding: 25px;
margin-bottom: 20px;
background: #fff;
border-radius: 12px;
box-shadow: 0 4px 15px rgb(0 0 0 / 5%);
}
.c-card-title {
margin-bottom: 15px;
font-size: 16px;
font-weight: bold;
}
.c-btn-group {
display: grid;
grid-template-columns: 1fr 1fr;
gap: 12px;
}
.c-btn {
padding: 12px 10px;
font-family: inherit;
font-size: 15px;
font-weight: bold;
line-height: 1.4;
color: #fff;
cursor: pointer;
border: none;
border-radius: 8px;
transition: opacity 0.2s;
}
.c-btn small {
font-size: 13px;
font-weight: normal;
opacity: 0.9;
}
.c-btn:hover {
opacity: 0.85;
}
.c-btn--bad {
background: #e83e8c;
}
.c-btn--good {
background: #1bb4d4;
}
.c-btn--close {
padding: 10px 24px;
margin-top: 10px;
background: #495057;
}
/* ガイドボックス */
.p-guide-box {
position: relative;
padding: 20px;
margin-bottom: 25px;
font-size: 14px;
background: #fff9db;
border: 2px solid #fab005;
border-radius: 10px;
}
.c-guide-line {
width: 2px;
height: 20px;
margin: 0 auto 10px;
background: #e83e8c;
}
.p-dummy-area {
display: flex;
flex-direction: column;
gap: 300px;
padding: 60px 20px;
font-size: 16px;
font-weight: bold;
color: #666;
background: #e9ecef;
border: 2px dashed #adb5bd;
border-radius: 10px;
}
/* 確認用モーダル(背面のズレが見やすいよう背景は薄めに設定) */
.c-modal {
position: fixed;
inset: 0;
z-index: 1000;
display: flex;
visibility: hidden;
align-items: center;
justify-content: center;
background: rgb(0 0 0 / 35%);
opacity: 0;
transition: 0.2s;
}
.c-modal.is-open {
visibility: visible;
opacity: 1;
}
.c-modal__box {
width: 90%;
max-width: 400px;
padding: 25px;
text-align: center;
background: #fff;
border-radius: 12px;
box-shadow: 0 10px 25px rgb(0 0 0 / 20%);
}
.c-modal__box h3 {
margin-bottom: 10px;
font-size: 16px;
color: #1bb4d4;
}
.c-modal__box p {
font-size: 15px;
line-height: 1.6;
color: #555;
}
【JavaScript】
const sbWidthEl = document.querySelector('.js-sb-width');
const simCheck = document.querySelector('.js-sim-check');
const modal = document.querySelector('.js-modal');
const modalTitle = document.querySelector('.js-modal-title');
const modalDesc = document.querySelector('.js-modal-desc');
// 💡 1. スクロールバーの幅を計算する関数
const getScrollbarWidth = () => {
// ウィンドウ全体の幅(スクロールバー含む) - HTMLの表示領域幅(スクロールバー除く)
const realWidth = window.innerWidth - document.documentElement.clientWidth;
// ※デモ用:シミュレートにチェックが入っている場合は仮想で 16px を返す
return simCheck.checked ? 16 : realWidth;
};
// 画面上のスクロールバー幅表示を更新
const updateWidthDisplay = () => {
const width = getScrollbarWidth();
sbWidthEl.textContent = width;
};
window.addEventListener('resize', updateWidthDisplay);
simCheck.addEventListener('change', updateWidthDisplay);
updateWidthDisplay();
// 💡 2. ❌ 対策なしでスクロールロックする関数(ガタつく!)
document.querySelector('.js-btn-bad').addEventListener('click', () => {
// 補正値(--scrollbar-width)を 0px にしてロック
document.documentElement.style.setProperty('--scrollbar-width', '0px');
document.body.classList.add('is-scroll-lock');
modalTitle.textContent = '❌ 対策なしでロック中';
modalDesc.textContent = 'スクロールバーが消えた分だけ、背面のコンテンツや固定ヘッダーが右へガタッとズレてしまいました!';
modal.classList.add('is-open');
});
// 💡 3. ⭕ JS対策ありでスクロールロックする関数(ピタッと止まる!)
document.querySelector('.js-btn-good').addEventListener('click', () => {
// ⚠️ 超重要:必ず「overflow: hidden を付与する前」に幅を計算する!
const scrollbarWidth = getScrollbarWidth();
// 計算した幅を CSS変数(--scrollbar-width)にセットしてからロック!
document.documentElement.style.setProperty('--scrollbar-width', `${scrollbarWidth}px`);
document.body.classList.add('is-scroll-lock');
modalTitle.textContent = `⭕ 対策ありでロック中(+${scrollbarWidth}px 補填)`;
modalDesc.textContent = '消えたスクロールバーと同じ幅の padding-right が瞬時に付与されたため、1pxもズレずにピタッと止まっています✨';
modal.classList.add('is-open');
});
// 💡 4. ロックを解除して閉じる処理
const closeModal = () => {
modal.classList.remove('is-open');
document.body.classList.remove('is-scroll-lock');
// 付与していた余白(CSS変数)を削除
document.documentElement.style.removeProperty('--scrollbar-width');
};
document.querySelector('.js-btn-close').addEventListener('click', closeModal);
modal.addEventListener('click', (e) => {
if (e.target === modal) closeModal();
});
スクロールバー幅の計算とガタつき防止の要点
どうやってスクロールバーの幅を計算するの?
スクロールバーの横幅は、OSやブラウザによって異なります(WindowsのChromeなら約15px〜17px、Macの標準設定やスマホなら画面上に重なるため 0px)。 そのため、padding-right: 15px; のように固定値で決め打ちするのではなく、JavaScriptで「現在の環境での実際のスクロールバー幅」を動的に引き算して求めるのが鉄則です!
// スクロールバーの幅 = ウィンドウ全体の内寸幅 - HTML要素のクライアント幅
const scrollbarWidth = window.innerWidth - document.documentElement.clientWidth;
window.innerWidth
垂直スクロールバーの幅を含んだ表示領域の横幅document.documentElement.clientWidth
垂直スクロールバーを除いたコンテンツ領域の横幅
この引き算を行うだけで、スクロールバーが表示されている環境では 15 や 17 といった正確なピクセル数が、表示されていない環境(スマホやページが短くてスクロールバーが出ていない時)では自動的に 0 が返ってきます!
基本の実装パターン(直接 body.style.paddingRight に入れる方法)
最もシンプルに body 要素のガタつきだけを防ぐ場合は、以下のように記述します。
// 🔒 スクロールをロックする関数
const lockScroll = () => {
// ⚠️ 必ず overflow: hidden を適用する「前」に計算する!
const scrollbarWidth = window.innerWidth - document.documentElement.clientWidth;
if (scrollbarWidth > 0) {
document.body.style.paddingRight = `${scrollbarWidth}px`;
}
document.body.style.overflow = 'hidden';
};
// 🔓 スクロールロックを解除する関数
const unlockScroll = () => {
document.body.style.paddingRight = '';
document.body.style.overflow = '';
};
実装時の注意点:計算する順番
先に overflow: hidden を付与してしまうと、その瞬間にスクロールバーが消えてしまうため、直後に計算しても結果が 0 になってしまいます。必ず「overflow: hidden を付ける前」に幅を計算して変数に保存してください!
固定ヘッダー(position: fixed)のズレも一緒に防ぐ!
非常によくある落とし穴が、「body に padding-right を入れたのに、画面上部の固定ヘッダー(position: fixed; width: 100%;)だけは右にガタッとズレてしまう」という現象です。position: fixed の要素は body ではなく画面全体(ビューポート)を基準に配置されるため、body の padding-right の影響を受けません。
これを解決するには、デモのように 計算した幅を「CSS変数(カスタムプロパティ)」に登録し、body と固定ヘッダーの両方で参照させる設計 が最もおすすめです!
// 【JS】ロック時にルート要素(html)へ CSS変数としてスクロールバー幅をセット
const scrollbarWidth = window.innerWidth - document.documentElement.clientWidth;
document.documentElement.style.setProperty('--scrollbar-width', `${scrollbarWidth}px`);
document.body.classList.add('is-scroll-lock');
/* 【CSS】body と固定ヘッダーの両方に CSS変数の余白を適用する */
body.is-scroll-lock,
body.is-scroll-lock .fixed-header {
padding-right: var(--scrollbar-width, 0px);
}
body.is-scroll-lock {
overflow: hidden;
}
この方法なら、固定ヘッダーや画面右下に固定配置した「トップへ戻るボタン」など、複数の固定要素があってもJSで個別に取得する必要がなく、CSS側だけで一元管理できます!
まとめ
今回は body に overflow: hidden; を指定した際の「スクロールバー消失による画面のガタつき」をJavaScriptで防ぐ方法について解説しました。
- スクロールバーの幅は
window.innerWidth - document.documentElement.clientWidthで正確に計算できる - 幅の計算は必ず
overflow: hiddenを適用する「前」に行う - 計算した幅を CSS変数(
--scrollbar-width)に入れておけば、bodyだけでなくposition: fixedの固定ヘッダーのガタつきもまとめて防げる
モーダルを開いた瞬間に背景が15pxガタッと動くのと、1pxも動かずにピタッと止まるのとでは、サイト全体のクオリティや心地よさが大きく変わります。ぜひモーダルやハンバーガーメニューの実装とセットで取り入れてみてくださいね!