vue-niege
Single File Vue Component for lazy snow storms generation. Come on, let's make your Vue applications joyful for Christmas time! ? ?
Installation
You can install this component using npm:
npm install --save vue-niege
Usage
Once installed, it is easy to use it.
Importing the component
First, you need to import vue-niege
in your files. You can do that in different ways.
For example, it can be imported into a build process for use in full-fledged Vue applications:
import Snow from 'vue-niege';
export default {
components: {
Snow,
},
// rest of the component
}
Alternatively, you can import vue-niege
via <script>
tag in the browser directly:
<script src="https://unpkg.com/vue"></script>
<script src="https://unpkg.com/vue-niege"></script>
Using the component
Once imported, you can use your component as follows:
<Snow/>
This is the minimal setup to add a snowing canvas in your application.
Properties
If you need to customize the snow behavior, you can use one of the following optional properties.
Properties | Default | Description | Type |
---|---|---|---|
active | true |
provides dynamic display to the canvas: it is displayed only where this prop is true | Boolean |
color | #FFFFFF |
given a master HEX color, it defines a color pattern of four values for the snow. This property must be in expressed as HEX color (e.g.: #050484 ) |
String |
zIndex | 1 |
defines the z-index position of the canvas in the DOM. | Number |
swing | 0 |
applies a swing effect to each snowflake. By default no swinging is applied. | Number |
wind | 1 |
defines the horizontal wind effect. The effect blows from right for values greater than 0, from left for values less than 0. | Number |
speed | m |
defines the speed of the falling snow. The available values are h for high speed, m for medium speed, l for low speed. |
String |
For example, the following:
<Snow
:active='true' //e.g.: add a condition to display the canvas only if current date is in the Advent range.
:zIndex='2'
:wind='1'
:swing='3'
:speed='h'
color="#ffff00"/>
produces the following effect: