CSSのfixedが、親のtransformで効かない原因と直し方

​​CSS​HTML,JavaScript,Playwright

ページの右下に固定した「上へ戻る」ボタンや、画面全体をおおうモーダルの幕が、position: fixed を書いたのにスクロールと一緒に流れてしまうことがあります。原因は、祖先の要素に付いた transform です。transform が付いた要素は、中の position: fixed の要素にとって、画面の代わりの「基準の箱」になります。固定したい要素を transform の付いた要素の外に出すか、<dialog> の showModal() やポップオーバーで最前面に出すと、画面に固定されるようになります。

補足

検証環境は Ubuntu 24.04、Node.js 22.23.4、Playwright 1.63.0、Chromium 153 です。小さな検証用のページを Playwright で開き、画面の大きさを 400×600 にして、スクロールの前と後で getBoundingClientRect() の値を比べました。Firefox と Safari、スマートフォンの実機は試していません。原因の祖先を offsetParent で探す方法も、確かめたのは Chromium だけです。React の createPortal は動かしていません。

2つの小さな画面を縦に並べ、同時に3回下へスクロールする。上の画面は親に何も付けておらず、右下の「上へ戻る」ボタンは、スクロールしても同じ場所に残る。下の画面は親に transform: translateX(0) を付けており、ボタンは最初から画面の外にあって見えない。各画面の下に、ボタンの上端が画面の上から何 px かを表示している。上の画面は 160px のまま変わらず、下の画面は 1144px から 894px、644px、394px と減っていき、ずっと画面の外にある。スクロールが止まった瞬間だけ、下の画面の数字がピンクになる
親に transform があるかどうかで、position: fixed のボタンが画面に固定されたままかを比べた様子。GIF 用に小さくしたページ(高さ 1200px、画面の高さ 216px)で測った値なので、本文の数値とは違う。マウスの絵は GIF 用に描き足したもので、スクロールはスクリプトで行っている

試したページと、起きたこと

検証には、縦に長いページの中に、右下に固定する「上へ戻る」ボタンを置いたページを使いました。ボタンは、ページの中身を囲む .page の中にあります。

html
<main class="page">
  <h1>長いページ</h1>
  <button class="to-top">上へ戻る</button>
</main>
css
/* ページの中身。縦に長くして、スクロールできるようにする */
.page {
  min-height: 2000px;
  padding: 16px;
  box-sizing: border-box;
}

/* 画面の右下に固定したいボタン */
.to-top {
  position: fixed;
  right: 16px;
  bottom: 16px;
  width: 120px;
  height: 48px;
}

このままなら、ボタンの上端は画面の上から 536px(画面の高さ 600px − 下の余白 16px − ボタンの高さ 48px)にあり、500px スクロールしても 536px のままでした。

ところが、.page に transform: translateX(0) を付けると、ボタンの上端はスクロールの前で 1936px、500px スクロールした後で 1436px になりました。画面の高さは 600px なので、ボタンは最初から画面の外にあり、スクロールした分だけ一緒に動きます。1936px は、.page の高さ 2000px から 16px と 48px を引いた値です。ボタンの bottom: 16px が、画面の下の端ではなく、.page の下の端から測られています。

translateX(0) は見た目を何も変えない値ですが、それでもこうなります。

原因は、transform の付いた要素が「包含ブロック」になること

position: fixed の要素は、ふだんは画面(ビューポート)を基準に置かれます。この基準になる箱を、包含ブロックと呼びます。MDN の包含ブロックの解説にある、包含ブロックの決まり方によると、祖先に transform などが none 以外の値で付いていると、position: fixed の要素の包含ブロックは、画面ではなく、その祖先のパディングボックス(内側の余白まで含めた箱)になります。CSS Transforms の仕様にも、transform が none 以外の要素は、子孫の固定配置の要素にとっての包含ブロックになると書かれています。

基準が親に変わるので、困りごとはスクロールだけではありません。position: fixed; inset: 0; で画面全体をおおうつもりの幕を、幅 300px・高さ 200px のカードの中に置いて試しました。カードに何も付けていないとき、幕は (0, 0) から 400×600 で、画面全体をおおいました。カードに transform: translateY(-4px) を付けると、幕は (50, 36) から 300×200 になり、カードと同じ大きさに縮みました。選んだカードを少し浮かせる、といった見た目の工夫が、中のモーダルを壊すことになります。

transform 以外にも、同じことを起こすプロパティ

.page に付けるものを変えて、ボタンの上端がスクロールの前と後でどうなるかを調べました。

.page に付けたもの スクロール前 500px スクロール後 固定されたか
(何も付けない) 536px 536px される
transform: translateX(0) 1936px 1436px されない
transform: none 536px 536px される
translate: 0 1936px 1436px されない
scale: 1 1936px 1436px されない
rotate: 0deg 1936px 1436px されない
perspective: 1000px 1936px 1436px されない
filter: blur(0) 1936px 1436px されない
backdrop-filter: blur(0) 1936px 1436px されない
will-change: transform 1936px 1436px されない
will-change: opacity 536px 536px される
contain: paint 1936px 1436px されない
contain: layout 1936px 1436px されない
container-type: inline-size 536px 536px される
content-visibility: auto 1936px 1436px されない
opacity: 0.99 536px 536px される
position: relative; z-index: 1 536px 536px される
overflow: hidden 536px 536px される

固定が外れたプロパティは、MDN の包含ブロックの解説に挙がっているものと一致しました。translate、scale、rotate は transform とは別のプロパティですが、0 や 1 のように何も変えない値でも、固定が外れました。will-change: transform は、transform そのものを付けていなくても固定が外れるので、見落としやすいところです。一方、opacity: 0.99 を付けた要素、position: relative と z-index を付けた要素、overflow: hidden の要素は、固定の基準にはなりませんでした。

原因の祖先を offsetParent で探す

transform が付いている要素は、固定したい要素のすぐ上の親とは限りません。何段も上のレイアウト用の要素に付いていることもあります。

Chromium では、固定したい要素の offsetParent を調べると、原因の祖先が返りました。開発者ツールのコンソールで、次のように実行します。

js
document.querySelector('.to-top').offsetParent;

.page に何も付けていないときは null でした。.page に transform: translateX(0) や filter: blur(0) を付けると、main.page が返りました。.page の外側に will-change: transform を付けた div.layout を足して、div.layout の中に .page、その中にボタン、という並びにすると、返ったのは div.layout でした。すぐ上の親ではなく、原因の要素が返ります。

CSSOM View の仕様でも、固定配置の要素の offsetParent は、固定配置の基準になる祖先があればその祖先、なければ null を返すと決められています。ただし、MDN の offsetParent のページには、固定配置の要素では Firefox が <body> を返すと書かれています。

直し方1:固定したい要素を、transform の外に出す

いちばん確実なのは、固定したい要素を、transform などが付いた要素の外に置くことです。body の直下に置けば、間に基準を変える祖先がなくなります。

html
<body>
  <main class="page">
    <h1>長いページ</h1>
  </main>
  <!-- transform が付いた .page の外(body の直下)に置く -->
  <button class="to-top">上へ戻る</button>
</body>

.page には transform: translateX(0) を付けたまま試したところ、ボタンの上端はスクロールの前も後も 536px で、画面に固定されました。

HTML を書き換えられないときは、ボタンより後に置いた <script> で、JavaScript を使って body の直下に移しても同じでした。

js
// HTML を変えられないときは、ボタンより後に置いた script で body の直下に移す
document.body.append(document.querySelector('.to-top'));

React では、公式リファレンスの createPortal のページによると、createPortal を使えば、子要素を DOM の別の場所(document.body など)に描けます。

直し方2:dialog の showModal() やポップオーバーで最前面に出す

モーダルや通知のように、ほかのすべての上に出す要素なら、<dialog> の showModal() か、popover 属性で開く方法もあります。この2つで開いた要素は、ページのほかの要素とは別の「最前面の層」(トップレイヤー)に置かれます。CSS Positioned Layout の仕様のトップレイヤーの節には、トップレイヤーにある position: fixed の要素の包含ブロックは画面になる、と書かれています。

transform: translateX(0) を付けた .page の中に、popover="manual" の div と <dialog> を置いて試しました。

html
<main class="page">
  <h1>長いページ</h1>
  <div class="toast" id="toast" popover="manual">保存しました</div>
  <dialog class="toast" id="dlg">保存しました</dialog>
</main>
css
/* ブラウザの既定の位置(画面の真ん中)を消して、右下に置く */
.toast {
  position: fixed;
  inset: auto 16px 16px auto;
  margin: 0;
  width: 200px;
  height: 48px;
  padding: 0;
}

document.getElementById('toast').showPopover() で開いたポップオーバーと、document.getElementById('dlg').showModal() で開いたダイアログは、どちらも上端がスクロールの前も後も 530px で、画面に固定されました(ブラウザが既定で付ける上下 3px の枠線の分だけ、ボタンより少し上です)。クラスを付けずに開くと、ポップオーバーもダイアログも、中心が画面の真ん中の (200, 300) に来ました。右下に置くために、inset と margin を書き直しています。

同じダイアログを showModal() ではなく show() で開くと、上端は 1930px から 1430px に動き、固定されませんでした。MDN のトップレイヤーの解説では、最前面の層に入るダイアログは showModal() でモーダルとして開いたものに限られています。show() で開いたダイアログは最前面の層に入らないので、.page の transform の影響を受けます。

直し方3:表示のアニメーションで transform を残さない

ページを開いたときに、中身を下からふわっと出すアニメーションを、.page のような外側の要素に付けていることがあります。

css
@keyframes fade-in-0 {
  from { opacity: 0; transform: translateY(16px); }
  to   { opacity: 1; transform: translateY(0); }
}

このアニメーションを .page に付けて、終わった後のボタンの位置を調べました。

.page に付けたもの 終わった後の transform 固定されたか
animation: fade-in-0 0.3s both matrix(1, 0, 0, 1, 0, 0) されない
animation: fade-in-0 0.3s forwards matrix(1, 0, 0, 1, 0, 0) されない
animation: fade-in-0 0.3s backwards none される

animation-fill-mode の forwards と、forwards と backwards の両方の動きをする both は、アニメーションが終わった後も、最後のキーフレームの値を持ち続けます。そのため、translateY(0) が残り、ボタンは固定されませんでした。backwards にすると、終わった後の transform は none に戻り、ボタンは 536px に固定されました。最後のキーフレームを transform: none にして both で付けても、終わった後の transform は matrix(1, 0, 0, 1, 0, 0) で、固定されませんでした。none と書いても、アニメーションの値としては「何も動かさない変形」が残ります。

ポイント

アニメーションの途中は、どの書き方でも .page に transform が付いています。backwards で2秒のアニメーションを付けると、約0.5秒の時点ではボタンの上端が約1945px で、画面の外にありました。直し方1でボタンを .page の外に出しておけば、.page に both でアニメーションを付けても、途中のボタンの上端は 536px で、500px スクロールしても 536px のままでした。

​Posted by 86