View Transitions APIでページ遷移をアニメーション
View Transition APIは、DOMを書き換える前の画面から後の画面へアニメーションで切り替えるAPIです。startViewTransitionとview-transition-nameの書き方と、擬似要素での調整を説明します。
- Chrome111
- Edge111
- Firefox144
- Safari18
- Chrome125
- Edge125
- Firefox144
- Safari18.2
はじめに
View Transition API(View Transitions API)は、DOMを書き換える前の画面から後の画面へ、アニメーションで切り替えるAPIです。並び替えやSPAのページ遷移のように、DOMを書き換えて画面が変わる場面で使えます。Firefox 144が対応して、Baseline 2025に入りました。
1つの要素の色や大きさの変化は、CSSのtransitionで動かせます。並び替えで要素の位置が変わったり、要素を足したり消したりする変化は、transitionでは動かせません。View Transition APIなら、こうした変化もアニメーションにできます。
<button id="reverse">並びを逆にする</button>
<ul id="list">
<li style="view-transition-name: a">A</li>
<li style="view-transition-name: b">B</li>
<li style="view-transition-name: c">C</li>
</ul>document.getElementById('reverse').addEventListener('click', () => {
document.startViewTransition(() => {
const list = document.getElementById('list');
list.append(...[...list.children].reverse());
});
});結果の欄でボタンを押すと、AとCが互いの位置へ0.25秒かけて滑るように動きます。以下では、View Transition APIで動くアニメーションを遷移アニメーションと呼びます。
startViewTransition
遷移アニメーションは、document.startViewTransition()にDOMを書き換える関数を渡して始めます。
const reverseList = () => {
const list = document.getElementById('list');
list.append(...[...list.children].reverse());
};
document.startViewTransition(reverseList);引数にオブジェクトを渡すと、DOMを書き換える関数をupdateに、遷移の種類を表す名前をtypesに書けます。種類ごとに、遷移アニメーションのスタイルを変えられます。
document.startViewTransition({
update: reverseList,
types: ['reverse'],
});typesを渡した遷移の間は、ルート要素が:active-view-transition-type()に当たるので、種類ごとのスタイルはこの擬似クラスに続けて書きます。
/* reverseの遷移だけ、1秒かけて動かす */
:root:active-view-transition-type(reverse)::view-transition-group(*) {
animation-duration: 1s;
}startViewTransitionが返すViewTransitionオブジェクトは、遷移の進み具合を表す3つのPromiseを持ちます。updateCallbackDone、ready、finishedの順に解決します。
const transition = document.startViewTransition(reverseList);
transition.updateCallbackDone.then(() => {
// DOMの書き換えが終わったら解決する
});
transition.ready.then(() => {
// 遷移アニメーションが始まる直前に解決する
});
transition.finished.then(() => {
// 遷移アニメーションが終わったら解決する
});skipTransition()を呼ぶと、遷移アニメーションを飛ばして書き換えた後の画面にします。
const transition = document.startViewTransition(reverseList);
const timeoutId = setTimeout(() => {
// 1秒経ったら遷移アニメーションを飛ばす
transition.skipTransition();
}, 1000);
transition.finished.then(() => {
// 1秒より前に終わったら、飛ばす処理を取り消す
clearTimeout(timeoutId);
});関連するCSS
view-transition-name
view-transition-nameは、前と後の画面で同じ要素として扱う要素に付ける名前です。同じ名前を持つ要素どうしが、前の位置と大きさから後の位置と大きさへ動きます。はじめにの例では、liにaとb、cの名前を付けたので、並びを逆にするとAとCが入れ替わるように動きました。
初期値はnoneで、名前の無い要素は個別には動かず、画面全体の一部として切り替わります。ブラウザの既定のスタイルで、:rootにview-transition-name: rootが付いているためです。:rootにnoneを指定すると画面全体が対象から外れ、名前を付けた要素だけが動きます。
同じ画面に同じview-transition-nameの要素が2つあると、遷移アニメーションは飛ばされます。DOMの書き換えは行われ、readyはInvalidStateErrorで拒否されます。リストの要素に名前を付けるときは、item-1のように要素ごとに違う名前にします。
view-transition-class
view-transition-classは、名前の違う複数の要素に、遷移アニメーションのスタイルをまとめて当てるための分類です。
li {
view-transition-class: item;
}
::view-transition-group(.item) {
animation-duration: 0.5s;
}はじめにの例のliにこう書くと、a、b、cの3つの遷移がまとめて0.5秒になります。::view-transition-group()は、後で説明する擬似要素です。
:active-view-transition
:active-view-transition擬似クラスは、遷移アニメーションが進んでいる間、文書のルート要素(<html>)に当たります。ほかの要素には当たらないので、遷移中のスタイルは:root:active-view-transitionの子孫として書きます。
/* 遷移中は、押せないことが伝わるようにボタンを薄く表示する */
:root:active-view-transition .transition-button {
opacity: 0.8;
}遷移アニメーションの擬似要素
遷移アニメーションの間、ページの上には次の擬似要素が、上から順に入れ子になって重なります。括弧の中には、view-transition-nameの名前か、.から始まるview-transition-classの名前を書きます。名前の無い要素をまとめたrootと、すべてを表す*も使えます。
::view-transition:ビューポート全体を覆う、すべての遷移の入れ物::view-transition-group():名前ごとの入れ物で、前の位置と大きさから後の位置と大きさへ動く::view-transition-image-pair():前と後の画像を重ねる入れ物::view-transition-old()と::view-transition-new():前の画面と後の画面の画像。既定では、前の画像が消えながら後の画像が現れる
<label>
<input id="group" type="checkbox" />
::view-transition-group() に点線の枠を付ける
</label>
<label>
<input id="old" type="checkbox" />
::view-transition-old() を隠す
</label>
<label>
<input id="new" type="checkbox" />
::view-transition-new() を隠す
</label>
<button id="resize">大きさを変える</button>
<div class="stage">
<div id="box"></div>
</div>#box {
view-transition-name: box;
width: 3rem;
height: 3rem;
background-color: steelblue;
}
#box.large {
width: 6rem;
height: 6rem;
margin-inline-start: auto;
background-color: seagreen;
}
::view-transition-group(box) {
animation-duration: 1s;
}
:root:has(#group:checked)::view-transition-group(box) {
outline: 2px dashed CanvasText;
}
:root:has(#old:checked)::view-transition-old(box),
:root:has(#new:checked)::view-transition-new(box) {
animation: none;
opacity: 0;
}
label {
display: block;
}
.stage {
display: flex;
align-items: center;
height: 6rem;
margin-block-start: 1rem;
}const box = document.getElementById('box');
document.getElementById('resize').addEventListener('click', () => {
document.startViewTransition(() => {
box.classList.toggle('large');
});
});結果の欄の例では、遷移を1秒にしています。::view-transition-group()に枠を付けると、枠が小さい箱の位置と大きさから大きい箱の位置と大きさへ動きます。
::view-transition-new()を隠すと、前の画像だけが、枠に合わせて大きくなりながら消えていきます。反対に::view-transition-old()を隠すと、後の画像だけが、透明に近い状態から現れます。
おわりに
View Transition APIを使うと、startViewTransitionでDOMを書き換えるだけで、画面の変化にアニメーションが付きます。動かす要素はview-transition-nameで選び、動き方は::view-transition-group()などの擬似要素で変えられます。
@view-transitionによる別のページへ移るときの遷移がBaselineに入れば、複数のページからなるサイトでも同じアニメーションを付けられるようになります。その日が来るのを楽しみにしています。