ViewTransition: types プロパティ

Baseline 2026

Newly available

Since January 2026, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

types は ViewTransition インターフェイスの読み取り専用プロパティで、ViewTransitionTypeSet であり、このビュー遷移に設定された型にアクセスしたり、変更したりすることができます。

値

ViewTransitionTypeSet です。これは Set 風オブジェクトであり、clear()、add()、delete() などのメソッドを利用して、ビュー遷移に適用されているタイプをその場で変更することができます。

例

基本的な使い方

この例では、2 つの異なるコンテンツ間で遷移を伴う基本的な文書を記載しています。3 つのボタンを指定しており、それぞれが遷移を開始しますが、type 属性をそれぞれ異なる値に設定することで、遷移に異なる種類のアニメーションを適用しています。

HTML

このマークアップには、コンテンツを含む単一の <p> 要素と、ビュー遷移を開始するための 3 つの <button> 要素があります。

html

<p>これが私の初めてのコンテンツです。気に入っていただけるといいなぁ。</p>
<div>
  <button id="default">Default</button>
  <button id="slide">Slide</button>
  <button id="flip">Flip</button>
</div>

JavaScript

このスクリプトでは、ボタンと本文の参照を作成し、2 つの異なるコンテンツを2つの定数に格納するために使用します。

const defaultBtn = document.getElementById("default");
const slideBtn = document.getElementById("slide");
const flipBtn = document.getElementById("flip");
const content = document.querySelector("p");

const first =
  "これが私の初めてのコンテンツです。気に入っていただけるといいなぁ。";
const second = "これが私の 2 つ目のコンテンツです。1 つ目より良いでしょう？";

次に、ボタンに click イベントのリスナーを追加します。ボタンがクリックされると、changeContent() 関数が実行されます。

defaultBtn.addEventListener("click", changeContent);
slideBtn.addEventListener("click", changeContent);
flipBtn.addEventListener("click", changeContent);

最後に、changeContent() 関数を定義します。まず、startViewTransition() メソッドを呼び出してコンテンツを更新し、トランジションが始まるようにします。そして、返された ViewTransition オブジェクトを vt という定数に格納します。startViewTransition() 内では、update コールバックが、段落の textContent が first の文字列と等しいかどうかを調べます。等しい場合は、second の文字列に設定します。等しくない場合は、first の文字列に設定します。

changeContent() 関数の後半では、click イベントの対象となる要素の値を調べます。

「スライド」ボタンの場合は、vt.types.add("slide") を使用して、アクティブなビュー遷移の型に slide 型を追加します。
「Flip」ボタンの場合は、vt.types.add("flip") を使用して、アクティブなビュー遷移の型に flip 型を追加します。
「デフォルト」ボタンが押された場合は、何らかの処理を行いません。この場合、デフォルトのビュー遷移であるクロスフェードアニメーションを使用します。

function changeContent(e) {
  const vt = document.startViewTransition({
    update() {
      content.textContent === first
        ? (content.textContent = second)
        : (content.textContent = first);
    },
  });

  if (e.target === slideBtn) {
    vt.types.add("slide");
  } else if (e.target === flipBtn) {
    vt.types.add("flip");
  }
}

CSS

このスタイルでは、まず :active-view-transition 擬似クラスを使用して、一連のルールを作成します。これらのスタイルは、ビュー遷移の種類にかかわらず、ビュー遷移がアクティブなときは常に適用されます。view-transition-name には none の値を :root に適用しています。これは、<p> 要素には view-transition-name として content を指定していますが、それ以外の要素は遷移時に捕捉されてアニメーションしないようにするためです。

html,
body {
  height: 100%;
}

body {
  display: flex;
  flex-direction: column;
  justify-content: center;
  align-items: center;
}

div {
  display: flex;
  width: 60%;
  justify-content: space-between;
}

p {
  font-size: 1.7em;
  width: 60%;
  color: blue;
  background-color: white;
  margin-top: 0;
}

css

html:active-view-transition {
  :root {
    view-transition-name: none;
  }
  p {
    view-transition-name: content;
  }
}

次に、:active-view-transition-type() 擬似クラスを使用して、2 つのネストされたスタイルブロックを作成します。1 つ目は、アクティブなビュー遷移の型が slide の場合にのみ適用されるブロックで、2 つ目は、アクティブなビュー遷移の型が flip の場合にのみ適用されるブロックです。それぞれのブロックでは、::view-transition-old() および ::view-transition-new() という擬似要素を使用して、slide キャプチャグループの遷出ビューと遷入ビューに、独自の animation-name 値を適用しています。

結果的に、次のようになります。

遷移型が slide の場合、古いコンテンツビューが左へスライドして消え、新しいコンテンツビューが右からスライドして表示されます。
遷移型が flip の場合、古いコンテンツビューは水平方向に 90 度回転して非表示となり、新しいコンテンツビューが回転して表示されます。
それ以外の場合は、デフォルトのクロスフェードビュー遷移のアニメーションが使用されます。

css

html:active-view-transition-type(slide) {
  &::view-transition-old(content) {
    animation-name: slide-out-to-left;
  }
  &::view-transition-new(content) {
    animation-name: slide-in-from-right;
  }
}

html:active-view-transition-type(flip) {
  &::view-transition-old(content) {
    animation-name: flip-out;
  }
  &::view-transition-new(content) {
    animation-name: flip-in;
    animation-delay: 0.6s;
  }
}

最後に、@keyframes アニメーションブロックを使用して、前回参照したアニメーションを定義します。同時に、すべてのキャプチャグループに対して独自の animation-duration を設定し、遷移アニメーションの速度をわずかに遅くします。

css

@keyframes slide-out-to-left {
  to {
    translate: -100vw 0;
  }
}
@keyframes slide-in-from-right {
  from {
    translate: 100vw 0;
  }
}

@keyframes flip-out {
  to {
    rotate: x 90deg;
  }
}
@keyframes flip-in {
  from {
    rotate: x -90deg;
  }
}

::view-transition-group(*) {
  animation-duration: 0.6s;
}