Referencia de opcoes

As opcoes de tsParticles sao profundas, entao esta pagina funciona como um mapa pratico antes de entrar em cada subopcao.

Escolha o seu caminho de configuracao

Resultado visual rapido: comece com um preset e sobrescreva os campos-chave.
Controle total: defina particles, interactivity e background manualmente.
Abordagem config-first: comece com @tsparticles/configs e refine com seguranca.

Docs rapidas (locais)

Paginas de aprofundamento de particulas

Onde fica a documentacao de referencia

Docs principais de opcoes: tsparticles/markdown/Options.md
Paginas detalhadas de opcoes: tsparticles/markdown/Options/
Interfaces de tipos: tsparticles/engine/src/Options/Interfaces

Opcoes raiz mais usadas

background
fullScreen
interactivity
particles
detectRetina
preset
responsive

Secoes mais usadas

background: base para fundo do canvas e mascaramento.
particles.number: quantidade e densidade.
particles.move: velocidade, direcao e out modes.
particles.shape: circulo, poligono, imagem, emoji, personalizado.
particles.palette: troca rapida de conjuntos de cores coordenados.
interactivity: modos hover/click e efeitos externos.
detectRetina: equilibrio entre qualidade e performance em telas de alta densidade.

Mapa de particulas (visualizacao aninhada)

Use esta arvore como apoio de navegacao antes de abrir paginas de detalhe:

text

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

Abra primeiro a documentacao raiz e depois as secoes de aprofundamento:

Raiz: Particles
Em detalhe: Particles Number, Particles Move, Particles Links

Workflow seguro de opcoes

Comece com uma configuracao funcional de demos ou presets.
Altere uma secao por vez.
Valide com TypeScript (IOptions) no codigo da aplicacao.
Mantenha as opcoes de producao em arquivos JSON dedicados.

Exemplo tipado minimo

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

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

Guardrails de performance

Prefira @tsparticles/slim, exceto quando precisar de plugins avancados.
Mantenha a contagem de particulas proporcional a area do container.
Faca perfil em dispositivos reais antes de adicionar interacoes pesadas.

Referencias relacionadas

Docs do pacote de configs: https://github.com/tsparticles/tsparticles/blob/main/utils/configs/README.md
Pasta de presets: https://github.com/tsparticles/tsparticles/tree/main/presets
Pasta de paletas: https://github.com/tsparticles/tsparticles/tree/main/palettes

Para detalhes completos de cada subopcao, use tambem as paginas fonte em tsparticles/markdown/Options listadas acima.

Referencia de opcoes ​

Escolha o seu caminho de configuracao ​

Docs rapidas (locais) ​

Paginas de aprofundamento de particulas ​

Onde fica a documentacao de referencia ​

Opcoes raiz mais usadas ​

Secoes mais usadas ​

Mapa de particulas (visualizacao aninhada) ​

Workflow seguro de opcoes ​

Exemplo tipado minimo ​

Guardrails de performance ​

Referencias relacionadas ​