Skip to content

Wrappers

Esta pagina e o hub de wrappers. Use-a para escolher o pacote certo e, em seguida, abra a pagina dedicada para detalhes de instalacao e uso.

Pasta de origem: https://github.com/tsparticles/tsparticles/tree/main/wrappers

Paginas de wrappers

Mais usados primeiro

Ecossistema React

Ecossistema Vue

Outros (ordem alfabetica)

Fluxo comum de integracao

Independente do framework:

  1. instale wrapper + @tsparticles/engine
  2. carregue os recursos uma vez (@tsparticles/slim, @tsparticles/all, ou plugins personalizados)
  3. renderize o componente wrapper com opcoes

Wrappers oficiais (ordem alfabetica)

Regra de ordenacao desta secao:

Notas sobre WordPress e Elementor

Mapeamento wrapper para demo

Use esta matriz para pular rapidamente de um package wrapper para uma demo executavel do monorepo.

Regra de ordenacao desta tabela:

  • ordem alfabetica por nome de package wrapper
  • excecao explicita para wrappers que nao se aplicam a demo (@tsparticles/wordpress)

Pasta fonte de demos: https://github.com/tsparticles/tsparticles/tree/main/demo

Package wrapperProjeto demo
@tsparticles/angulardemo/angular
@tsparticles/astrodemo/astro
@tsparticles/emberdemo/ember
@tsparticles/infernodemo/inferno
@tsparticles/jquerydemo/jquery
@tsparticles/litdemo/lit
@tsparticles/nextjsdemo/nextjs, demo/nextjs-legacy
@tsparticles/nuxt2demo/nuxt2
@tsparticles/nuxt3demo/nuxt3
@tsparticles/nuxt4demo/nuxt4
@tsparticles/preactdemo/preact
@tsparticles/qwikdemo/qwik
@tsparticles/reactdemo/react
@tsparticles/riotdemo/riot
@tsparticles/soliddemo/solid
@tsparticles/sveltedemo/svelte, demo/svelte-kit
@tsparticles/vue2demo/vue2
@tsparticles/vue3demo/vue3
@tsparticles/webcomponentsdemo/webcomponents
@tsparticles/wordpressnao aplicavel (requer instalacao completa do WordPress)
angular-confettidemo/angular
angular-fireworksdemo/angular

Padroes minimos

Provider estilo React / Next.js

tsx
import Particles, { ParticlesProvider } from "@tsparticles/react";
import type { Engine } from "@tsparticles/engine";
import { loadSlim } from "@tsparticles/slim";

const init = async (engine: Engine): Promise<void> => {
  await loadSlim(engine);
};

export function Background() {
  return (
    <ParticlesProvider init={init}>
      <Particles id="tsparticles" options={{ particles: { move: { enable: true } } }} />
    </ParticlesProvider>
  );
}

Funcao de registro estilo Vue / Nuxt

ts
import type { Engine } from "@tsparticles/engine";

export async function registerParticles(engine: Engine): Promise<void> {
  const [{ loadSlim }] = await Promise.all([import("@tsparticles/slim")]);

  await loadSlim(engine);
}

Inicializacao unica no Angular

ts
import { NgParticlesService } from "@tsparticles/angular";
import { loadSlim } from "@tsparticles/slim";

constructor(private readonly particlesService: NgParticlesService) {}

ngOnInit(): void {
  void this.particlesService.init(async engine => {
    await loadSlim(engine);
  });
}

Paginas relacionadas