Svelte 5のRunesとActionで作る、山登りのスクロール演出
Svelte
「Svelte Base」は、ページ全体を「山登り」に見立てたデザインに作り直しました。スクロールで要素がふわっと出る演出、山に寄っていくヒーロー、画面の横の標高計、初回だけのローディング。どれもアニメーションのライブラリは使わず、Svelte 5 の Runes と Action、少しの CSS で書いています。
リポジトリ:SvelteKit-TypeScript-MicroCMS-Site / デモ:https://sveltebase-phi.vercel.app/
Svelte 5 の Runes
Svelte 5 では、props は $props()、状態は $state()、ほかの値から計算する値は $derived() で宣言します。トップページでは、取得した記事から Svelte の記事だけを $derived で取り出しています。
<script lang="ts">
import type { PageData } from './$types';
let { data }: { data: PageData } = $props();
const posts = $derived(data.contents.filter((c) => c.category?.name === 'Svelte').slice(0, 3));
</script>画面に入ったら表示する:reveal アクション
Action は use:名前 で要素に付けられる関数です。要素が DOM に追加されたときに呼ばれ、戻り値の destroy は取り外されるときに呼ばれます。IntersectionObserver のような「要素ごとに監視して、最後に止める」処理にぴったりです。
// src/lib/reveal.ts
import type { Action } from 'svelte/action';
/** 画面内に入ったら .is-in を付与する */
export const reveal: Action<HTMLElement> = (node) => {
const io = new IntersectionObserver(
(entries) => {
for (const e of entries) {
if (!e.isIntersecting) continue;
e.target.classList.add('is-in');
io.unobserve(e.target);
}
},
{ threshold: 0, rootMargin: '0px 0px -12% 0px' }
);
io.observe(node);
return { destroy: () => io.disconnect() };
};rootMargin の下側をマイナスにしているので、要素が画面の下端から少し入ったところで表示が始まります。使う側は class="reveal" と use:reveal を付けるだけです。style:--d で遅れを渡すと、並んだ要素を少しずつずらして出せます。
<div class="head reveal" use:reveal>...</div>
{#each posts as p, i (p.id)}
<a class="post reveal" href="/{p.id}" style:--d="{i * 0.1}s" use:reveal>...</a>
{/each}.reveal {
opacity: 0;
transform: translateY(28px);
transition:
opacity 0.9s var(--ease) var(--d, 0s),
transform 1s var(--ease) var(--d, 0s);
}
.reveal.is-in { opacity: 1; transform: none; }動きの関数を lib にまとめる
ヒーローと標高計はどちらもスクロールに合わせて動くので、共通の関数を src/lib/motion.ts にまとめました。スクロールイベントは 1 フレームに何度も来るので、requestAnimationFrame で 1 回に間引きます。戻り値はイベントを外す関数なので、onMount からそのまま返せます。
// src/lib/motion.ts
export const prefersReducedMotion = () =>
typeof matchMedia !== 'undefined' && matchMedia('(prefers-reduced-motion: reduce)').matches;
export const clamp01 = (v: number) => Math.min(Math.max(v, 0), 1);
/** smoothstep */
export const smooth = (v: number) => v * v * (3 - 2 * v);
/** スクロールイベントを requestAnimationFrame で間引く */
export const onScrollFrame = (update: () => void) => {
let ticking = false;
const onScroll = () => {
if (ticking) return;
ticking = true;
requestAnimationFrame(() => {
update();
ticking = false;
});
};
update();
addEventListener('scroll', onScroll, { passive: true });
addEventListener('resize', onScroll);
return () => {
removeEventListener('scroll', onScroll);
removeEventListener('resize', onScroll);
};
};matchMedia は SSR 中には存在しないので、typeof matchMedia !== 'undefined' の確認を入れています。
スクロールで山に寄るヒーロー
ヒーローは高さを画面より大きくし、中身を position: sticky で画面に留めています。ヒーローをどこまで進んだかを 0〜1 の値にして、山の拡大・タイトルの位置・雲の濃さに割り当てます。
<script lang="ts">
import { onMount } from 'svelte';
import { clamp01, onScrollFrame, prefersReducedMotion, smooth } from '#lib/motion.ts';
let hero: HTMLElement;
let mountain: HTMLImageElement;
let ln1: HTMLSpanElement;
let ln2: HTMLSpanElement;
// 山に寄り、文字が左右に割れる
onMount(() => {
if (prefersReducedMotion()) return;
return onScrollFrame(() => {
const p = clamp01(scrollY / (hero.offsetHeight - innerHeight));
const e = smooth(p);
mountain.style.transform = `scale(${1 + e * 1.1})`;
ln1.style.transform = `translateX(${-e * 34}vw)`;
ln2.style.transform = `translateX(${e * 28}vw)`;
});
});
</script>
<section class="hero" bind:this={hero}>...</section>スクロールのたびに変わる値を $state にすると、毎回コンポーネントの更新が走ります。ここでは bind:this で要素を受け取り、style.transform を直接書き換えています。値の変化がすぐ画面に出るものは、この方が軽く済みます。
標高計は $state で描く
反対に、画面の横の標高計は目盛りの数も少なく、更新もまばらなので、$state に入れてテンプレートで描いています。画像の読み込みなどでページの高さが変わったときは、ResizeObserver で目盛りを置き直します。
<script lang="ts">
import { onMount } from 'svelte';
import { onScrollFrame } from '#lib/motion.ts';
let marks = $state<{ label: string; top: number }[]>([]);
let pinTop = $state(100);
onMount(() => {
const sections = [...document.querySelectorAll<HTMLElement>('[data-alt]')];
const maxScroll = () => document.documentElement.scrollHeight - innerHeight;
// 下(ふもと)から上(山頂)へ登っていく
const layout = () => {
const max = maxScroll();
marks = sections.map((s) => ({
label: s.dataset.alt ?? '',
top: 100 - Math.min(s.offsetTop / max, 1) * 100
}));
};
const update = () => {
const max = maxScroll();
pinTop = 100 - (max > 0 ? scrollY / max : 0) * 100;
};
const ro = new ResizeObserver(() => { layout(); update(); });
ro.observe(document.body);
const stop = onScrollFrame(update);
return () => { ro.disconnect(); stop(); };
});
</script>
{#each marks as m}
<div class="altimeter__mark" style:top="{m.top}%"><span>{m.label}</span></div>
{/each}
<div class="altimeter__pin" style:top="{pinTop}%"></div>ローディングは初回だけ:<script module>
黄色い幕が稜線の形で上がっていくローディングは、記事ページから戻ってきたときにまで毎回出ると邪魔です。<script module> に書いた変数はコンポーネントを作り直しても残るので、「もう再生したか」を覚えておけます。
<script module lang="ts">
// クライアント側の遷移で戻ってきた時は出さない
let introPlayed = false;
</script>
<script lang="ts">
let show = $state(!introPlayed);
// onMount で introPlayed = true にしてから幕を上げる
</script>
{#if show}
<div class="loading">...</div>
{/if}reduced motion への配慮
prefers-reduced-motion: reduce の環境では、ヒーローの動きもローディングも出さずに最終状態を表示します。CSS 側でも .reveal を最初から表示しておきます。
まとめ
- Svelte 5 では
$props()/$state()/$derived()で書く - スクロール表示は Action + IntersectionObserver で十分。
destroyで監視を止める - スクロールのたびに変わる値は、
bind:thisで受け取った要素を直接書き換える - 初回だけの処理は
<script module>の変数で覚えておく - 動きを減らす設定の人には最終状態をすぐ見せる