- 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
- 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
- Confetti animations are now split in three generic particles sections (
- Removed confetti shape, it's no longer needed
- The library has changed the output folders, the
dist/folder has been removed.
In most cases this change will affect only who are using internal imports.
tsparticles/dist can be safely replaced to
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.
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 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 are both specified, only
darken will be read.
enlighten have a
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 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
sin functions), when animated the angle will be increased or decreased, depending on set direction.
Wobble is the horizontal movement that simulates the air resistance. The particles will bounce from left to right with a configurable
tsParticles - Easily create highly customizable particles animations and use them as animated backgrounds for your website. Ready to use components available for React, Vue.js (2.x and 3.x), Angular, Svelte, jQuery, Preact, Inferno.
tsParticles - TypeScript Particles
A lightweight TypeScript library for creating particles. Dependency free (*), browser ready and compatible with React, Vue, Angular, Svelte, jQuery, Preact, Inferno
Do you want to use it on your website?
This library is available on the two most popular CDNs and it's easy and ready to use, if you were using particles.js it's even easier.
You'll find the instructions below, with all the links you need, and don't be scared by TypeScript, it's just the source language.
If you are still interested some lines below there are some instructions for migrating from the old particles.js library.
Hosting / CDN
Please use this hosts or your own to…
Let's see the new confetti options in action
Yes, you saw right. Confetti can be emojis too! 😎