切り替えのアニメーション
Reactの<ViewTransition>で、ページの切り替えにクロスフェードやスライドを付けます。ルーターがページの切り替えに付けるトランジションの種類で絞ると、切り替えのときだけアニメーションします。
このページの内容
クロスフェード
src/shell.tsximport { Outlet } from '@k8ordo/router';
import { ViewTransition } from 'react';
export function Shell() {
return (
<>
<header>…</header>
<ViewTransition
default="none"
update={{ navigation: 'auto', default: 'none' }}
`<ViewTransition>`自体はマウントされたままで中身だけが変わるので、`update`に書く
>
<Outlet />
</ViewTransition>
</>
);
}ページを描画する<Outlet />を<ViewTransition>で包みます。autoはブラウザ標準のクロスフェードです。
このサイトもページを同じ<ViewTransition>で包んでいます。サイドバーから別のページを開くと、本文がクロスフェードします。
@k8ordo/frameworkでは、レイアウトのchildrenを同じ<ViewTransition>で包みます。レイアウトの書き方は@k8ordo/frameworkのルーティングを見てください。
トランジションの種類
ルーターは、ページを切り替える描画にnavigationというトランジションの種類を付けます。updateにnavigationのキーを書き、propのdefaultとupdateのdefaultをnoneにすると、この種類の描画だけがアニメーションします。
ページの切り替えのほかに、トランジションも<ViewTransition>を動かします。startTransitionで包んだ更新や、@k8ordo/uiのButtonが実行するアクションも対象です。種類で絞らないと、ボタンを押すたびにページ全体がクロスフェードします。
クエリだけを変える状態の更新は、ページを切り替えないのでアニメーションしません。
戻るときのスライド
src/shell.tsx<ViewTransition
default="none"
update={{
'navigation-push': 'slide-forward',
'navigation-replace': 'slide-forward',
'navigation-traverse': 'slide-back',
default: 'none',
}}
>
<Outlet />
</ViewTransition>ルーターはnavigationに加えてnavigation-push、navigation-replace、navigation-traverseのどれかも付けます。リンクのクリックとnavigateToはpushです。navigateToに{ history: 'replace' }を渡すとreplaceになります。ブラウザの戻る、進むはtraverseです。
src/app.css@keyframes slide-from-right {
from {
opacity: 0;
translate: 32px 0;
}
}
@keyframes slide-from-left {
from {
opacity: 0;
translate: -32px 0;
}
}
::view-transition-new(.slide-forward) {
animation: 200ms ease-out both slide-from-right;
}
::view-transition-new(.slide-back) {
animation: 200ms ease-out both slide-from-left;
}updateの値はview transitionのクラス名になります。クラスごとの動きは、::view-transition-old()と::view-transition-new()で書きます。
動きを減らす設定
src/app.css@media (prefers-reduced-motion: reduce) {
::view-transition-group(*),
::view-transition-old(*),
::view-transition-new(*) {
animation: none;
}
}prefers-reduced-motionがreduceのとき、view transitionのアニメーションを止めます。@k8ordo/uiのスタイルシートにはこの規則が入っているので、書くのは@k8ordo/uiを使わないアプリだけです。