【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.

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

実装コード紹介

【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も動かずにピタッと止まるのとでは、サイト全体のクオリティや心地よさが大きく変わります。ぜひモーダルやハンバーガーメニューの実装とセットで取り入れてみてくださいね!

Prev