スクロールで隠れるヘッダーと「トップに戻る」ボタンを実装する【CSSだけで作ろうとして直した話】
- この記事で分かること
- scrollイベントで前回との差分を見てヘッダーを出し入れする実装と、CSSのscroll-driven animationで作った「トップに戻る」ボタンをscrollイベント方式に作り直した経緯
- 実際に使った環境
- Next.js 16.3.1(App Router)/ Tailwind CSS v4。ヘッダー(Header.tsx)とトップに戻るボタン(BackToTop.tsx)として、このブログの全ページで動いている実装です
- 筆者の結論
- 最新のCSS機能で書けば短く済むが、対応ブラウザと「何を基準に発火するか」を確認せずに採用すると、表示される・されないがページによってばらつく。素朴なscrollイベントの方が確実だった
このブログでは、記事を読んでいて下にスクロールするとヘッダーが画面の外へ隠れ、上にスクロールするとまた現れます。読むときは画面を広く使えて、メニューに戻りたいときはすぐ手が届く、という動きです。右下には、少しスクロールすると現れる「トップに戻る」ボタンもあります。
この記事では、その2つの実装を紹介します。特に「トップに戻る」ボタンは、最初は最新のCSS機能で作り、うまく動かなかったので作り直しました。その経緯も記録しておきます。
🛠 実装してみて分かったこと
「トップに戻る」ボタンは、最初はCSSのスクロール連動アニメーションで作りました。JavaScriptを書かずに済む反面、結果は、ページによって出たり出なかったりする、というものでした。新しい機能は短く書けますが、「何を基準に動くのか」を理解せずに使うと、こういう形でつまずくのだと分かりました。
下スクロールで隠れるヘッダー
ヘッダーはstickyで画面上部に固定したまま、transformで上に押し出して隠しています。display: noneなどで消すのではなく、位置をずらすだけにしているので、ヘッダーの高さ分のレイアウトが変わって内容がガタつくことがありません。
const [hidden, setHidden] = useState(false);
const lastScrollY = useRef(0);
useEffect(() => {
lastScrollY.current = window.scrollY;
const HIDE_THRESHOLD = 80; // ページ最上部付近では隠さない
const SCROLL_DELTA = 8; // このpx以上動いた時だけ判定する(小刻みなブレ対策)
const handleScroll = () => {
const currentY = window.scrollY;
const diff = currentY - lastScrollY.current;
if (menuOpen || currentY < HIDE_THRESHOLD) {
setHidden(false);
} else if (diff > SCROLL_DELTA) {
setHidden(true);
} else if (diff < -SCROLL_DELTA) {
setHidden(false);
}
lastScrollY.current = currentY;
};
window.addEventListener("scroll", handleScroll, { passive: true });
return () => window.removeEventListener("scroll", handleScroll);
}, [menuOpen]);<header
className={`sticky top-0 z-40 transition-transform duration-300 ${
hidden ? "-translate-y-full" : "translate-y-0"
}`}
>仕組みは、前回のスクロール位置(lastScrollY)との差(diff)を見るだけです。正なら下へ、負なら上へスクロールしています。
3つの条件で、動きを落ち着かせる
- ページの上端付近では隠さない(
HIDE_THRESHOLD = 80): 一番上にいるときにヘッダーが隠れていると、どこにメニューがあるのか分からなくなります - 8px以上動いたときだけ判定する(
SCROLL_DELTA = 8): トラックパッドやスマホでは、指を離したときなどに細かく上下に揺れることがあります。差が小さいうちは何もしないことで、ヘッダーが小刻みに出入りするのを防いでいます - メニューを開いている間は隠さない: スマホ幅のハンバーガーメニューを開いたままヘッダーが隠れると、メニューごと見えなくなって閉じられません。
menuOpenのときは常に表示します
最後の条件のために、useEffectの依存配列にmenuOpenを入れています。メニューの開閉が変わったときに、リスナーが新しいmenuOpenの値を見るようにするためです。
useRefに前回位置を入れているのは、値が変わっても再描画させたくないからです。useStateにすると、スクロールのたびに画面が再描画されてしまいます。hiddenだけをuseStateにしているので、再描画が起きるのは表示・非表示が切り替わったときだけです。
「トップに戻る」ボタン: 最初はCSSで作った
このBackToTopは、最初はCSSのscroll-driven animation(animation-timeline: scroll())で作っていました。スクロール量に応じてアニメーションを進められる新しいCSS機能で、JavaScriptを書かずに「スクロールしたらボタンがフェードインする」を実現できます。
ところが、実際に使うと、次のような問題がありました(修正時のコミットメッセージに記録している内容です)。
- 対応しているブラウザが限られる: 当時、この機能が使えたのはChromiumベースのブラウザだけでした
- 発火のタイミングがページによってばらつく: アニメーションは、ページ全体のスクロール可能範囲に対する割合で進みます。そのため、ページが長いか短いかで、ボタンが現れるスクロール量が変わります。あるページでは出ず、別のページでは意図しないタイミングで出る、という状態になりました
つまり、「少しでもスクロールしたら出す」という素朴な条件が、CSSの機能では表現しにくかったのです。
scrollイベントで作り直す
そこで、スクロール量を直接見る方式に変えました。
export default function BackToTop() {
const [visible, setVisible] = useState(false);
useEffect(() => {
const SHOW_THRESHOLD = 40;
const updateVisibility = () => {
setVisible(window.scrollY > SHOW_THRESHOLD);
};
updateVisibility();
window.addEventListener("scroll", updateVisibility, { passive: true });
return () => window.removeEventListener("scroll", updateVisibility);
}, []);
const handleClick = (e: React.MouseEvent<HTMLAnchorElement>) => {
e.preventDefault();
window.scrollTo({ top: 0, behavior: "smooth" });
};
// ...
}window.scrollYが40pxを超えたら表示する、という判定だけです。ページの長さには左右されません。マウント直後にもupdateVisibility()を1回呼んでいるので、ページの途中からリロードされたり、ブラウザがスクロール位置を復元したりした場合も、正しい状態から始まります。
見た目の切り替えはCSSのtransitionで
表示・非表示の切り替えそのものは、JavaScriptで直接スタイルをいじらず、クラスの付け替えとCSSのtransitionで行っています。
<a
href="#top"
onClick={handleClick}
aria-label="ページの先頭に戻る"
aria-hidden={!visible}
tabIndex={visible ? 0 : -1}
className={`fixed bottom-6 right-6 z-30 ... transition-[opacity,transform] duration-300 ease-out ${
visible
? "opacity-100 translate-y-0"
: "opacity-0 translate-y-2 pointer-events-none"
}`}
>
<span aria-hidden="true">↑</span>
</a>透明になっているだけの状態でも、ボタンはDOMに存在しています。そのままだと、見えないのにキーボードのTabキーでフォーカスが当たったり、スクリーンリーダーが読み上げたりしてしまいます。そのため、非表示の間はaria-hiddenとtabIndex={-1}、pointer-events-noneを付けて、操作対象から外しています。
クリックは「滑らかに」先頭へ
クリック時は、リンクの#topへのジャンプをpreventDefault()で止めて、window.scrollTo({ top: 0, behavior: "smooth" })で滑らかに先頭へ戻します。ここでhtml全体にscroll-behavior: smoothを指定せず、クリックしたときだけJavaScriptで滑らかにしているのは、追従目次の記事に書いた理由と同じです。ページ全体に効くCSSは、ページ遷移時のスクロール位置のリセットにまで影響します。
よくある質問
Q. scrollイベントは重くなりませんか?
A. このブログでは、リスナーを登録するときにpassive: trueを指定しています。これは「イベントの中でpreventDefaultを呼ばない」とブラウザに約束するオプションで、ブラウザがスクロールの処理をイベントの完了待ちにせず進められます。また、状態が変わるのは表示・非表示が切り替わるときだけなので、再描画も頻繁には起きません。
Q. ヘッダーを隠すと、メニューを開いたままのときに困りませんか? A. スマホ幅でハンバーガーメニューを開いている間は、スクロールしてもヘッダーを隠さないようにしています。メニューが開いたまま画面外に消えて、閉じられなくなるのを避けるためです。
Q. CSSのscroll-driven animationは使うべきではないですか? A. 用途によります。このブログの「トップに戻るボタン」では、対応しているブラウザが限られることと、ページ全体のスクロール量に対する割合で動くため、ページの長さによって出るタイミングが変わることが問題でした。「少しでもスクロールしたら出す」という条件は、スクロール量を直接見る方が素直に書けます。
まとめ
ヘッダーは、前回のスクロール位置との差を見て出し入れします。上端付近・小さな揺れ・メニュー展開中の3つの例外を入れることで、動きを落ち着かせました。「トップに戻る」ボタンは、CSSのscroll-driven animationで作ったものの、対応ブラウザとページごとの発火のばらつきが問題になり、window.scrollYを直接見る素朴な方式に作り直しました。
新しい機能を選ぶときは、「短く書ける」だけでなく、「何を基準に動くのか」「どのブラウザで動くのか」を先に確認する。今回の作り直しで、改めて残った教訓です。