Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

vue-confetti

Package Overview
Dependencies
Maintainers
1
Versions
34
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

vue-confetti

A Vue component for dropping confetti.

  • 1.3.0
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
13K
increased by6.7%
Maintainers
1
Weekly downloads
 
Created
Source

vue-confetti

npm version semantic-release

:tada: A Vue component for dropping confetti :tada:

Example animation

View the demo

Installation

npm install vue-confetti --save

Usage

<template>
  <main>
    <button @click="start">Start</button>
    <button @click="stop">Stop</button>
    <button @click="love">Show some love</button>
  </main>
</template>

<script>
  import Vue from 'vue'
  import VueConfetti from 'vue-confetti'

  Vue.use(VueConfetti)

  export default {
    methods: {
      start() {
        this.$confetti.start();
      },

      stop() {
        this.$confetti.stop();
      }

      love() {
        this.$confetti.update({
          shape: 'heart',
          colors: [
            'red',
            'pink',
            '#ba0000'
          ],
        });
      }
    }
  }
</script>

Configuration

The following options can be passed to $confetti.start() or $confetti.update():

PropertyTypeDescriptionDefault
shapeStringThe shape of the confetti ('circle', 'rect', 'heart' or 'image').'circle'
sizeNumberThe size of the particles (should be a positive number).10
dropRateNumberThe speed at which the particles fall.10
colorsArrayThe confetti colors.['DodgerBlue', 'OliveDrab', 'Gold', 'pink', 'SlateBlue', 'lightblue', 'Violet', 'PaleGreen', 'SteelBlue', 'SandyBrown', 'Chocolate', 'Crimson']
imageStringThe path to a custom image or SVG to use as the particle. Note that shape must be set to image.null
canvasIdStringThe ID for a custom canvas element (the default is to append a canvas to the <body> element).null
particlesPerFrameNumberThe number of particles to drop per animation frame.2

Examples

Red and pink hearts:
$confetti.start({
  shape: 'heart',
  colors: [
    'red',
    'pink',
    '#ba0000',
  ],
});
Custom image:
$confetti.start({
  shape: 'image',
  image: 'http://placekitten.com/50/50',
});
Custom canvas:
$confetti.start({
  canvasId: 'my-custom-canvas',
});
Alternative particles per frame, drop rate and size:
$confetti.start({
  particlesPerFrame: 0.25,
  dropRate: 3,
  size: 5,
});

Development

The following scripts are available for local development:

# test
npm run test

# run with webpack watch
npm run dev

# build for production
npm run build

# serve the demo page (watch for changes from another terminal)
npm run demo

Note that vue-confetti enforces conventional commits to help automate the release process. Whenever code is merged into master the next semantic version number is automatically determined, a changelog generated and the release published.

FAQs

Package last updated on 08 Jun 2019

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc