Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

magic-heartflakes

hcodes8MIT4.1.5

Falling snowflakes

snow, snowflakes, snowflake, flake, newyear, christmas, falling

readme

❄️ Falling snowflakes

NPM version NPM Downloads Dependency Status Build Status Bundlephobia

Details

  • Only one JavaScript file (8 KB, GZIP)
  • CSS Animation
  • Rubber design
  • Flexible settings

Examples

See details

Using

npm i magic-snowflakes --save-dev

or

yarn add magic-snowflakes

Without settings

<html>
<body>
    ...
    <script src="https://unpkg.com/magic-snowflakes/dist/snowflakes.min.js"></script>
    <script>
        Snowflakes();
    </script>
</body>
</html>

or

'use strict';

const Snowflakes = require('magic-snowflakes');
Snowflakes();

Advanced settings

<html>
<body>
    <div id="snowflakes-container" style="width: 1000px; height: 500px;"></div>
    <script src="https://unpkg.com/magic-snowflakes/dist/snowflakes.min.js"></script>
    <script>
        var sf = new Snowflakes({
            color: '#f00', // Default: "#5ECDEF"
            container: document.querySelector('#snowflakes-container'), // Default: document.body
            count: 100, // 100 snowflakes. Default: 50
            minOpacity: 0.1, // From 0 to 1. Default: 0.6
            maxOpacity: 0.95, // From 0 to 1. Default: 1
            minSize: 20, // Default: 8
            maxSize: 50, // Default: 18
            rotation: true, // Default: true
            speed: 2, // The property affects the speed of falling. Default: 1
            wind: false, // Without wind. Default: true
            width: 500, // Default: width of container
            height: 250, // Default: height of container
            zIndex: 100 // Default: 9999
        });
    </script>
</body>
</html>

Different Builds

In the dist/ directory of the NPM package you will find many different builds of snowflakes.js.

Type Filename Description
Full (UMD) snowflakes.js
Full (UMD, production) snowflakes.min.js
Light (UMD) snowflakes.light.js Without SVG images
Light (UMD, production) snowflakes.light.min.js Without SVG images

Development

git clone git@github.com:hcodes/snowflakes.git ./snowflakes
cd ./snowflakes

npm i
npm run build
npm test

open ./dev-examples/

License

MIT License

changelog

v4.1.4

  • Code refactoring.
  • Update dev deps in package.json.

v4.1.3

  • Fix color #25.
  • Update dev deps in package.json.

v4.1.2

  • Update dev deps in package.json.

v4.1.1

  • Fixed Safari scroll problem #21.

v4.1.0

  • Added CSS user-select: none and pointer-events: none for snowflakes.

v4.0.2

  • Updated dev deps in package.json.

v4.0.1

  • Updated dev deps in package.json.

v4.0.0

  • Added minSize and maxSize properties. You can set the size of snowflakes. Example.
  • Added minOpacity and maxOpacity properties.
  • Removed useScale property.
  • useRotate property renamed to rotation.
  • Added light version without SVG images: dist/snowflakes.light.js and dist/snowflakes.light.min.js. You can set your own kind of snowflakes. Example.

v3.1.0

  • demo.html moved to https://github.com/hcodes/demo-snowflakes
  • example/examples/
  • Added new examples
  • Small refactoring

v3.0.0

  • Now snowflakes in SVG format.
  • You can change the color of snowflakes. The property color: "red". Default: "#5ECDEF".
  • Snowflakes can fly without wind. The property wind: false. Default: true.

v2.2.1

Fixed Babel dependencies #10.

v2.2.0

Removed dist/.

v2.1.1

  • Small fix for server side #7.

v2.1.0

  • Added examples.
  • Fixes for constructor.

v2.0.1

Removed console.log.

v2.0.0

  • CSS optimization.
  • Added Gulp and Rollup with Babel.

v1.0.0

First public release.