檢視轉場

在您的 React Router 應用程式中使用 View Transitions API，在頁面轉換之間啟用流暢的動畫。此功能可讓您在用戶端導航期間建立無縫的視覺轉場效果。

基本檢視轉場

啟用檢視轉場最簡單的方式是將 viewTransition 屬性新增至您的 Link、NavLink 或 Form 元件。這會自動將導航更新包裝在 document.startViewTransition() 中。

<Link to="/about" viewTransition>
  About
</Link>

在沒有任何額外 CSS 的情況下，這會在頁面之間提供基本的淡入淡出動畫。

如需使用 View Transitions API 的更多資訊，請參閱 Google Chrome 團隊的「使用 View Transition API 實現流暢轉場效果」指南。

圖片藝廊範例

讓我們建立一個圖片藝廊，示範如何觸發和使用檢視轉場。我們將建立一個圖像清單，這些圖像會展開成具有流暢動畫的詳細檢視。

2. 建立圖片藝廊路由

import { NavLink } from "react-router";

export const images = [
  "https://remix.dev.org.tw/blog-images/headers/the-future-is-now.jpg",
  "https://remix.dev.org.tw/blog-images/headers/waterfall.jpg",
  "https://remix.dev.org.tw/blog-images/headers/webpack.png",
  // ... more images ...
];

export default function ImageGalleryRoute() {
  return (
    <div className="image-list">
      <h1>Image List</h1>
      <div>
        {images.map((src, idx) => (
          <NavLink
            key={src}
            to={`/image/${idx}`}
            viewTransition // Enable view transitions for this link
          >
            <p>Image Number {idx}</p>
            <img
              className="max-w-full contain-layout"
              src={src}
            />
          </NavLink>
        ))}
      </div>
    </div>
  );
}

3. 新增轉場樣式

為應在路由之間流暢轉場的元素定義檢視轉場名稱和動畫。

/* Layout styles for the image grid */
.image-list > div {
  display: grid;
  grid-template-columns: repeat(4, 1fr);
  column-gap: 10px;
}

.image-list h1 {
  font-size: 2rem;
  font-weight: 600;
}

.image-list img {
  max-width: 100%;
  contain: layout;
}

.image-list p {
  width: fit-content;
}

/* Assign transition names to elements during navigation */
.image-list a.transitioning img {
  view-transition-name: image-expand;
}

.image-list a.transitioning p {
  view-transition-name: image-title;
}

4. 建立圖片詳細資料路由

詳細檢視需要使用相同的檢視轉場名稱，以建立無縫動畫。

import { Link } from "react-router";
import { images } from "./home";
import type { Route } from "./+types/image-details";

export default function ImageDetailsRoute({
  params,
}: Route.ComponentProps) {
  return (
    <div className="image-detail">
      <Link to="/" viewTransition>
        Back
      </Link>
      <h1>Image Number {params.id}</h1>
      <img src={images[Number(params.id)]} />
    </div>
  );
}

5. 為詳細檢視新增相符的轉場樣式

/* Match transition names from the list view */
.image-detail h1 {
  font-size: 2rem;
  font-weight: 600;
  width: fit-content;
  view-transition-name: image-title;
}

.image-detail img {
  max-width: 100%;
  contain: layout;
  view-transition-name: image-expand;
}

進階用法

您可以使用渲染屬性或 useViewTransitionState Hook 更精確地控制檢視轉場。

1. 使用渲染屬性

<NavLink to={`/image/${idx}`} viewTransition>
  {({ isTransitioning }) => (
    <>
      <p
        style={{
          viewTransitionName: isTransitioning
            ? "image-title"
            : "none",
        }}
      >
        Image Number {idx}
      </p>
      <img
        src={src}
        style={{
          viewTransitionName: isTransitioning
            ? "image-expand"
            : "none",
        }}
      />
    </>
  )}
</NavLink>

2. 使用 `useViewTransitionState` Hook

function NavImage(props: { src: string; idx: number }) {
  const href = `/image/${props.idx}`;
  // Hook provides transition state for specific route
  const isTransitioning = useViewTransitionState(href);

  return (
    <Link to={href} viewTransition>
      <p
        style={{
          viewTransitionName: isTransitioning
            ? "image-title"
            : "none",
        }}
      >
        Image Number {props.idx}
      </p>
      <img
        src={props.src}
        style={{
          viewTransitionName: isTransitioning
            ? "image-expand"
            : "none",
        }}
      />
    </Link>
  );
}