This content originally appeared on DEV Community and was authored by Matteo Bruni
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 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.
The output files are just JavaScript. ?
CDNs and npm have all the sources you need in Javascript, a bundle browser ready (tsparticles.min.js) and all files splitted for import syntax.
If you are still interested some lines below there are some instructions for migrating from the old particles.js library.
Library installation
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! ?
This content originally appeared on DEV Community and was authored by Matteo Bruni
Matteo Bruni | Sciencx (2021-06-28T15:35:37+00:00) tsParticles 1.30.0 is here! Confetti rework (all particles shapes supported, emojis too, with sample inside). Retrieved from https://www.scien.cx/2021/06/28/tsparticles-1-30-0-is-here-confetti-rework-all-particles-shapes-supported-emojis-too-with-sample-inside/
Please log in to upload a file.
There are no updates yet.
Click the Upload button above to add an update.