CSSのposition: stickyが効かない原因と直し方

​​CSS​Flexbox,HTML,JavaScript,Playwright

position: sticky を付けたのに、スクロールすると要素がそのまま流れていく原因は、大きく3つに分けられます。top などの位置を書いていない、祖先の要素の overflow が止まる基準を変えている、親の要素の中に止まっていられる余地がない、の3つです。ヘッダーやサイドバーの目次、表の見出しを画面に固定したいのに動かないときは、この記事の関数を開発者ツールのコンソールに貼ると、どれに当たるかを絞り込めます。

補足

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

止まらない書き方と、直し方の一覧

見出しが止まれば、600px スクロールしたときの上端は 0px です。止まらなければ、最初の上端 120px から 600px 上に動いた -480px になり、見出しは画面の外に出ます。どの書き方でも、position の計算された値は sticky のままでした。

書き方 600px スクロールしたときの上端 直し方
正しく止まる書き方 0px ―
top を書かない -480px top: 0 などを書く
祖先に overflow-x: hidden -480px overflow-x: clip にする
祖先に overflow: auto(高さの指定なし) -480px overflow を外すか、その祖先に高さを決めてスクロールさせる
body だけに overflow-x: hidden 0px ―
html だけに overflow-x: hidden 0px ―
html と body に overflow-x: hidden -480px どちらか片方だけにする
親が見出しと帯だけを囲む -480px 本文まで続く要素の直下に置く
フレックスボックスの子として高さが伸びている -600px align-self: start を付ける
祖先に transform 0px ―

フレックスボックスの子の行だけは、見出しが一番上にある別のページで測っているので、止まらないときの値が -600px になっています。

コンソールに貼って、原因を絞り込む関数

次の関数は、sticky を付けた要素について、原因の見当をつけるのに必要な値をまとめて返します。ブラウザの開発者ツールのコンソールに貼り、要素を渡して呼び出します。

js
// 開発者ツールのコンソールに貼って使う。引数は sticky を付けた要素
function checkSticky(el) {
  const s = getComputedStyle(el);
  const p = el.parentElement;
  const result = {
    position: s.position,
    insets: { top: s.top, bottom: s.bottom, left: s.left, right: s.right },
    selfHeight: el.getBoundingClientRect().height,
    parentHeight: p.getBoundingClientRect().height,
    alignSelf: s.alignSelf,
    container: null,
  };
  const html = document.documentElement;
  for (let a = p; a && a !== html; a = a.parentElement) {
    const c = getComputedStyle(a);
    const scrolls = (v) => v !== 'visible' && v !== 'clip';
    if (!scrolls(c.overflowX) && !scrolls(c.overflowY)) continue;
    // body の overflow は、html が visible ならページ全体に移るので飛ばす
    if (a === document.body && getComputedStyle(html).overflowX === 'visible' && getComputedStyle(html).overflowY === 'visible') continue;
    result.container = {
      element: a.tagName.toLowerCase() + (a.className ? '.' + a.className : ''),
      overflowX: c.overflowX,
      overflowY: c.overflowY,
      scrollableHeight: a.scrollHeight - a.clientHeight,
    };
    break;
  }
  if (!result.container) result.container = 'ページ全体(ビューポート)';
  return result;
}

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

.bar の部分は、固定したい要素を選ぶセレクターに書き換えます。Chrome の開発者ツールでは、Elements パネルで最後に選んだ要素を $0 で参照できるので、要素を選んでから checkSticky($0) と書いても呼び出せます。

返ってきた値は、次の順に見ます。

  • insets の top と bottom(横に止めるなら left と right)が、どれも auto になっていないか
  • container が ページ全体(ビューポート) 以外になっていないか。なっていれば、その要素の overflow が原因です。scrollableHeight が 0 なら、その要素自体はスクロールしていません
  • selfHeight が parentHeight に近くないか。近ければ、止まっていられる余地がありません

検証環境で .layout に overflow-x: hidden を付けたページでは、次の値が返りました。overflow-y は書いていないのに auto になっていて、scrollableHeight は 0 です。

json
{"position":"sticky","insets":{"top":"0px","bottom":"auto","left":"auto","right":"auto"},"selfHeight":40,"parentHeight":2160,"alignSelf":"auto","container":{"element":"div.layout","overflowX":"hidden","overflowY":"auto","scrollableHeight":0}}

top や bottom を書いていない

position: sticky だけを書き、top を書いていない場合は止まりません。MDN の position の説明には、縦に止めるなら top と bottom が、どちらも auto のままだと、sticky は relative と同じ動きになると書かれています。上に止めるなら top: 0、ヘッダーの高さの分だけ下げて止めるなら top: 64px のように、止める位置を書きます。

祖先の overflow が、止まる基準を変えている

MDN の position の説明(英語版)によると、sticky の要素は、overflow が hidden、scroll、auto、overlay のどれかになっている祖先のうち、いちばん近いものを基準に止まります。その祖先が実際にスクロールしているかどうかは関係ありません。

そのため、祖先に overflow: auto を付けただけで、高さを決めていない場合も止まりません。検証環境では、.layout の高さは中身と同じ 2160px で、.layout 自体はスクロールしませんでした。スクロールしているのはページ全体なので、見出しは止まりませんでした。逆に、高さ 300px で overflow: auto の枠を作り、その中の見出しに top: 0 を付けると、枠を 600px スクロールしたときに見出しの上端は枠の上端(画面の上から 50px)に止まりました。枠の中で止めたいときは、枠に高さを決めてスクロールさせます。

たとえば、横のはみ出しを隠すつもりで祖先に overflow-x: hidden を付けた場合です。overflow-x: clip に替えると止まります。この理由は「CSSのoverflowで、clipとhiddenをどう使い分けるか」の記事で、ヘッダーで起きる例は「Reactで、スクロールすると上に固定されるヘッダーを作る方法」の記事で確かめています。

html か body の片方なら止まり、両方だと止まらない

ページの横スクロールを防ぐために、html や body に overflow-x: hidden を付けることがあります。検証環境では、body だけ、または html だけに付けた場合、見出しは止まりました。html と body の両方に付けた場合は止まりませんでした。

違いが出るのは、overflow の値がページ全体(ビューポート)に移されるためです。CSS Overflow の仕様では、html の overflow は、ページ全体のスクロールに使われます。html の overflow が縦横とも visible のときは、代わりに body の overflow がページ全体に使われ、body 自体は visible として扱われます。

body だけに書いた場合は、値がページ全体に移るので、body は止まる基準になりません。html だけに書いた場合も、値はページ全体に使われ、body は visible のままです。両方に書くと、ページ全体に使われるのは html の値になり、body の overflow-x: hidden は body に残ります。body が止まる基準になり、body 自体はスクロールしないので、見出しは止まりません。

html と body の両方に書いているなら、どちらか片方にまとめます。ややこしいのは、body だけに書いた場合と、両方に書いた場合で、getComputedStyle() で見た body の値がどちらも overflow-x: hidden、overflow-y: auto で同じだったことです。違ったのは html の値で、body だけに書いた場合は縦横とも visible、両方に書いた場合は overflow-x: hidden、overflow-y: auto でした。body の値だけを見ても原因かどうかは分からないので、上の関数は、html の overflow が縦横とも visible のときは body を飛ばして調べるようにしています。

親の中に、止まっていられる余地がない

MDN の position の説明によると、sticky の要素は、包含ブロック(いちばん近いブロックレベルの祖先)の中でしか動けません。top で上に止めた要素は、包含ブロックの下端が来ると、一緒に押し上げられていきます。親が短いと、止まる前に親と一緒に画面の外へ出ていきます。関数の結果で parentHeight が小さいときは、これを疑います。

見出しと帯だけを div で囲んだページでは、parentHeight は 160 で、見出しは上へ流れていきました。見出しは、本文の終わりまで続く要素の直下に移します。

フレックスボックスの子は、高さが伸びて止まらなくなる

親が十分に長くても、要素自体が親と同じ高さまで伸びていると、ずれる余地がありません。サイドバーを display: flex の子にして、サイドバー自体に sticky を付けたページでは、関数の結果で selfHeight と parentHeight がどちらも 2000 になり、alignSelf は auto でした。

MDN の align-self の説明(英語版)によると、auto は親の align-items の値に従います。検証環境では、親の align-items は normal でした。MDN の align-items の説明によると、normal はフレックスボックスの子では stretch として働きます。サイドバーに align-self: start を付けると、高さは中身の分(21px)だけになり、600px スクロールしても上端は 0px に止まりました。

上下2段の比較。どちらも600pxスクロールしたときの画面。上段の、サイドバーが伸びたままのページでは、左のサイドバーに何も見えず、右に本文の段落11から15が見えている。下段の、サイドバーに align-self: start を付けたページでは、左上に「目次」の枠が残り、右に同じ本文が見えている
600pxスクロールしたときの画面。サイドバーが伸びたままだと、目次は画面の外に出る

サイドバーの列ごと伸ばしておき、中の目次だけを止める書き方は、「CSSで、サイドバーを途中から画面に追従させる方法」の記事で扱っています。

bottom: 0 で止まるのは、要素が画面の下端より下にあるあいだだけ

画面の下に止めたいときは bottom: 0 を書きます。

検証環境で、bottom: 0 の要素をページの末尾に置くと、スクロールする前から画面の下端(下端の位置 600px)に止まっていました。同じ要素をページの先頭近く(上から 120px)に置くと、スクロールする前は本来の位置のままで、600px スクロールすると画面の外に出ていきました。bottom の sticky は、画面の下端より下にある要素を下端まで持ち上げて見せますが、本来の位置より下へ動かすことはしません。そのため、画面の上のほうにある要素は、スクロールするとそのまま上へ出ていきます。ページの先頭にある要素を、いつも画面の下に見せておく用途には sticky は合いません。代わりの方法としては、MDN の position の説明によると、ビューポートを基準に配置される position: fixed があります。

祖先の transform は、sticky には影響しない

position: fixed の要素は、祖先に transform があると、ページ全体ではなくその祖先を基準に配置されます。このことは MDN の position の説明に書かれています。sticky についても同じことを疑いたくなりますが、検証環境で .layout に transform: translateZ(0) を付けても、見出しは上端 0px に止まりました。止まらない原因を探すときは、transform より先に overflow と親の高さを見ます。

​Posted by 86