Skip to content

Wrappers

Questa pagina e l'hub dei wrapper. Usala per scegliere il pacchetto giusto, poi apri la pagina dedicata per dettagli su installazione e utilizzo.

Cartella sorgente: https://github.com/tsparticles/tsparticles/tree/main/wrappers

Pagine wrapper

I piu usati

Ecosistema React

Ecosistema Vue

Altri (ordine alfabetico)

Flusso di integrazione comune

Indipendentemente dal framework:

  1. installa wrapper + @tsparticles/engine
  2. carica le feature una sola volta (@tsparticles/slim, @tsparticles/all o plugin custom)
  3. renderizza il componente wrapper con le opzioni

Wrapper ufficiali (ordine alfabetico)

Regole di ordinamento:

Note su WordPress ed Elementor

Mapping wrapper -> demo

Usa questa matrice rapida per passare da un wrapper a una demo eseguibile nel monorepo.

Regole di ordinamento:

  • ordine alfabetico per nome pacchetto wrapper
  • eccezione esplicita per wrapper non applicabili alle demo (@tsparticles/wordpress)

Source demo folder: https://github.com/tsparticles/tsparticles/tree/main/demo

Wrapper packageDemo project
@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/wordpressnot applicable (requires full WordPress installation)
angular-confettidemo/angular
angular-fireworksdemo/angular

Pattern minimi

Provider in stile 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>
  );
}

Funzione register in stile 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);
}

Inizializzazione una tantum in 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);
  });
}

Pagine correlate