@k8ordo/router

切り替えのアニメーション

Reactの<ViewTransition>で、ページの切り替えにクロスフェードやスライドを付けます。ルーターがページの切り替えに付けるトランジションの種類で絞ると、切り替えのときだけアニメーションします。

このページの内容

クロスフェード

src/shell.tsx
import { 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を使わないアプリだけです。

k8ordo

Baselineに入った機能を、制限なく使うReactのライブラリ群。