CSSのposition: stickyが途中で外れる原因と直し方

​​CSS​CSS Grid,Flexbox,HTML,Playwright

position: sticky を付けたヘッダーや見出しが、少しのあいだは画面の上に止まるのに、スクロールを続けると途中で外れて流れていくことがあります。ページ全体を包む要素に height: 100vh や height: 100% を付けていると、この外れ方になります。親の height を min-height に替えると、ページの最後まで止まるようになります。

補足

検証環境は Ubuntu 24.04、Node.js 22.23.4、Playwright 1.63.0、ヘッドレスの Chromium 153 です。幅 800px、高さ 600px の画面で、ページ全体を包む .page の中に、高さ 120px の帯、高さ 40px の見出し(position: sticky と top: 0)、高さ 2000px の本文を置きました。ページをスクロールしたときの見出しの上端の位置を getBoundingClientRect() で測っています。Firefox と Safari、スマートフォンのブラウザは試していません。

最初から止まらない場合(top の書き忘れ、祖先の overflow、見出しを短い要素で囲んだ場合)は、「CSSのposition: stickyが効かない原因と直し方」の記事で扱っています。この記事では、親の箱の高さが固定されていて、中身がその箱からはみ出している場合を扱います。

外れ始める位置は、親の高さで決まる

.page の書き方だけを変えて、ページをスクロールしたときの見出しの上端を測りました。見出しが止まっていれば上端は 0px で、外れると上端がマイナスになって画面の外に出ていきます。

.page の CSS .page の高さ scrollY 600 scrollY 1200 外れ始めた scrollY
指定なし 2160px 0px 0px 最後まで外れない
min-height: 100vh 2160px 0px 0px 最後まで外れない
height: 100vh 600px -40px -640px 561
html、body、.page に height: 100% 600px -40px -640px 561
max-height: 100vh 600px -40px -640px 561
height: 1000px 1000px 0px -240px 961

height: 100vh の .page は、中身が 2160px あっても、高さは画面と同じ 600px のままでした。height を固定しても中身は切り取られず、.page の箱の下にはみ出して表示されます。これは MDN の overflow の説明にある、初期値 visible の動きです。見た目は普通に本文が続いているので、.page が途中で終わっていることに気づきにくくなります。

折れ線グラフ。横軸はページの scrollY(0〜1560px)、縦軸は見出しの上端の位置(120〜-1000px)。親に min-height: 100vh を付けた水色の線は、scrollY 120 で 0 になり、そのまま最後まで 0 のまま。親に height: 100vh を付けた灰色の線は、scrollY 560 まで水色の線と重なり、そこから右下へまっすぐ下がって scrollY 1560 で -1000 になる。scrollY 560 の位置にピンクの縦線があり「scrollY 560 を過ぎると外れる」と書かれている
scrollY ごとの見出しの上端。height: 100vh の親では、scrollY 560 を過ぎると見出しが外れる

MDN の position の説明によると、sticky の要素は、包含ブロック(いちばん近いブロックレベルの祖先)の反対の端が来るまで、その位置に止まります。この例の包含ブロックは .page です。.page の下端は、スクロールする前は画面の上から 600px の位置にあります。scrollY が 560 になると、.page の下端が画面の上から 40px、つまり見出しの下端と同じ位置まで上がってきます。そこから先は、見出しは .page の下端と一緒に押し上げられていきます。

height: 1000px で外れ始めた scrollY が 961 だったのも、同じ計算で説明できます。ページの scrollY が、親の高さから見出しの高さ(40px)を引いた値(ここでは 960)を過ぎると外れ始めます。親の高さが画面の高さで決まる 100vh や 100% では、画面の高さによって外れる位置が変わります。画面の高さを 800px にして height: 100vh で測ると、.page の高さは 800px になり、外れ始めた scrollY は 761 でした。

html、body、.page に height: 100% を付けた場合は、height: 100vh と同じ結果でした。MDN の height の説明にあるとおり、パーセントの高さは包含ブロックの高さが基準です。html から順に画面の高さが受け継がれて、.page も 600px になります。max-height: 100vh も、MDN の max-height の説明にあるとおり高さが 100vh を超えないようにするので、同じ結果でした。

height を min-height に替える

親の高さを「少なくとも画面いっぱい」にしたいだけなら、height ではなく min-height を使います。

css
/* 途中で外れる */
.page {
  height: 100vh;
}

/* 最後まで止まる */
.page {
  min-height: 100vh;
}

MDN の min-height の説明のとおり、min-height は高さが指定の値を下回らないようにするだけです。中身が多ければ、親はそのぶん伸びます。検証環境では、.page の高さは中身と同じ 2160px になり、ページの最後(scrollY 1560)まで見出しの上端は 0px のままでした。

html, body, .page { height: 100%; } と書いている場合は、.page の height: 100% を外し、.page に min-height: 100vh を付けます。html と body の height: 100% を残したまま、この形にして測ると、.page の高さは 2160px になり、見出しは最後まで外れませんでした。

フレックスボックスやグリッドで組んだページも同じ

ヘッダーと本文を縦に並べるために、.page を display: flex; flex-direction: column や display: grid にして height: 100vh を付けることがあります。この場合も .page の高さは 600px のままで、見出しは scrollY 561 から外れ始めました。height: 100vh を min-height: 100vh に替えると、どちらも最後まで止まりました。

フレックスボックスで試したときは、見出し・帯・本文の要素に flex: none を付けて、子の要素が縮まないようにしています。中身が少ないページでフッターを画面の下に置くときも、「CSSで、中身が少なくてもフッターを画面の下に置く方法」の記事のように、height ではなく min-height で画面の高さを確保します。

親の箱の高さと、中身の高さを比べる関数

見出しが途中で外れるときに、親の高さが原因かどうかを確かめる関数です。開発者ツールのコンソールに貼り、sticky を付けた要素を渡して呼び出します。

js
// 開発者ツールのコンソールに貼って使う。引数は sticky を付けた要素
// 親の箱の高さと、中身の高さを比べる
function checkParentHeight(el) {
  const p = el.parentElement;
  const c = getComputedStyle(p);
  const box = p.clientHeight;
  const content = p.scrollHeight;
  return {
    parent: p.tagName.toLowerCase() + (p.className ? '.' + p.className : ''),
    boxHeight: box,
    contentHeight: content,
    overflowY: c.overflowY,
    overflowing: c.overflowY === 'visible' && content > box,
  };
}

checkParentHeight(document.querySelector('.bar'));

.bar の部分は、止めたい要素を選ぶセレクターに書き換えます。clientHeight は親の箱の高さ、scrollHeight は中身を含めた高さです。overflowing が true なら、中身が親の箱からはみ出していて、見出しは親の箱の終わりで外れます。

検証環境では、height: 100vh の .page で次の値が返りました。

json
{"parent":"div.page","boxHeight":600,"contentHeight":2160,"overflowY":"visible","overflowing":true}

min-height: 100vh に替えると、boxHeight は 2160 になり、overflowing は false になりました。

親の中だけをスクロールさせる書き方もある

.page の高さを画面に合わせたまま、.page に overflow: auto を付ける書き方もあります。.page の中だけがスクロールするようになり、ページ全体はスクロールしなくなります。

css
.page {
  height: 100vh;
  overflow: auto;
}

MDN の position の説明によると、sticky の要素は、いちばん近いスクロールする祖先に対して止まります。この書き方では .page がその祖先になります。検証環境で .page の scrollTop を 300、600、1200、1560 にすると、どれでも見出しの上端は 0px でした。

ただし、ページ全体の高さ(document.documentElement.scrollHeight)は 600px になり、window.scrollTo(0, 600) を呼んでも window.scrollY は 0 のままでした。マウスホイールで 600px 分スクロールすると、動いたのは .page の scrollTop だけでした。window.scrollTo や window.scrollY を使う処理(ページの先頭へ戻るボタンなど)は、.page の中のスクロールには効かないので、.page の scrollTop を使うように書き換えることになります。そうした処理があるなら、.page の height を min-height に替えるほうが、書き換えは少なくて済みます。

​Posted by 86