DEV Community

Matteo Bruni for tsParticles

Posted on Jun 28, 2021 • Updated on Aug 13, 2022

tsParticles 1.30.0 is here! Confetti rework (all particles shapes supported, emojis too, with sample inside)

#news #javascript #webdev #showdev

tsParticles 1.30.0

New Features

Added wobble effect to particles, configurable in options
Added tilt effect to particles, configurable in options
Added roll options to particles, configurable in options
Added all new sections to editor

Bug Fixes

Fixed old TypeScript definitions generation, fixes #1683
Simplified confetti preset, if the first parameter is not specified, a random id will be used
tsParticles will create an element if the id used is not valid

Breaking Changes

Confetti animations are now split in three generic particles sections (roll, tilt, wobble)
Removed confetti shape, it's no longer needed
The library has changed the output folders, the dist/ folder has been removed.

A note about the `dist/` folder

Imports (`import`)

In most cases this change will affect only who are using internal imports.

This tsparticles/dist can be safely replaced to tsparticles.

CDN or Vanilla

This will affect also everyone using tsParticles with CDNs since the dist folder is no longer part of the path, but if it's copied from the CDN website it's fine.

A note about `wobble`, `tilt` and `roll`

These three new particles options sections will create a wonderful and realistic confetti effect to all particles. You can use any shape with these effects, even external ones, self-created or not. The only one not compatible is confetti because it's been replaced by these properties.

What do they means?

Roll

Roll makes particles roll on their y axis. They look like they're falling rolling on themself. In these options you can set a back color (that will be visible when the particle has flipped).

The color is optional and a darken or a enlighten section can be alternatively configured.

The reading values order is:

Back Color
Darken
Enlighten

So if enlighten and darken are both specified, only darken will be read.

darken and enlighten have a value and enable, the first will subtract the luminosity of the color for that value, the second will add it, only if the enable value is true.

Tilt

Tilt is responsible for particles deformation, the particles will be tilted following the specified parameters. This is not animated by default, the options are similar to rotate, they don't have path since is not valid here.

If a value is set all particles will be tilted for that angle (both horizontally and vertically using cos and sin functions), when animated the angle will be increased or decreased, depending on set direction.

Wobble

Wobble is the horizontal movement that simulates the air resistance. The particles will bounce from left to right with a configurable speed and distance.

matteobruni / tsparticles

tsParticles - Easily create highly customizable JavaScript particles effects, confetti explosions and fireworks animations and use them as animated backgrounds for your website. Ready to use components available for React.js, Vue.js (2.x and 3.x), Angular, Svelte, jQuery, Preact, Inferno, Solid, Riot and Web Components.

tsParticles - TypeScript Particles

A lightweight TypeScript library for creating particles. Dependency free (*), browser ready and compatible with React.js, Vue.js (2.x and 3.x), Angular, Svelte, jQuery, Preact, Inferno, Riot.js, Solid.js, and Web Components