「Svelte Base」のお問い合わせフォームは、入力チェックに felte、送信先に SvelteKit の API ルート(+server.ts)を使っています。送信結果は Svelte 5 の $state で管理し、ページ遷移せずにその場で完了メッセージを出します。
リポジトリ:SvelteKit-TypeScript-MicroCMS-Site / デモ:https://sveltebase-phi.vercel.app/
felte でバリデーション
felte は use:form を付けるだけでフォームと連携できるライブラリです。validate でエラーのオブジェクトを返すと、$errors で参照できます。
const { form, errors, isSubmitting } = createForm<FormValues>({
validate: (values) => {
const errors: Partial<Record<keyof FormValues, string>> = {}
if (!values.name?.trim()) errors.name = 'Name is required'
if (!values.email?.trim()) errors.email = 'Email is required'
else if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(values.email)) errors.email = 'Please enter a valid email'
if (!values.message?.trim()) errors.message = 'Message is required'
return errors
},
onSubmit: async (values) => { /* 後述 */ },
onError: () => {
// 最初のエラー項目へフォーカス
queueMicrotask(() => document.querySelector<HTMLElement>('.form [aria-invalid="true"]')?.focus())
}
})onError で最初のエラー項目にフォーカスを移すと、キーボードで操作している人もどこを直せばいいかすぐ分かります。
送信状態は $state で
let sent = $state(false)
let failed = $state(false)
onSubmit: async (values) => {
failed = false
try {
values.googleReCaptchaToken = await getToken()
const res = await fetch('/api/contact', {
method: 'POST',
body: JSON.stringify(values),
headers: { 'Content-Type': 'application/json' }
})
if (res.ok) sent = true
else failed = true
} catch {
failed = true
}
}送信中は $isSubmitting でボタンを無効にし、二重送信を防いでいます。
API ルート
src/routes/api/contact/+server.ts に POST を書くと、それがエンドポイントになります。環境変数は実行時に読む $env/dynamic/private を使っているので、Vercel の設定を変えても再ビルドは不要です。
import { error, json } from '@sveltejs/kit'
import { env } from '$env/dynamic/private'
export const POST: RequestHandler = async ({ request }) => {
const { name, email, message, googleReCaptchaToken }: ContactBody = await request.json()
if (!name || !email || !message) error(400, 'Missing required fields')
if (env.RECAPTCHA_SECRET_KEY) {
if (!googleReCaptchaToken || !(await verifyRecaptcha(env.RECAPTCHA_SECRET_KEY, googleReCaptchaToken))) {
error(403, 'reCAPTCHA verification failed')
}
}
// Nodemailer で送信
return json({ ok: true })
}Vercel へのデプロイ
アダプターは @sveltejs/adapter-vercel で、ランタイムを nodejs24.x に指定しています。Nodemailer は Node.js の API を使うので、Edge ランタイムでは動かない点に注意してください。
// svelte.config.js
adapter: adapter({ runtime: 'nodejs24.x' })まとめ
- felte の
onErrorで最初のエラーにフォーカスを移す - 送信結果は
$stateで持ち、その場でメッセージを出す - 実行時に変わる設定は
$env/dynamic/private - Nodemailer を使う関数は Node.js ランタイムで動かす
