CSSのoverflowで表示・スクロール・切り取りを切り替える方法

CSSの overflow は、内容がボックスからはみ出したときの表示を決めます。必要なときだけボックス内をスクロールするなら auto を使います。装飾を切り取るには、スクリプトで移動できる hidden と、スクロールを禁止する clip を使い分けます。

どのoverflow値を使うか

値 はみ出したときの動作
visible ボックスの外にも表示されます。初期値です。
auto はみ出した内容をボックス内でスクロールできます。
scroll スクロールコンテナーになります。スクロールバーの表示はOSやブラウザーの設定に依存します。
hidden 内容を切り取ります。スクリプトではスクロールできます。
clip 内容を切り取り、JavaScriptでもスクロールできません。

W3CのCSS Overflow仕様

同じボックスでスクロールを比較する

コード全体をUTF-8で overflow-example.html として保存し、ブラウザーで開きます。高さ72pxの三つのボックスに同じ内容を入れています。

<!doctype html>
<html lang="ja">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>同じボックスでスクロールを比較する</title>
  <style>
    body { margin: 1rem; font: 1rem/1.5 system-ui, sans-serif; }
    .box { height: 72px; max-width: 20rem; border: 1px solid #547399; }
    .content { min-height: 180px; padding: .5rem; background: #edf5ff; }
    .auto { overflow: auto; }
    .hidden { overflow: hidden; }
    .clip { overflow: clip; }
    .box:focus-visible { outline: 2px solid #104da2; outline-offset: 2px; }
  </style>
</head>
<body>
  <p id="auto-label">overflow: auto</p>
  <div class="box auto" tabindex="0" role="region" aria-labelledby="auto-label">
    <div class="content">スクロールを確認するための内容です。この文字と薄い背景は、ボックスより背の高い領域に入っています。</div>
  </div>
  <p>overflow: hidden</p>
  <div class="box hidden"><div class="content">スクロールを確認するための内容です。この文字と薄い背景は、ボックスより背の高い領域に入っています。</div></div>
  <p>overflow: clip</p>
  <div class="box clip"><div class="content">スクロールを確認するための内容です。この文字と薄い背景は、ボックスより背の高い領域に入っています。</div></div>
  <p>
    <button type="button" id="move">50pxスクロール</button>
    <button type="button" id="reset">先頭に戻す</button>
  </p>
  <p id="result" role="status"></p>
  <script>
    const boxes = [...document.querySelectorAll(".box")];
    const modes = ["auto", "hidden", "clip"];
    const result = document.querySelector("#result");
    function moveTo(top) {
      boxes.forEach(box => { box.scrollTop = top; });
      result.textContent = boxes.map((box, i) =>
        modes[i] + ": " + box.scrollTop + " px"
      ).join(" / ");
    }
    document.querySelector("#move").addEventListener("click", () => moveTo(50));
    document.querySelector("#reset").addEventListener("click", () => moveTo(0));
  </script>
</body>
</html>

最初のボックスはホイールやタッチでスクロールできます。50pxスクロールを押すと auto: 50 px / hidden: 50 px / clip: 0 px と表示されます。先頭に戻すで三つの位置がゼロになります。

キーボードではTabで最初のボックスにフォーカスを移し、矢印キーでスクロールします。実際のスクロール領域には内容を表す名前を付け、キーボードで出入りできることを確認してください。

hiddenとclipの違い

hidden はスクロールコンテナーを作ります。scrollTop の変更や、子孫要素へのフォーカスで内容が移動することがあります。clip はスクロールコンテナーにならないため、同じ操作でも内容は移動しません。

ブロックで装飾を切り取りつつ浮動要素を内側に含めるには、overflow: clip と display: flow-root を組み合わせます。clip だけでは独立したブロック整形コンテキストは作られません。操作部品やフォーカスの枠が見えることも確認してください。

横方向と縦方向を設定する

値が二つの場合、最初が overflow-x、次が overflow-y です。たとえば overflow: visible auto の計算値は両軸とも auto になります。

overflow: clip auto では、横方向の計算値がブラウザーによって異なります。従来の規則では hidden になります。片方の軸だけをスクロールできるブラウザーでは clip が保持されます。対象ブラウザーの開発者ツールで両軸の計算値を確認してください。

Chrome開発者向けドキュメントの単一軸スクロールの解説

縦にスクロールするには、max-height などで高さが制限されているか確認します。高さに制限がないブロックは内容に合わせて広がります。横にスクロールさせる場合は、実際の幅が内容に必要な幅を下回る必要があります。

スクロールできない、またはページが広がるとき

横方向のFlexレイアウトでページ全体が広がる場合は、スクロール領域を包むFlexアイテムを確認します。内容に基づく最小幅が原因なら、そのアイテムに min-width: 0、内側の領域に overflow-x: auto を試します。縦方向では min-height: 0 が必要か確認します。

W3C仕様のFlexアイテムの自動最小サイズ

長いURLや文字列を折り返す方法は、CSSではみ出す内容や長い文字列を扱う方法で確認できます。