「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 = trueSvelteKit 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 に
