2.5.0 • Published 3 years ago

confetti-react v2.5.0

Weekly downloads
422
License
MIT
Repository
github
Last release
3 years ago

This is a fork

This is a fork of react-confetti from a time when the library was unsupported and the latest release was completely broken. It is my understanding that the original library is once again actively maintained.

confetti-react

Confetti without the cleanup.

Build Status npm npm bundle size npm type definitions

Based on a pen by @Gthibaud: https://codepen.io/Gthibaud/pen/ENzXbp

demogif

Install

npm install confetti-react

Use

width and height props are recommended. They will default to the initial window dimensions, but will not respond to resize events. It is recommended to provide the dimensions yourself. Here is an example using a hook:

import React from 'react';
import useWindowSize from 'react-use/lib/useWindowSize';
import Confetti from 'confetti-react';

export default () => {
  const { width, height } = useWindowSize();
  return <Confetti width={width} height={height} />;
};

Props

PropertyTypeDefaultDescription
widthNumberwindow.innerWidth \|\| 300Width of the <canvas> element.
heightNumberwindow.innerHeight \|\| 200Height of the <canvas> element.
numberOfPiecesNumber200Number of confetti pieces at one time.
confettiSource{ x: Number, y: Number, w: Number, h: Number }{x: 0, y: 0, w: canvas.width, h:0}Rectangle where the confetti should spawn. Default is across the top.
frictionNumber0.99
windNumber0
gravityNumber0.1
initialVelocityXNumber4How fast confetti is emitted horizontally
initialVelocityYNumber10How fast confetti is emitted vertically
colorsString[]['#f44336''#e91e63''#9c27b0''#673ab7''#3f51b5''#2196f3''#03a9f4''#00bcd4''#009688''#4CAF50''#8BC34A''#CDDC39''#FFEB3B''#FFC107''#FF9800''#FF5722''#795548']All available Colors for the confetti pieces.
opacityNumber1.0
recycleBooltrueKeep spawning confetti after numberOfPieces pieces have been shown.
runBooltrueRun the animation loop
tweenDurationNumber5000How fast the confetti is added
tweenFunction(currentTime: number, currentValue: number, targetValue: number, duration: number, s?: number) => numbereaseInOutQuadSee tween-functions
drawShape(context: CanvasRenderingContext2D) => voidundefinedSee below
onConfettiComplete(confetti: Confetti) => voidundefinedCalled when all confetti has fallen off-canvas.

drawShape()

Draw a custom shape for a particle. If not provided, defaults to a random selection of a square, circle or strip confetto. The function is called with the canvas context as a parameter and the Particle as the this context.

For example, to draw all spirals:

<Confetti
  drawShape={ctx => {
    ctx.beginPath();
    for (let i = 0; i < 22; i++) {
      const angle = 0.35 * i;
      const x = (0.2 + 1.5 * angle) * Math.cos(angle);
      const y = (0.2 + 1.5 * angle) * Math.sin(angle);
      ctx.lineTo(x, y);
    }
    ctx.stroke();
    ctx.closePath();
  }}
/>