A lightweight JavaScript library for creating particles
npm install particles.js-------------------------------
Load particles.js and configure the particles:
index.html
``html
`
app.js
`javascript`
/ particlesJS.load(@dom-id, @path-json, @callback (optional)); /
particlesJS.load('particles-js', 'assets/particles.json', function() {
console.log('callback - particles-js config loaded');
});
particles.json
`javascript`
{
"particles": {
"number": {
"value": 80,
"density": {
"enable": true,
"value_area": 800
}
},
"color": {
"value": "#ffffff"
},
"shape": {
"type": "circle",
"stroke": {
"width": 0,
"color": "#000000"
},
"polygon": {
"nb_sides": 5
},
"image": {
"src": "img/github.svg",
"width": 100,
"height": 100
}
},
"opacity": {
"value": 0.5,
"random": false,
"anim": {
"enable": false,
"speed": 1,
"opacity_min": 0.1,
"sync": false
}
},
"size": {
"value": 10,
"random": true,
"anim": {
"enable": false,
"speed": 80,
"size_min": 0.1,
"sync": false
}
},
"line_linked": {
"enable": true,
"distance": 300,
"color": "#ffffff",
"opacity": 0.4,
"width": 2
},
"move": {
"enable": true,
"speed": 12,
"direction": "none",
"random": false,
"straight": false,
"out_mode": "out",
"bounce": false,
"attract": {
"enable": false,
"rotateX": 600,
"rotateY": 1200
}
}
},
"interactivity": {
"detect_on": "canvas",
"events": {
"onhover": {
"enable": false,
"mode": "repulse"
},
"onclick": {
"enable": true,
"mode": "push"
},
"resize": true
},
"modes": {
"grab": {
"distance": 800,
"line_linked": {
"opacity": 1
}
},
"bubble": {
"distance": 800,
"size": 80,
"duration": 2,
"opacity": 8,
"speed": 3
},
"repulse": {
"distance": 400,
"duration": 0.4
},
"push": {
"particles_nb": 4
},
"remove": {
"particles_nb": 2
}
}
},
"retina_detect": true
}
-------------------------------
key | option type / notes | example
----|---------|------|------
particles.number.value | number | 40 | boolean | true / false particles.number.density.value_area | number | 800 | HEX (string) "#b61924"
RGB (object)
HSL (object)
array selection (HEX)
random (string) | {r:182, g:25, b:36}
{h:356, s:76, l:41}
["#b61924", "#333333", "999999"]
"random"
| number | 800 | string "circle"
array selection | "edge"
"triangle"
"polygon"
"star"
"image"
["circle", "triangle", "image"]
| number | 2 | HEX (string) | "#222222" | number | 5 | path link "assets/img/yop.svg"
svg / png / gif / jpg | "http://mywebsite.com/assets/img/yop.png"
| number 100
(for aspect ratio) | | number 100
(for aspect ratio) | | number (0 to 1) | 0.75 | boolean | true / false particles.opacity.anim.enable | boolean | true / false particles.opacity.anim.speed | number | 3 | number (0 to 1) | 0.25 | boolean | true / false | number | 20 | boolean | true / false particles.size.anim.enable | boolean | true / false particles.size.anim.speed | number | 3 | number | 0.25 | boolean | true / false | boolean | true / false | number | 150 | HEX (string) | #ffffff | number (0 to 1) | 0.5 | number | 1.5 | boolean | true / false | number | 4 | string | "none" "top"
"top-right"
"right"
"bottom-right"
"bottom"
"bottom-left"
"left"
"top-left"
| boolean | true / false | boolean | true / false | string "out"
(out of canvas) | "bounce"
| boolean true
(between particles) | / false | boolean | true / false | number | 3000 | number | 1500 | string | "canvas", "window" | boolean | true / false | string "grab"
array selection | "bubble"
"repulse"
["grab", "bubble"]
| boolean | true / false | string "push"
array selection | "remove"
"bubble"
"repulse"
["push", "repulse"]
| boolean | true / false | number | 100 | number (0 to 1) | 0.75 | number | 100 | number | 40 | number 0.4
(second) | | number | 200 | number 1.2
(second) | | number | 4 | number | 4 | boolean | true / false
-------------------------------
##### Bower
`
bower install particles.js --save
##### Rails Assets
`
gem 'rails-assets-particles.js'