1.0.4 • Published 2 years ago

react-particle-backgrounds v1.0.4

Weekly downloads
4
License
MIT
Repository
github
Last release
2 years ago

React-Particle-Backgrounds

Simple and customisable animated particle backgrounds for React

Demo

https://mcbp.github.io/React-Particle-Backgrounds-Demo

Install

npm install --save react-particle-backgrounds

Basic Example

The <ParticleBackground /> component takes only one prop: settings.

It is defined as an object with specific shape, this is detailed below in the example code.

import React from 'react'
import ParticleBackground from 'react-particle-backgrounds'

const App = () => {

  const settings = {
    canvas: {
      canvasFillSpace: true,
      width: 200,
      height: 200,
      useBouncyWalls: false
    },
    particle: {
      particleCount: 50,
      color: '#94ecbe',
      minSize: 2,
      maxSize: 5
    },
    velocity: {
      directionAngle: 0,
      directionAngleVariance: 360,
      minSpeed: 1,
      maxSpeed: 3
    },
    opacity: {
      minOpacity: 0,
      maxOpacity: 0.5,
      opacityTransitionTime: 3000
    }
  }

  return <ParticleBackground settings={settings} />

}

export default App

Prop Types

The accepted prop types and their default values are listed below

PropertyTypeDefault ValueDescription
canvasFillSpaceBooleantrueDetermines if the component will fill the width and height of it's parent container.
widthNumber200Width of component in px, canvasFillSpace set to true will override this value.
heightNumber200Height of component in px, canvasFillSpace set to true will override this value.
useBouncyWallsBooleanfalseControls whether particles pass through walls and out the other side, or bounce off the borders.
particleCountNumber50Number of particles rendered.
colorString'#94ecbe'Color of the particles, must be either hex or rgb.
minSizeNumbernullSmallest possible size for each particle. When set to null all particles will be drawn at maxSize.
maxSizeNumber5Largest possible size for each particle.
directionAngleNumber0Direction of travel of particles in degrees, 0 being upwards.
directionAngleVarianceNumber180Defines a range for directionAngle. Maximum angle being directionAngle + directionAngleVariance and minimum being directionAngle - directionAngleVariance.
minSpeedNumbernullSmallest possible speed for each particle. When set to null all particles will be set to the value of maxSpeed.
maxSpeedNumber1Largest possible speed for each particle.
minOpacityNumbernullLowest possible opacity for each particle. When set to null all particles will be drawn at the value of maxOpacity.
maxOpacityNumber1Largest possible opacity for each particle.
opacityTransitionTimeNumber3000Time in ms for particles to transition from minOpacity to maxOpacity.

License

MIT

1.0.4

2 years ago

1.0.3

2 years ago

1.0.2

4 years ago

1.0.1

4 years ago

1.0.0

5 years ago