Back to Blog

SvelteKit × microCMS:+page.server.tsとprerenderで記事ページを生成する

「Svelte Base」は SvelteKit と microCMS で作ったサイトです。記事一覧と記事ページは +page.server.ts でデータを取得し、prerender でビルド時に HTML を生成しています。

リポジトリ:SvelteKit-TypeScript-MicroCMS-Site / デモ:https://sveltebase-phi.vercel.app/

API キーは $env/static/private から

SvelteKit では $env/static/private から読み込んだ値はサーバー側のコードでしか使えず、クライアントのコードで import するとビルドエラーになります。キーの漏れを仕組みで防げるのが嬉しいところです。

// src/lib/microcms.ts
import { createClient, type MicroCMSQueries } from 'microcms-js-sdk'
import { MICROCMS_SERVICE_DOMAIN, MICROCMS_API_KEY } from '$env/static/private'

const client = createClient({ serviceDomain: MICROCMS_SERVICE_DOMAIN, apiKey: MICROCMS_API_KEY })

export const getList = async (queries?: MicroCMSQueries) =>
  await client.get<BlogResponse>({ endpoint: 'blogs', queries })

export const getDetail = async (contentId: string, queries?: MicroCMSQueries) =>
  await client.getListDetail<Blog>({ endpoint: 'blogs', contentId, queries })

一覧ページ

// src/routes/+page.server.ts
export const load: PageServerLoad = async () => {
  return await getList()
}
export const prerender = true

記事ページと 404

存在しない ID を開いたときに 500 にならないよう、SDK が投げる 404 のエラーを SvelteKit の error(404) に変換しています。

// src/routes/[slug]/+page.server.ts
import { error } from '@sveltejs/kit'

export const load: PageServerLoad = async ({ params }) => {
  try {
    return await getDetail(params.slug)
  } catch (err) {
    if (err instanceof Error && /status: 404/.test(err.message)) {
      error(404, 'Not Found')
    }
    throw err
  }
}
export const prerender = true

SvelteKit 2 からは error() を throw する必要がなくなりました(関数の中で例外を投げてくれます)。

prerender の対象はどう決まる?

[slug] のような動的ルートでも、prerender 時に SvelteKit がトップページからリンクをたどって対象のページを見つけてくれます。一覧に全記事へのリンクがあれば、entries を書かなくてもすべての記事が生成されます。

アイキャッチは WebP で

microCMS の画像は URL パラメータで変換できるので、?w=1600&fm=webp を付けて軽くしています。width/height も MicroCMSImage の値を渡しておくと、読み込み時のレイアウトのずれを防げます。

{#if data.eyecatch}
  <img src="{data.eyecatch.url}?w=1600&fm=webp" alt=""
       width={data.eyecatch.width} height={data.eyecatch.height} />
{/if}
<div class="article__body">{@html data.content}</div>

まとめ

  • キーは $env/static/private でサーバー専用にする
  • +page.server.ts と prerender = true で静的生成
  • SDK の 404 は error(404) に変換
  • 画像は microCMS の変換パラメータで WebP に
04

Contact

お問い合わせ

Let's work together.

サイト制作・改修のご相談やご質問など、お気軽にお問い合わせください。通常2営業日以内にご返信します。

  • 返信目安:2営業日以内
  • reCAPTCHA で保護されています

This site is protected by reCAPTCHA and the Google
Privacy Policy and Terms of Service apply.

Thank you!

送信が完了しました。内容を確認のうえご連絡します。