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.

MIT License

Downloads
7M
Stars
7.1K
Committers
89

Bot releases are hidden (Show)

tsparticles - tsParticles 1.40.0

Published by matteobruni over 2 years ago

tsParticles 1.40.0

Internal Updates

  • Static classes are replaced by Engine instance singletons, this is useful for multiple instances installations since they can behave differently
  • Updated README.md files
  • Updated all packages to match the minor version, so it's easier to understand which package is matching the engine version

New Features

  • Added domId property to Emitters options, setting that to match a real dom element id will attach the emitter to the element (closes #2256)

Breaking Changes

  • The new instance singleton management is going to break the deprecated react-particles-js, but I decided to not change the major version since all the official components will continue to work as expected.
tsparticles - tsParticles 1.39.3

Published by matteobruni over 2 years ago

tsParticles 1.39.3

Bug Fixes

  • Solved performance drop issue after the refresh, closes #2809, #2815, #2936

Changes

  • updated fps limit default value to 120, updated all presets to have the fps limit of 120 (Chrome supports that also in Mac Pro Motion displays, Safari for now is limited to 60)
tsparticles - tsParticles 1.39.2

Published by matteobruni over 2 years ago

tsParticles 1.39.2

Bug Fixes

  • Fixed editor issues
tsparticles - tsParticles 1.39.1

Published by matteobruni over 2 years ago

tsParticles 1.39.1

Bug Fixes

  • Fixed issues with absorbers and emitters plugins Container extension methods
tsparticles - tsParticles 1.39.0

Published by matteobruni almost 3 years ago

tsParticles 1.39.0

Bug Fixes

  • Fixed priority on canvas styles
  • Fixed react/preact/inferno components exports
  • Improved image loading, now in parallel

Improvements

  • Added all files for supporting the smaller engine file, preparing for v2 incoming changes. The engine file can be included or imported for a clean setup, and the plugins can be chosen manually
  • Renamed Main class to Engine, kept backward compatibility
  • Improved image loading, now they are loaded in parallel, and now if an image is missing, it will be loaded at runtime

Breaking Changes

  • Enums are not exported anymore, this breaks their javascript usages
tsparticles - tsParticles 1.38.0

Published by matteobruni almost 3 years ago

tsParticles version 1.38.0

Breaking Changes

  • Removed the custom canvas class (tsparticles-canvas-el), replacing it with a data attribute. This will break some CSS, but I'd prefer breaking it for focusing more on options

New Features

  • Added style options, they are applied directly to the canvas, it's the same .style object of the standard JavaScript HTMLElement class (docs here)
tsparticles - tsParticles 1.34.1

Published by matteobruni about 3 years ago

tsparticles - tsParticles 1.33.1

Published by matteobruni about 3 years ago

tsParticles 1.33.1

Bug Fixes

  • Fixed frozen frames (more than 1 second), this will fix the issue with pause on blur
  • Removed some console.log calls
tsparticles - tsParticles 1.33.0

Published by matteobruni about 3 years ago

tsParticles 1.33.0

New Features

  • Added spin movement options
  • Bubble color can now be mixed with the original one to have a smoother effect

Improvements

  • Added resize observer, this will replace window.resize if available

Bug Fixes

  • Fixed images shape options
  • Fixed pause on blur
  • Fixed broken movement after 1.31
tsparticles - tsParticles 1.32.0

Published by matteobruni about 3 years ago

tsParticles 1.32.0

Breaking Changes

  • Removed some old unused alias types
  • Removed the infection plugin from the library, it's an external plugin now
  • Removed light interaction from the core library, it's an external plugin now

Bug Fixes

  • Improved particles links, closes #1848
  • Fixed out of canvas out mode

New Features

  • Improved roll back color, now darken and enlighten can be set both and one of them will be picked randomly for each particle and will work also for animated colors
  • Added particles orbits external plugin, closes #188
  • Added particle repulse external plugin, closes #609
tsparticles - tsParticles 1.31.1

Published by matteobruni over 3 years ago

tsParticles 1.31.1

Bug Fixes

  • improved images loading
tsparticles - tsParticles 1.31.0

Published by matteobruni over 3 years ago

tsParticles 1.31.0

New Features

  • Added zIndex options, closes #979
  • Added particles groups to options

Changes

  • Infection is now a plugin, and it's included and is not included in the slim version
  • Changed particles move distance options to an horizontal/vertical object, single number still valid
tsparticles - tsParticles 1.30.0

Published by matteobruni over 3 years ago

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.

tsparticles - tsParticles 1.29.0

Published by matteobruni over 3 years ago

tsparticles - tsParticles 1.28.0

Published by matteobruni over 3 years ago

tsparticles - tsParticles 1.18.0

Published by matteobruni about 4 years ago

tsParticles 1.18.0

Release Notes

New Features

  • Manual Particles (closes #839)
  • Links and Triangles frequency (closes #691)
  • Mouse hover can act as a light source (closes #606)
  • Particles duplicates can be reduced (closes #437)
  • Options have now a dedicated GUI editor library (closes #534)
  • Theming options (closes #646)
  • Added support to HSV colors (closes #692)
  • OutMode can be configured for every canvas edge (closes #739)
  • Bounce interaction mode; divs and mouse hover have this mode (closes #774)
  • Particles can have a max radius to move inside (closes #797)
  • Particles movement can be affected by the size, the higher the size, the higher the speed
  • Particles movement has now gravity options
  • Particles can have a custom life span and a life count, like the emitter options
  • Particles can now configure bounces on canvas edge and for particles collisions
  • New Motion settings for prefer-reduced-motion users, it can reduce or disable animations

Bug Fixes

  • Single exported options type, used by all components (closes #898)
  • Fixed click bubble mode (closes #618)

Breaking Changes

  • Color animation with sync false in 1.17.0 used a random color instead of a random speed. This is fixed in 1.18.0 but you need to use the random value in color and not sync: false to achieve the same effect.
tsparticles - tsParticles 1.17.9

Published by matteobruni about 4 years ago