Skip to main content
This release is 2 versions behind 2.0.0 — the latest version of @adam/confetti. Jump to latest

This package allows you to throw confetti on a page, within the browser.

This package works with Browsers
This package works with Browsers
JSR Score
100%
Published
7 months ago (1.0.1)

confetti

A package that allows you to throw confetti on the page.

Throwing confetti on the page

You can throw confetting on the page by writing the following:

import { throwConfetti } from '@adam/confetti'

const button = document.querySelector('#confetti-button')

button.addEventListenter('click', throwConfetti)

Passing optional options

The throwConfetti function can also take an optional options object to control the behavior of the confetti and canvas.

  • canvasId?: string
    • Queries for a custom canvasId if passed. If not found, it uses this id to generate a canvas.
  • customStyles?: CSSStyleDeclaration
    • Allows an object of custom styles to be applied to the canvas.
  • particleCount?: number
    • Allows for a custom number of particles to be generated on the canvas.
  • secondsUntilDeletion?: number
    • Allows for the canvas to be auto deleted after the number of seconds defined here has passed.
  • selectorToAppend?: string
    • Allows a custom selector to be defined for where the canvas is appended.
import { throwConfetti } from '@adam/confetti'

const button = document.querySelector('#confetti-button')

button.addEventListenter('click', () => {
  throwConfetti({
    canvasId: 'custom-canvas-id',
    customStyles: { width: '500px', height: '500px' },
    particleCount: 300,
    secondsUntilDeletion: 8,
    selectorToAppend: 'main',
  })
})