Optionen-Referenz
Die tsParticles-Optionen sind sehr umfangreich. Diese Seite ist eine praktische Karte, bevor du in jede Unteroption einsteigst.
Wähle deinen Konfigurationsweg
- Schnelles visuelles Ergebnis: starte mit einem Preset und uberschreibe die wichtigsten Felder.
- Volle Kontrolle: definiere
particles,interactivityundbackgroundmanuell. - Config-first-Workflow: beginne mit
@tsparticles/configsund iteriere sicher weiter.
Schnelldoku (lokal)
Background & CanvasBackground MaskFull ScreenMotionManual ParticlesThemesParticlesParticles NumberParticles MoveParticles LinksParticles PaletteParticles ShapeParticles CollisionsParticles LifeParticles OrbitParticles RollParticles RotateInteractivityInteractivity ClickInteractivity HoverInteractivity DivInteractivity EventsInteractivity ModesPlugin: AbsorbersPlugin: EmittersPlugin: InfectionPlugin: Polygon MaskPerformance Guide
Partikel-Deep-Dive-Seiten
Particles BounceParticles ColorParticles DestroyParticles GroupParticles OpacityParticles PaletteParticles RepulseParticles ShadowParticles SizeParticles StrokeParticles TiltParticles TwinkleParticles WobbleParticles ZIndex
Wo die Referenzdokumentation liegt
- Hauptdoku fur Optionen:
tsparticles/markdown/Options.md - Detaillierte Optionsseiten:
tsparticles/markdown/Options/ - TypeScript-Interfaces:
tsparticles/engine/src/Options/Interfaces
Meistgenutzte Root-Optionen
backgroundfullScreeninteractivityparticlesdetectRetinapresetresponsive
Meistgenutzte Bereiche
background: Basis fur Canvas-Hintergrund und Maskierung.particles.number: Anzahl und Dichte.particles.move: Geschwindigkeit, Richtung und out modes.particles.shape: Kreis, Polygon, Bild, Emoji, benutzerdefiniert.particles.palette: schnell koordinierte Farbsets wechseln.interactivity: Hover/Klick-Modi und externe Effekte.detectRetina: Qualitats-/Performance-Kompromiss auf High-DPI-Displays.
Partikelkarte (verschachtelte Ansicht)
Nutze diesen schnellen Baum als Navigationshilfe, bevor du Einzelseiten offnest:
text
particles
|- number
|- color
|- shape
|- size
|- opacity
|- move
|- links
|- collisions
|- life
|- destroy
|- group
|- orbit
|- repulse
|- roll
|- rotate
|- shadow
|- stroke
|- tilt
|- twinkle
|- wobble
|- zIndex
`- paletteErst die Root-Doku, dann die Deep-Dive-Bereiche:
- Basis:
Particles - Vertiefung:
Particles Number,Particles Move,Particles Links
Sicherer Optionen-Workflow
- Starte mit einer funktionierenden Konfiguration aus Demos oder Presets.
- Aendere immer nur einen Bereich auf einmal.
- Validiere mit TypeScript (
IOptions) im App-Code. - Halte Produktionsoptionen in dedizierten JSON-Dateien.
Minimal typisiertes Beispiel
ts
import type { ISourceOptions } from "@tsparticles/engine";
export const particlesOptions: ISourceOptions = {
fpsLimit: 60,
particles: {
number: { value: 70 },
move: { enable: true, speed: 1.5 },
},
};Performance-Leitplanken
- Nutze bevorzugt
@tsparticles/slim, ausser du brauchst erweiterte Plugins. - Halte die Partikelanzahl proportional zur Flache des Containers.
- Profile mit echten Geraten, bevor du schwere Interaktionen hinzufugst.
Verwandte Referenzen
- Doku zum Config-Paket: https://github.com/tsparticles/tsparticles/blob/main/utils/configs/README.md
- Presets-Ordner: https://github.com/tsparticles/tsparticles/tree/main/presets
- Paletten-Ordner: https://github.com/tsparticles/tsparticles/tree/main/palettes
Fur alle Details jeder Unteroption nutze zusatzlich die oben verlinkten Quellseiten in tsparticles/markdown/Options.
