Skip to content

Wrappers

Esta pagina es el hub de wrappers. Usala para elegir el paquete correcto y luego abre la pagina dedicada para ver detalles de instalacion y uso.

Carpeta fuente: https://github.com/tsparticles/tsparticles/tree/main/wrappers

Paginas de wrappers

Los mas usados

Ecosistema React

Ecosistema Vue

Otros (orden alfabetico)

Flujo comun de integracion

Sin importar el framework:

  1. instala el wrapper + @tsparticles/engine
  2. carga las features una vez (@tsparticles/slim, @tsparticles/all, o plugins personalizados)
  3. renderiza el componente wrapper con opciones

Wrappers oficiales (orden alfabetico)

Regla de orden para esta seccion:

Notas sobre WordPress y Elementor

Mapping wrapper a demo

Usa esta matriz rapida para saltar de un package wrapper a una demo ejecutable del monorepo.

Regla de orden para esta tabla:

  • orden alfabetico por nombre de package wrapper
  • excepcion explicita para wrappers no aplicables en demo (@tsparticles/wordpress)

Carpeta fuente de demos: https://github.com/tsparticles/tsparticles/tree/main/demo

Package wrapperProyecto 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/wordpressno aplica (requiere instalacion completa de WordPress)
angular-confettidemo/angular
angular-fireworksdemo/angular

Patrones 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>
  );
}

Funcion 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);
}

Inicializacion unica en 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