API

css.viewTransitionClass

★★★★★ Frozen

View Transitions API で、ページや状態の変化をまたいで要素をアニメーションさせます。

export type viewTransitionClass = <const T extends ViewTransition>(rule: T) => string;
export const viewTransitionClass: viewTransitionClass;

viewTransitionClass()は、ビュートランジエーションのアニメーション方法をカスタマイズします。view-transition-classを返します。定義されたルールは、そのクラスを持つすべてのトランジエーションを選択するため、1つの定義は任意の数の要素で共有できます。

トランジションのプレイスメーカーの例を見る を試してみてください。

type ViewTransitionOptions = {
  group?: CSSProperties;
  imagePair?: CSSProperties;
  new?: CSSProperties;
  old?: CSSProperties;
};

React で使う

クラスを<ViewTransition>のdefault、enter、exit、update、またはshareプロパティに渡します:

TypeScript
import * as css from '@plumeria/core';
import { ViewTransition } from 'react';

const fadeIn = css.keyframes({
  from: { opacity: 0 },
  to: { opacity: 1 },
});

const fadeOut = css.keyframes({
  from: { opacity: 1 },
  to: { opacity: 0 },
});

const longCrossFade = css.viewTransitionClass({
  old: {
    animationName: fadeOut,
    animationDuration: '1.2s',
  },
  new: {
    animationName: fadeIn,
    animationDuration: '1.2s',
  },
});

export const Page = ({ children }: { children: React.ReactNode }) => (
  <ViewTransition default={longCrossFade}>{children}</ViewTransition>
);

プロパティは、条件やトランジションタイプでキー付けされたオブジェクトなど、Reactが受け入れる形式を受け入れます。

<ViewTransition
  enter={forward ? slideIn : fadeIn}
  update={{ 'nav-back': slideOut, default: 'none' }}
>

遷移中にリンクされる要素は、nameだけで決定されます。独自の文字列を指定してください(例:name={`photo-${id}`})。クラスがどのようにアニメーションさせるかを決定させます。

css.create で使う

viewTransitionClassで設定し、トランジションに参加するviewTransitionNameの横に配置します。

TypeScript
import * as css from '@plumeria/core';

const slide = css.viewTransitionClass({
  group: { animationDuration: '0.4s' },
});

const styles = css.create({
  card: {
    viewTransitionName: 'card',
    viewTransitionClass: slide,
  },
});

ルールが出力されるとき

ルールは、クラスが css.create で使用されている場合、または react からインポートされた <ViewTransition> のプロパティで使用されるときに発行されます。コンパイラはそのインポートを通じてそれを検出するため、独自のワッパーコンポーネントを通じて渡されるクラスは見えません。直接 <ViewTransition> に記述するか、css.create で viewTransitionClass で設定してください。

Edit on GitHub