Skip to main content

Bien commencer

Introduction

Modifier cette page sur Github

Bienvenue sur la documentation Svelte de référence ! Ces pages sont pensées comme une ressource utile pour des personnes ayant déjà une certaine familiarité avec Svelte, et souhaitant en apprendre davantage.

Si ce n'est pas (encore) le cas pour vous, vous préférerez probablement jeter un oeil au tutoriel interactif ou aux exemples avant de consulter cette section. Vous pouvez essayez Svelte en ligne en utilisant le REPL, ou bien sur StackBlitz si vous préférez un environnement de développement plus complet.

Cette documentation en français, ainsi que l'intégralité du contenu en français de ce site, sont une traduction bénévole et non officielle de la documentation et du site officiels (en anglais), qui restent la référence. N'hésitez pas à y jeter un oeil. Vous pouvez aussi nous faire part de vos suggestions de traduction si celles que vous trouverez dans ces pages ne vous conviennent pas.

Vous trouverez parfois des termes non traduits, comme falsy ou encore bundler. Ces termes sont en général utilisés tels quels en français, et nous avons choisi de les laisser ainsi dans la documentation française. N'hésitez pas à suivre les liens proposés, qui vous dirigeront vers un glossaire fournissant quelques explications.

Démarrer un nouveau projet

Nous recommandons d'utiliser SvelteKit, le framework d'application officiel créé par l'équipe Svelte :

npm create svelte@latest myapp
cd myapp
npm install
npm run dev

SvelteKit se charge d'exécuter le compilateur Svelte pour convertir vos fichiers .svelte en fichiers .js qui créent le DOM, et en fichiers .css qui le stylisent. Il fournit également tout ce dont vous avez besoin pour créer une application web, comme un serveur de développement, du routing, et des outils de déploiement. SvelteKit utilise Vite pour empaqueter votre code.

Alternatives à SvelteKit

Si vous ne souhaitez pas utiliser SvelteKit, vous pouvez aussi utiliser Svelte (sans SvelteKit) avec Vite en exécutant npm create vite@latest, puis en choisissant l'option svelte. De cette manière, npm run build génèrera les fichiers HTML, JS et CSS dans le dossier dist. Dans la plupart des cas, vous aurez aussi probablement besoin de choisir une librairie de routing.

Il existe également des plugins pour les bundlers web majeurs pour gérer la compilation Svelte — qui génèreront les .js et .css à insérer dans votre HTML — mais la plupart ne gèreront pas pas le rendu côté serveur (SSR).

Outillage d'éditeur

L'équipe Svelte maintient une extension VS Code, et des intégrations existent également pour d'autres éditeurs ou outils.

Obtenir de l'aide

Si vous rencontrez des difficultés, vous trouverez de l'aide sur le Discord officiel ou sur le Discord francophone. Vous trouverez également des réponses sur StackOverflow.

précédent