Git Product home page Git Product logo

react-confetti's Introduction

react-confetti

Confetti without the cleanup. Demo

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 react-confetti

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 'react-confetti'

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

Props

Property Type Default Description
width Number window.innerWidth || 300 Width of the <canvas> element.
height Number window.innerHeight || 200 Height of the <canvas> element.
numberOfPieces Number 200 Number 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.
friction Number 0.99
wind Number 0
gravity Number 0.1
initialVelocityX Number | { min: Number, max: Number } 4 Range of values between which confetti is emitted horizontally, positive numbers being rightward, and negative numbers being leftward. Giving a number x is equivalent to giving a range { min: -x, max: x }.
initialVelocityY Number | { min: Number, max: Number } 10 Range of values between which confetti is emitted vertically, positive numbers being downward, and negative numbers being upward. Giving a number y is equivalent to giving a range { min: -y, max: 0 }.
colors String[] ['#f44336'
'#e91e63'
'#9c27b0'
'#673ab7'
'#3f51b5'
'#2196f3'
'#03a9f4'
'#00bcd4'
'#009688'
'#4CAF50'
'#8BC34A'
'#CDDC39'
'#FFEB3B'
'#FFC107'
'#FF9800'
'#FF5722'
'#795548']
All available Colors for the confetti pieces.
opacity Number 1.0
recycle Bool true Keep spawning confetti after numberOfPieces pieces have been shown.
run Bool true Run the animation loop
tweenDuration Number 5000 How fast the confetti is added
tweenFunction (currentTime: number, currentValue: number, targetValue: number, duration: number, s?: number) => number easeInOutQuad See tween-functions
drawShape (context: CanvasRenderingContext2D) => void undefined See below
onConfettiComplete (confetti: Confetti) => void undefined Called 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()
  }}
/>

react-confetti's People

Contributors

alampros avatar balderdash avatar dependabot[bot] avatar okcoker avatar michaeldeboey avatar adrianmcli avatar alexieyizhe avatar arnemolland avatar cwstra avatar singingwolfboy avatar drewrwilson avatar ticky avatar bluemaex avatar matyus avatar ndelangen avatar coolbaluk avatar twobit avatar semantic-release-bot avatar

Watchers

James Cloos avatar

react-confetti's Issues

Upgrade `pkg.engines.node` to LTS/Maintenance version ranges

Issue

Current pkg.engines.node is set to >=10.18.

  • v10 reached End-of-life a long time ago (2021-04-30)
  • Using >= means that this package endorse the use of unstable and "odd major versions"

Suggestion

pkg.engines.node should only use version ranges for stable releases and in best cases only endorse LTS versions.

It could look something like:

{
  "engines": {
    "node": "^14 || ^16 || ^18"
  }
}

npm pkg set engines.node='^14 || ^16 || ^18' should probably do the trick.

Update vulnerable dev dependencies

Issue

I have identified two vulnerable devDependencies that probably can be bumped to the highest major within the current ^ semver range.

@babel/core

Screenshot 2023-03-03 at 22 52 22

https://devhub.checkmarx.com/cve-details/Cxc7705965-e0f0/

semantic-release

Screenshot 2023-03-03 at 22 52 40

https://devhub.checkmarx.com/cve-details/CVE-2022-31051/

Suggestion

Find the highest published version that wouldn't break the current ^ semver and install that version. Useful commands:

Find out:

  • npm view @babel/core
  • npm view @babel/core versions
  • npm view semantic-release
  • npm view semantic-release versions

Fix:

  • npm install --save-dev @babel/[email protected]
  • npm install --save-dev semantic-release@???

Replace home-made types for dependency `tween-functions` with types from DefinitelyTyped

Issue

This package depends on tween-functions. Today the types for tween-functions are home-made and defined in ./types/tween-functions.d.ts.

These should be replace with the official types from DefinitelyTyped.

Suggestion

rpm install --save-dev @types/tween-functions, delete ./types/tween-functions.d.ts and update tsconfig.json.

Risks

  • An upgrade of typescript package might be needed. It might lead to an upgrade cascade of other packages. If that is the case this issue should be postponed and escalated within the team.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.