Document: activeViewTransition プロパティ

activeViewTransition は Document インターフェイスの読み取り専用プロパティで、この文書で現在アクティブなビュー遷移を表す ViewTransition インスタンスを返します。

現在の ViewTransition は他の方法でもアクセスできます。

同一文書内でのビュー遷移の場合は Document.startViewTransition() の返値。
文書間のビュー遷移の場合は pagereveal および pageswap のイベントオブジェクトの viewTransition プロパティ。

ただし、activeViewTransition プロパティは、どのようなコンテキストでもアクティブなビュー遷移に一貫した方法でアクセスでき、後で簡単にアクセスできるように保存しておく必要がありません。

値

ViewTransition またはアクティブなビュー遷移がない場合は null。

例

// ビュー遷移を開始
document.startViewTransition(() => {
  // 新しい状態を反映するために UI を更新
  updateUI();
});

// ビュー遷移が現在アクティブかどうかを調べる
if (document.activeViewTransition) {
  console.log("ビュー遷移が現在アクティブです");
}

// ビュー遷移の終了に応答
document.activeViewTransition.finished.then(() => {
  console.log("ビュー遷移終了");
});