Bundle: Slim
@tsparticles/slim é o bundle recomendado para a maioria dos projetos. Inclui tudo o que é necessário para animações de partículas modernas com interações de mouse, múltiplas formas e links entre partículas.
Funcionalidades incluídas
Herda tudo de @tsparticles/basic mais:
Formas: círculo, quadrado, estrela, polígono, linha, imagem, emoji
Interações externas (mouse/toque):
- attract
- bounce
- bubble
- connect
- destroy
- grab
- parallax
- pause
- push
- remove
- repulse
- slow
Interações entre partículas:
- attract
- colisões
- links (conexões entre partículas)
Atualizadores adicionais:
- life (ciclo de vida)
- rotate
Plugins:
- interatividade
- easing-quad
- Plugins de cor HEX, HSL, RGB
Quando usar
- Ponto de partida recomendado para a maioria dos projetos
- Precisa de múltiplas formas (círculos, estrelas, polígonos, imagens)
- Precisa de interações com mouse (clique, passar, bubble, repulse)
- Precisa de links entre partículas
- Bom equilíbrio entre tamanho do bundle e funcionalidades
Instalação
npm/pnpm/yarn
bash
pnpm add @tsparticles/engine @tsparticles/slimts
import { tsParticles } from "@tsparticles/engine";
import { loadSlim } from "@tsparticles/slim";
await loadSlim(tsParticles);
await tsParticles.load({
id: "tsparticles",
options: {
background: { color: "#0b1020" },
particles: {
number: { value: 80 },
links: { enable: true, distance: 150 },
move: { enable: true, speed: 2 },
shape: { type: ["circle", "star", "square"] },
},
},
});CDN (script tags)
html
<script src="https://cdn.jsdelivr.net/npm/@tsparticles/engine@4/tsparticles.engine.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/@tsparticles/slim@4/tsparticles.slim.bundle.min.js"></script>
<script>
(async () => {
await loadSlim(tsParticles);
await tsParticles.load({
id: "tsparticles",
options: {
particles: {
number: { value: 80 },
links: { enable: true },
move: { enable: true, speed: 2 },
},
},
});
})();
</script>Erros comuns
- Chamar
tsParticles.load()antes deloadSlim(tsParticles). - Misturar versões diferentes entre o motor e o bundle — mantenha-os alinhados.
- Esperar funcionalidades de bundles superiores (emissores, absorvedores, texto, wobble) — precisa de
tsparticles(full) ou plugins individuais.
