本文へ移動
← Archive No.08 / 15 Svelte →
Svelte

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 で取り出しています。

svelte
<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 のような「要素ごとに監視して、最後に止める」処理にぴったりです。

ts
// 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 で遅れを渡すと、並んだ要素を少しずつずらして出せます。

svelte
<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}
scss
.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 からそのまま返せます。

ts
// 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 の値にして、山の拡大・タイトルの位置・雲の濃さに割り当てます。

svelte
<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 で目盛りを置き直します。

svelte
<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> に書いた変数はコンポーネントを作り直しても残るので、「もう再生したか」を覚えておけます。

svelte
<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> の変数で覚えておく
  • 動きを減らす設定の人には最終状態をすぐ見せる