Cours Svelte et SvelteKit · Module 13: Actions de formulaire
Le marché de Birka - Form Actions
Dans cette leçon3
Bienvenue au marché de Birka ! Ici, les Vikings commercent et concluent des accords. Les Form Actions dans SvelteKit sont le moyen de gérer les formulaires côté serveur.
Formulaire de base
<!-- src/routes/warriors/new/+page.svelte -->
<form method="POST">
<input name="name" placeholder="Warrior name" required />
<input name="strength" type="number" placeholder="Strength" required />
<button type="submit">Add warrior</button>
</form>// src/routes/warriors/new/+page.server.js
export const actions = {
default: async ({ request }) => {
const data = await request.formData();
const name = data.get('name');
const strength = data.get('strength');
// Sauvegarder dans la base de données
await db.warriors.create({ name, strength: Number(strength) });
return { success: true };
}
};Actions nommées
// +page.server.js
export const actions = {
create: async ({ request }) => {
// ...
},
delete: async ({ request }) => {
// ...
}
};<form method="POST" action="?/create">
<!-- ... -->
</form>
<form method="POST" action="?/delete">
<input type="hidden" name="id" value={warrior.id} />
<button>Delete</button>
</form>Renvoyer des données
Ce que renvoie l'action arrive dans la page sous forme de prop form. En Svelte 5, tu la récupères avec $props(), avec data si la page en a besoin : let { data, form } = $props();.
<script>
let { form } = $props();
</script>
{#if form?.success}
<p class="success">Warrior added!</p>
{/if}
{#if form?.error}
<p class="error">{form.error}</p>
{/if}
<form method="POST">
<!-- ... -->
</form>Le marché exige la négociation - les formulaires exigent la validation !
Code de cette leçon : App.svelte
<script>
// Marché de Birka - Form Actions
// Formulaires sans JavaScript côté client
let warriors = $state([
{ id: 1, name: 'Ragnar', strength: 95 },
{ id: 2, name: 'Bjorn', strength: 90 }
]);
let formData = $state({ name: '', strength: 50 });
let message = $state('');
// Simulation d’une action de formulaire
function handleSubmit(e) {
e.preventDefault();
if (!formData.name) {
message = 'Le nom est requis !';
return;
}
warriors = [...warriors, {
id: Date.now(),
name: formData.name,
strength: formData.strength
}];
formData = { name: '', strength: 50 };
message = 'Guerrier ajouté !';
setTimeout(() => message = '', 2000);
}
</script>
<main class="birka">
<h1>Marché de Birka - Form Actions</h1>
<p class="subtitle">Formulaires dans SvelteKit</p>
<section class="code">
<h2>+page.server.js</h2>
<pre>
export const actions = {"{"}
default: async ({"{"} request {"}"}) => {"{"}
const data = await request.formData();
const name = data.get('name');
// Validation
if (!name) {"{"}
return fail(400, {"{"} error: 'Nom requis' {"}"});
{"}"}
// Enregistrer en base de données
await db.warriors.create({"{"} name {"}"});
return {"{"} success: true {"}"};
{"}"}
{"}"};
</pre>
</section>
<section class="form-section">
<h2>Ajouter un guerrier</h2>
<!-- Dans SvelteKit : method="POST" suffit -->
<form onsubmit={handleSubmit}>
<div class="field">
<label for="name">Nom du guerrier</label>
<input
id="name"
name="name"
bind:value={formData.name}
placeholder="ex. Ivar"
/>
</div>
<div class="field">
<label for="strength">Force ({formData.strength})</label>
<input
type="range"
id="strength"
name="strength"
bind:value={formData.strength}
min="1"
max="100"
/>
</div>
<button type="submit">Ajouter le guerrier</button>
</form>
{#if message}
<p class="message">{message}</p>
{/if}
</section>
<section class="list">
<h2>Guerriers ({warriors.length})</h2>
{#each warriors as warrior (warrior.id)}
<div class="warrior">
<span>{warrior.name}</span>
<span class="strength">{warrior.strength}</span>
</div>
{/each}
</section>
</main>
<style>
.birka {
font-family: 'Georgia', serif;
max-width: 500px;
margin: 0 auto;
padding: 2rem;
background: #1a0f0a;
color: #e8d5b7;
min-height: 100vh;
}
h1 {
color: #d4af37;
text-align: center;
}
.subtitle {
text-align: center;
color: #8b7355;
}
section {
background: rgba(212, 175, 55, 0.1);
border: 1px solid #d4af37;
border-radius: 8px;
padding: 1rem;
margin: 1rem 0;
}
h2 {
color: #d4af37;
font-size: 1rem;
margin-top: 0;
}
pre {
background: rgba(0,0,0,0.5);
padding: 1rem;
border-radius: 4px;
font-size: 0.8rem;
overflow-x: auto;
}
.field {
margin-bottom: 1rem;
}
label {
display: block;
margin-bottom: 0.25rem;
color: #d4af37;
}
input[type="text"],
input[name="name"] {
width: 100%;
padding: 0.75rem;
background: rgba(0,0,0,0.3);
border: 1px solid #3d2914;
border-radius: 4px;
color: #e8d5b7;
}
input[type="range"] {
width: 100%;
}
button {
width: 100%;
padding: 0.75rem;
background: #3d2914;
color: #e8d5b7;
border: 1px solid #d4af37;
border-radius: 4px;
cursor: pointer;
font-size: 1rem;
}
button:hover {
background: #4d3924;
}
.message {
margin-top: 1rem;
padding: 0.75rem;
background: rgba(144, 238, 144, 0.1);
border-radius: 4px;
text-align: center;
}
.warrior {
display: flex;
justify-content: space-between;
padding: 0.75rem;
background: rgba(0,0,0,0.3);
border-radius: 4px;
margin-bottom: 0.5rem;
}
.strength {
color: #ffd700;
}
</style>Entrées de la documentation utilisées dans cette leçon
Tu as repéré une erreur dans cette leçon ?
Teste tes connaissances
Réponds aux questions de cette leçon. Choisis une réponse pour voir tout de suite si elle est correcte.
1. Où définit-on les form actions dans SvelteKit ?
Tâches pratiques dans le jeu
- Éditeur de code
Complète l'attribut action du formulaire