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.

Let's see the new confetti options in action

Yes, you saw right. Confetti can be emojis too! 😎