MotionZoom

画像がその場から全画面へ拡大し、ドラッグして払うと閉じます。

WebReact Nativeオーバーレイ

試してみる

サンプルを準備中…

JavaScript がオフになっています。下のコードがサンプルの全体です。

App.jsx

import { MotionZoom, motionTokens } from '@kkwaenggwari/animated-chorus';
import './styles.css';

// Small generated landscapes, so the example needs no image files.
function landscape(sky, hill, sun) {
  const svg = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 300 200">
    <rect width="300" height="200" fill="${sky}"/>
    <circle cx="220" cy="62" r="26" fill="${sun}"/>
    <path d="M0 150 Q80 90 160 140 T300 120 V200 H0Z" fill="${hill}"/>
    <path d="M0 175 Q110 130 200 170 T300 160 V200 H0Z" fill="#0e2e24"/>
  </svg>`;
  return `data:image/svg+xml,${encodeURIComponent(svg)}`;
}

const photos = [
  landscape('#eaf6f0', '#43c58f', '#ffffff'),
  landscape('#cfe8dc', '#176b52', '#f4faf7'),
  landscape('#176b52', '#2e8f6d', '#eaf6f0'),
  landscape('#f4faf7', '#2e8f6d', '#43c58f'),
  landscape('#0e2e24', '#176b52', '#43c58f'),
  landscape('#43c58f', '#176b52', '#ffffff'),
];

export default function App({ margin = 24, radius = 14, spring = 'default' }) {
  return (
    <div className="stage">
      <div className="grid">
        {photos.map((photo) => (
          <MotionZoom
            key={photo}
            src={photo}
            width={300}
            height={200}
            margin={margin}
            transition={motionTokens.spring[spring]}
            style={{ borderRadius: radius }}
            className="photo"
          />
        ))}
      </div>
      <p className="hint">Click a photo. Drag it away, click or press Escape to close.</p>
    </div>
  );
}

styles.css

.stage {
  display: grid;
  gap: 12px;
  max-width: 620px;
  margin: 0 auto;
  padding: 24px 20px;
}

.grid {
  display: grid;
  grid-template-columns: repeat(3, 1fr);
  gap: 10px;
}

.photo {
  width: 100%;
  height: auto;
  aspect-ratio: 3 / 2;
  object-fit: cover;
  cursor: zoom-in;
}

.hint {
  margin: 0;
  color: #5b616b;
  font-size: 14px;
  text-align: center;
}

いちばん短い使い方

Photo.jsx

<MotionZoom
  src={photo.thumb}
  zoomSrc={photo.full}
  width={240}
  height={160}
  style={{ objectFit: 'cover', borderRadius: 12 }}
/>;

代わりに処理してくれること

クリック、Enter、Space で、画像がその場から margin の内側いっぱいに拡大します。
拡大されたコピーは、object-fit の切り抜きや角の丸みも含め、サムネイルとまったく同じ見た目から始まります。
zoomSrc は読み込みが終わるとフェードインします。
クリック、Escape、またはドラッグで払うと閉じます。すばやく投げても閉じ、短いドラッグならスプリングで戻ります。

こんなときに

写真のグリッド。
商品ギャラリー。
ブログ記事の中の画像。

props

Prop	型	デフォルト	説明
`src`	`string`		その場に表示する画像。
`zoomSrc`	`string`		読み込みが終わると表示される大きな画像。縦横比は同じにしてください。
`margin`	`number`	`24`	拡大した画像のまわりに残す余白(ピクセル)。
`disabled`	`boolean`	`false`	拡大を無効にします。
`onZoomChange`	`(zoomed) => void`		拡大したときに `true`、閉じたときに `false` を受け取って実行されます。
`backdropStyle`	`CSSProperties`		背景のインラインスタイル。
`transition`	`Transition`	`spring`	タイミングカーブ `{ duration, easing }` かスプリング `{ tempo: 'spring', spring }`。スプリングは中断されても勢いを保ちます。

ほかの props は描画される要素に渡るので、className、style、イベントハンドラーはいつもどおり使えます。

Web と React Native

オーバーレイは拡大している間だけ存在するので(Web ではトップレイヤーの dialog)、画像は段落の中など、どこにでも置けます。ほかの props は img に渡ります。

React Native では source と zoomSource を渡します。オーバーレイは透明な Modal です。

使っているサンプル

フォトフィード写真をスワイプで送り、サムネイルで移動し、どの写真も全画面で開いて、詳細を引き上げます。MotionPagerMotionHighlightMotionZoomMotionSheet