CSS Gridの1frの行で一覧がスクロールしない原因と直し方

​​CSS​CSS Grid,Flexbox,Playwright

ヘッダーとフッターを画面の上下に固定し、その間の本文だけをスクロールさせたいとき、CSS Grid で grid-template-rows: auto 1fr auto と書くことがあります。チャットの画面やメールの受信箱、管理画面のように、入力欄を画面の下に出したままにしたい画面です。ところが、本文の一覧に overflow: auto を付けても一覧の中がスクロールせず、1fr の行が中身の高さまで伸びて、フッターが画面の外に押し出されることがあります。このときは、行の指定を 1fr から minmax(0, 1fr) に変えると、一覧の中だけがスクロールするようになります。

補足

検証環境は Ubuntu 24.04、Node.js 22.23.4、Playwright 1.63.0、ヘッドレスの Chromium 153 です。幅 375px、高さ 600px の画面で、height: 100dvh のグリッドにヘッダー(56px)、本文、フッター(56px)を並べました。本文には高さ 40px の項目を 40 件(合計 1600px)入れ、getComputedStyle() で行の高さの計算値を、clientHeight と scrollHeight で一覧の表示の高さと中身の高さを調べています。Firefox と Safari、スマートフォンの実機は試していません。列の向き(横幅)で同じことが起きる場合は、別の記事「CSS Gridの1frで中身が長いと列がはみ出す原因と直し方」で扱っています。

一覧を別の要素で包むと、1fr の行が伸びる

まず、本文の main そのものに overflow: auto を付けた場合です。

css
.app {
  display: grid;
  height: 100dvh;
  grid-template-rows: auto 1fr auto;
}

main {
  overflow: auto;
}

検証環境では、行の高さの計算値は 56px 488px 56px でした。main の高さは 488px で、中身の 1600px は main の中でスクロールします。フッターは画面の下(上端が 544px の位置)に残りました。この形なら 1fr のままで問題ありません。

崩れるのは、スクロールさせる要素を main の中に入れたときです。一覧の上に見出しや絞り込みのボタンを置く画面では、main をそのままスクロールさせると、それらも一緒に流れてしまいます。そこで main を縦並びの flex にし、見出し(h2、高さ 40px)の下の一覧 ul にだけ flex: 1 と overflow: auto を付けました。

css
main {
  display: flex;
  flex-direction: column;
}

.list {
  flex: 1;
  overflow: auto;
}

この形では、行の高さの計算値が 56px 1640px 56px になりました。1fr の行が、見出しと一覧を合わせた 1640px まで伸びています。一覧の clientHeight と scrollHeight はどちらも 1600px で、一覧の中はスクロールしません。フッターの上端は 1696px の位置になり、高さ 600px の画面の外に出ました。ページ全体の scrollHeight は 1752px で、一覧の代わりにページ全体がスクロールします。

同じことは、次の形でも起きました。

main の中身 行の高さ(計算値) スクロールさせたい要素の表示の高さ
main に overflow: auto 56px 488px 56px 488px(main の高さ。main がスクロール)
ul に overflow: auto; height: 100% 56px 1600px 56px 1600px(スクロールしない)
縦並びの flex に見出しと ul 56px 1640px 56px 1600px(スクロールしない)
2列のグリッドに、overflow: auto の一覧を2つ 56px 1600px 56px 1600px(スクロールしない)

ul に height: 100% を付けても、一覧の高さは 1600px のままでした。main の高さそのものが 1600px まで伸びているので、その 100% も 1600px になります。サイドバーと本文の2列にした場合も、それぞれの列に overflow: auto を付けても、行は伸びました。

1fr の最小値が auto なので、行は中身より低くならない

原因は、1fr の行の最小値にあります。CSS Grid の仕様の <flex> の説明には、minmax() の外に書いた 1fr は、最小値に auto を持つ minmax(auto, 1fr) と同じだと書かれています。そして MDN の minmax() のページにあるとおり、最小値の auto は、その行に入るグリッドアイテムの最小サイズ(min-height で決まる高さ)のうち、いちばん大きいものです。

グリッドアイテムの min-height は、初期値が auto です。仕様の「グリッドアイテムの自動の最小サイズ」の節では、いくつかの条件をすべて満たすと、この auto が中身から決まる最小の高さになると決められています。条件は、アイテムの overflow がスクロールする値でないこと、最小値が auto の行に入っていることなどです。条件を満たさないときは 0 です。CSS Overflow の仕様で、スクロールする値とされているのは scroll、auto、hidden の3つです。

前の節の結果は、この決まりのとおりです。main に overflow: auto を付けたときは、グリッドアイテムである main の overflow がスクロールする値なので、自動の最小サイズは 0 になり、行は 488px に収まりました。一覧を main の中に入れると、グリッドアイテムは overflow を指定していない main になります。main の最小の高さは中身の 1640px で決まり、1fr の行もそこまで伸びました。一覧の overflow: auto は、グリッドから見ると1つ内側の要素の指定なので、行の高さには効きません。この仕組みは列の向きでも同じで、横幅で起きる場合は、先に挙げた別の記事で詳しく扱っています。

minmax(0, 1fr) で、行の最小値を 0 にする

行の最小値を auto から 0 に変えると、行は中身の高さに引っ張られなくなります。

css
.app {
  display: grid;
  height: 100dvh;
  grid-template-rows: auto minmax(0, 1fr) auto;
}

検証環境で、前の節の3つの崩れる形をこの指定に変えたところ、どれも行の高さの計算値は 56px 488px 56px になり、フッターは画面の下に戻りました。一覧の表示の高さと中身の高さは次のとおりです。

main の中身 一覧の表示の高さ 一覧の中身の高さ
ul に overflow: auto; height: 100% 488px 1600px
縦並びの flex に見出しと ul 448px(488px から見出しの 40px を引いた高さ) 1600px
2列のグリッドに、overflow: auto の一覧を2つ 488px 1600px

どれも表示の高さより中身のほうが高く、はみ出した分は一覧の中でスクロールします。見出しは一覧の上に残ったままです。

上下2つの画面の比較。上の「grid-template-rows: auto 1fr auto」では、点線の枠の中にヘッダー、見出しの「受信箱」、メッセージ1〜5が見えるだけで、フッターは枠の外に押し出されて見えない。下の「auto minmax(0, 1fr) auto」では、ヘッダーと見出しの下にメッセージ1〜4が並び、枠の下端に水色のフッター(入力欄)が表示されている
高さを固定した枠の中で、auto 1fr auto と auto minmax(0, 1fr) auto を比べたところ

上の画像は、高さ 300px の枠の中に、高さ 52px のヘッダーとフッター、メッセージ 30 件の受信箱の画面を2つ置いて撮ったものです。本文の測定とは条件が違うので、数値も違います。1fr のほうは、行の高さの計算値が 52px 1268.19px 52px で、フッターは枠の外に出ています。minmax(0, 1fr) のほうは 52px 190px 52px で、一覧の表示の高さは 152px、中身の高さは 1230px でした。

main に min-height: 0 を付けても直る

行の指定を変えずに、グリッドアイテムの側で直すこともできます。grid-template-rows は auto 1fr auto のまま、縦並びの flex にした main に次のどちらかを付けました。

css
main {
  display: flex;
  flex-direction: column;
  min-height: 0; /* または overflow: hidden; */
}

どちらでも、行の高さの計算値は 56px 488px 56px、一覧の表示の高さは 448px になり、minmax(0, 1fr) にしたときと同じ結果でした。min-height: 0 は、main の最小サイズを直接 0 にします。overflow: hidden は、スクロールする値なので、仕様の決まりで自動の最小サイズが 0 になります。flex の中で縦に並べた要素に min-height: 0 が要る場合は、別の記事「CSSのflexで子要素のはみ出しをmin-width: 0で直す方法」で扱っています。

検証した縦並びの flex の形では、行の指定で直しても main の側で直しても、結果は同じでした。行の指定で直す方法は、検証した3つの形(height: 100% の一覧、縦並びの flex、2列のグリッド)のどれでも、main の側に何も足さずに効きました。

外側の高さを min-height にすると、どちらの指定でも行は伸びる

minmax(0, 1fr) が効くのは、グリッドそのものの高さが決まっているときです。グリッドの高さを height: 100dvh ではなく min-height: 100dvh にし、行を auto minmax(0, 1fr) auto にして測りました。

css
.app {
  display: grid;
  min-height: 100dvh; /* height ではなく min-height */
  grid-template-rows: auto minmax(0, 1fr) auto;
}

結果は、行の高さの計算値が 56px 1640px 56px、グリッドの高さが 1752px でした。min-height は「これより低くならない」という指定なので、グリッドは中身に合わせて高くなり、1fr の行もそれに合わせて伸びます。一覧の中だけをスクロールさせたいときは、グリッドの高さを height で決めたうえで、行を minmax(0, 1fr) にします。

​Posted by 86