Reference des options

Les options tsParticles sont profondes. Cette page sert de carte pratique avant de plonger dans chaque sous-option.

Choisir votre strategie de configuration

Resultat visuel rapide : partez d'un preset puis surchargez les champs essentiels.
Controle complet : definissez manuellement particles, interactivity et background.
Approche config-first : commencez avec @tsparticles/configs, puis affinez pas a pas.

Documentation rapide (locale)

Pages particules detaillees

Ou trouver la documentation de reference

Docs options principales : tsparticles/markdown/Options.md
Pages detaillees des options : tsparticles/markdown/Options/
Interfaces TypeScript : tsparticles/engine/src/Options/Interfaces

Options racine les plus utilisees

background
fullScreen
interactivity
particles
detectRetina
preset
responsive

Sections les plus utilisees

background : base du fond canvas et du masquage.
particles.number : quantite et densite.
particles.move : vitesse, direction et out modes.
particles.shape : cercle, polygone, image, emoji, personnalise.
particles.palette : changer rapidement des palettes coherentes.
interactivity : modes hover/click et effets externes.
detectRetina : compromis qualite/performance sur ecrans haute DPI.

Carte des particules (vue imbriquee)

Utilisez cette arborescence comme aide de navigation avant d'ouvrir les pages detaillees :

text

particles
|- number
|- color
|- shape
|- size
|- opacity
|- move
|- links
|- collisions
|- life
|- destroy
|- group
|- orbit
|- repulse
|- roll
|- rotate
|- shadow
|- stroke
|- tilt
|- twinkle
|- wobble
|- zIndex
`- palette

Ouvrez d'abord les docs racine, puis les approfondissements :

Racine : Particles
Approfondissement : Particles Number, Particles Move, Particles Links

Workflow d'options fiable

Commencez avec une configuration valide issue des demos ou des presets.
Modifiez une section a la fois.
Validez avec TypeScript (IOptions) dans le code de l'application.
Gardez les options de production dans des fichiers JSON dedies.

Exemple type minimal

import type { ISourceOptions } from "@tsparticles/engine";

export const particlesOptions: ISourceOptions = {
  fpsLimit: 60,
  particles: {
    number: { value: 70 },
    move: { enable: true, speed: 1.5 },
  },
};

Garde-fous performance

Preferez @tsparticles/slim sauf besoin clair de plugins avances.
Gardez le nombre de particules proportionnel a la surface du conteneur.
Mesurez sur de vrais appareils avant d'ajouter des interactions lourdes.

References associees

Docs package configs : https://github.com/tsparticles/tsparticles/blob/main/utils/configs/README.md
Dossier presets : https://github.com/tsparticles/tsparticles/tree/main/presets
Dossier palettes : https://github.com/tsparticles/tsparticles/tree/main/palettes

Pour les details complets de chaque sous-option, utilisez aussi les pages source tsparticles/markdown/Options liees ci-dessus.

Reference des options ​

Choisir votre strategie de configuration ​

Documentation rapide (locale) ​

Pages particules detaillees ​

Ou trouver la documentation de reference ​

Options racine les plus utilisees ​

Sections les plus utilisees ​

Carte des particules (vue imbriquee) ​

Workflow d'options fiable ​

Exemple type minimal ​

Garde-fous performance ​

References associees ​