概要

Reactの <ViewTransition>コンポーネントでは、Viewport外の要素はペアにならず、アニメーションしない仕様になっているらしいです。


→ このポートフォリオサイトでは、以下のようなアニメーションを実装するために、View Transitions APIを直接呼び出す実装にしました。


作品詳細ページを一番下までスクロールしてからブラウザで戻ると、画像が画面の上から降りてきて一覧のタイルに収まる
詳細をスクロールしてから一覧に戻る様子のデモ

きっかけ

私のポートフォリオサイトはReactで作っています。


ある日、作品詳細画面から作品一覧ページに戻った時のアニメーションが、場合によって違うことに気づきました。以下が例!

嬉しい:画像がいい感じにアニメーションして一覧に遷移


スクロールせずにブラウザで戻ると、詳細ページの画像がその場で縮んで一覧のタイルに収まる
詳細でスクロールせずに一覧へ

☝️ こっちが理想の挙動です。詳細ページでスクロールせずに戻ると、作品のサムネイル画像がその場で縮んで、一覧のタイルにすっと収まります。


ところが・・・

残念!:ある程度スクロールするとアニメーションせずに遷移


画像が画面外に出るまでスクロールしてからブラウザで戻ると、アニメーションせずに一覧へパッと切り替わる
詳細でスクロールしてから一覧へ

サムネイル画像が画面の外に出るくらいスクロールしてから戻ると、アニメーションせずに一覧へパッと切り替わってしまいます。


個人的には、遷移がカクつかないほうが触ってて気持ちの良いサイトだなと思う!よし直すぞ!Claude先生〜〜!!

仕様の壁あり



Claude先生「それはReactの仕様ですね。」


なんとびっくり。Viewport外の要素はアニメーションしないように、React側がTransitionのペアから外しているらしい。


Reactの公式ドキュメントより:

If either the mounted or unmounted side of a pair is outside the viewport, then no pair is formed.


日本語訳: ペアのマウント側またはアンマウント側のいずれかがビューポートの外にある場合、ペアは形成されません。


ということで、私のポートフォリオでは以下の2ステップで、Viewport外からも要素がアニメーションできるようにしました。


1. ReactにViewTransitionのペアを作らせないようにする


<ViewTransition>のshareはtransition typeごとに指定を変えられます。ブラウザの「戻る」のときだけwork-back-manualというtypeを付けて、そのときはshareをnoneにすると、戻るときだけReactは画像をペアにしなくなります。


const WORK_IMAGE_SHARE = {
  "work-back-manual": "none", // ← 戻るときだけペアを作らない
  default: "morph",
};

<ViewTransition name={`work-image-${slug}`} share={WORK_IMAGE_SHARE}>
  {/* 作品の画像 */}
</ViewTransition>

2. view-transition-nameの名付けを自前実装


ブラウザ標準のView Transitions APIは、名前さえ付いていれば画面外の要素もキャプチャしてくれます。


なので、詳細ページの画像に名前を付けてからdocument.startViewTransitionを直接呼び、一覧が描かれたら作品一覧のタイルにも同じ名前を付けます。


hero.style.viewTransitionName = "work-back-morph"; // 詳細ページの画像に名前を付ける

const transition = document.startViewTransition(async () => {
  await goBack(); // typeを付けて一覧へ戻る
  tile.style.viewTransitionName = "work-back-morph"; // 作品一覧のタイルにも同じ名前を付ける
});

transition.finished.finally(clearNames); // 終わったら名前を外す

(実際のコードを簡略化しています)


なお、Reactとは別に遷移を始める要素ができたので、Reactの遷移や他の操作とぶつかった時の対策として、いくつかエッジケース対応も入れています。(今回は割愛)


ということで、works詳細からスクロールして戻った時にもいい感じのTransitionが再生されるようになりました🎉


作品詳細ページを一番下までスクロールしてからブラウザで戻ると、画像が画面の上から降りてきて一覧のタイルに収まる
一番下までスクロールしててもサムネイル画像が動くぞ!

Reactはなんでこういう仕様にしたんだろう?

仕様書の注意書きでは

This ensures that it doesn’t fly in or out of the viewport when something is scrolled.

また、ソースコード上のコメントでは

// Revert the transition names. This boundary is not in the viewport
// so we won't bother animating it.


などが残されています。


fly in (飛び込む)

fly out (飛び出す)

bother(煩わす)


と、要素がViewport内外を往来することに対して、なんとなくReact側からのウザがりを感じます。


画面外から要素が飛んでくるのが悩みになる、と言っている記事もあるっぽい。


自分でも調べてみたりAIに聞いてみたりしましたが、結局React側の気持ちはよくわかりませんでした。友達に聞いてみたところ「画面外の情報をわざわざレンダリングすることに対して価値がないと思っているんじゃない?」などの考えも教えてもらいました。


もしここまで読んでいただいた方の中に「こうじゃね」的な意見をお持ちの方がいたら、XのコメントやDMでぜひ教えてください!めちゃくちゃ超助かります!!!!


参考

<ViewTransition> – ReactThe library for web and native user interfacesreact.dev ビュー遷移 API - Web API | MDNビュー遷移 API は、異なるウェブサイトのビュー間のアニメーション遷移を簡単に作成するための仕組みを提供します。これには、単一ページアプリケーション (SPA) における DOM 状態変化のアニメーション、および複数ページアプリケーション (MPA) における文書内の移動時のアニメーションを含みます。MDN Web Docs react/packages/react-reconciler/src/ReactFiberCommitViewTransitions.js at cbb046ab92b66dfc4ad1e1ea30d4b8beae6f2c24 · react/reactThe library for web and native user interfaces. Contribute to react/react development by creating an account on GitHub.GitHub Reactの<ViewTransition>で作るUIアニメーション【teamLab Study Session ~frontend~ #2 】にてチームラボのフロントエンドエンジニアが登壇用に作成したスライドです。 teamLab Study Session ~frontend~ とは チームラボのフロントエンド班がチームラボ内で定期的に実施している勉強&hellip;Speaker Deck View Transitions outside the ViewportCSS View Transitions have landed in Chrome and are (for better or worse) widely available to most end...DEV Community 【簡単/宣言的】Next.jsでViewTransitionコンポーネントを使って滑らかなページ遷移を実現するZenn