particles.js README

The project's README from github.com/VincentGarreau/particles.js. As one markdown file: README.md.

particles.js

A lightweight JavaScript library for creating particles.

Demo / Generator

particles.js generator

Configure, export, and share your particles.js configuration on CodePen:
http://vincentgarreau.com/particles.js/

CodePen demo:
http://codepen.io/VincentGarreau/pen/pnlso

Usage

Load particles.js and configure the particles:

index.html

<div id="particles-js"></div>

<script src="particles.js"></script>

app.js

/* 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

{
  "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": 0.8,
        "speed": 3
      },
      "repulse": {
        "distance": 400,
        "duration": 0.4
      },
      "push": {
        "particles_nb": 4
      },
      "remove": {
        "particles_nb": 2
      }
    }
  },
  "retina_detect": true
}

Options

key option type / notes example
particles.number.value number 40
particles.number.density.enable boolean true / false
particles.number.density.value_area number 800
particles.color.value HEX (string)
RGB (object)
HSL (object)
array selection (HEX)
random (string)		 "#b61924"
{r:182, g:25, b:36}
{h:356, s:76, l:41}
["#b61924", "#333333", "999999"]
"random"
particles.shape.type string
array selection		 "circle"
"edge"
"triangle"
"polygon"
"star"
"image"
["circle", "triangle", "image"]
particles.shape.stroke.width number 2
particles.shape.stroke.color HEX (string) "#222222"
particles.shape.polygon.nb_slides number 5
particles.shape.image.src path link
svg / png / gif / jpg		 "assets/img/yop.svg"
"http://mywebsite.com/assets/img/yop.png"
particles.shape.image.width number
(for aspect ratio)		 100
particles.shape.image.height number
(for aspect ratio)		 100
particles.opacity.value number (0 to 1) 0.75
particles.opacity.random boolean true / false
particles.opacity.anim.enable boolean true / false
particles.opacity.anim.speed number 3
particles.opacity.anim.opacity_min number (0 to 1) 0.25
particles.opacity.anim.sync boolean true / false
particles.size.value number 20
particles.size.random boolean true / false
particles.size.anim.enable boolean true / false
particles.size.anim.speed number 3
particles.size.anim.size_min number 0.25
particles.size.anim.sync boolean true / false
particles.line_linked.enable boolean true / false
particles.line_linked.distance number 150
particles.line_linked.color HEX (string) #ffffff
particles.line_linked.opacity number (0 to 1) 0.5
particles.line_linked.width number 1.5
particles.move.enable boolean true / false
particles.move.speed number 4
particles.move.direction string "none"
"top"
"top-right"
"right"
"bottom-right"
"bottom"
"bottom-left"
"left"
"top-left"
particles.move.random boolean true / false
particles.move.straight boolean true / false
particles.move.out_mode string
(out of canvas)		 "out"
"bounce"
particles.move.bounce boolean
(between particles)		 true / false
particles.move.attract.enable boolean true / false
particles.move.attract.rotateX number 3000
particles.move.attract.rotateY number 1500
interactivity.detect_on string "canvas", "window"
interactivity.events.onhover.enable boolean true / false
interactivity.events.onhover.mode string
array selection		 "grab"
"bubble"
"repulse"
["grab", "bubble"]
interactivity.events.onclick.enable boolean true / false
interactivity.events.onclick.mode string
array selection		 "push"
"remove"
"bubble"
"repulse"
["push", "repulse"]
interactivity.events.resize boolean true / false
interactivity.events.modes.grab.distance number 100
interactivity.events.modes.grab.line_linked.opacity number (0 to 1) 0.75
interactivity.events.modes.bubble.distance number 100
interactivity.events.modes.bubble.size number 40
interactivity.events.modes.bubble.duration number
(second)		 0.4
interactivity.events.modes.repulse.distance number 200
interactivity.events.modes.repulse.duration number
(second)		 1.2
interactivity.events.modes.push.particles_nb number 4
interactivity.events.modes.push.particles_nb number 4
retina_detect boolean true / false

Packages install

npm

https://www.npmjs.com/package/particles.js

npm install particles.js
Bower
bower install particles.js --save
Rails Assets
gem 'rails-assets-particles.js'
Meteor

https://atmospherejs.com/newswim/particles

meteor add newswim:particles

Hosting / CDN

Please use this host or your own to load particles.js on your projects

http://www.jsdelivr.com/#!particles.js

particles.js (VincentGarreau/particles.js)

Searching Database…

30.2K ·GitHub
Particles.js
这是干什么用的?一个轻量级的 JavaScript 库,用来创建粒子效果:把它加到网页上,就能得到会动的、可交互的粒子背景和特效。
它是一个独立的应用,还是需要加到我自己网页里的东西?它是一个库,不是独立应用:把 particles.js 引入页面,指向一个 particles.json 配置文件,它就会在 HTML canvas 元素上渲染出粒子。
怎么把它加到我的网站上?可以用 npm、Bower、Rails Assets 或 Meteor 安装,也可以直接从 CDN 加载脚本;然后配置好 index.html、一个 app.js 初始化文件,以及你的 particles.json 配置文件。
用它的同时需要 Node.js 或构建步骤吗?不需要。这个包没有任何运行时依赖;只要脚本加载好了,任何能绘制 canvas 的现代浏览器就够用了。
它只能在浏览器里运行吗?它是纯前端的:粒子在任何操作系统上的现代浏览器里都能通过 canvas 渲染,README 也建议在项目里通过 CDN 来加载它。
粒子的外观和运动方式我能调整多少?能调整的非常多,而且只需要一个 JSON 配置文件:粒子的数量和密度、颜色(HEX、RGB、HSL、随机,或一个数组)、形状(圆形、edge、三角形、多边形、星形,或你自己的图片)、大小、透明度、移动速度和方向、反弹效果,以及连接附近粒子的线条。
访问者能和粒子互动吗?可以。鼠标悬停支持 grab、bubble 和 repulse 三种模式,点击可以推动、移除、放大或排斥粒子;事件既能在 canvas 上检测,也能在整个窗口上检测。
有没有可视化的配置编辑器?有,README 推荐了一个 CodePen 演示和生成器,你可以在上面配置、导出并分享 particles.js 配置,不用手动编辑文件。
粒子可以用图片吗?支持哪些格式?可以。把形状类型设为 image,并把 src 指向一个 svg、png、gif 或 jpg 文件;width 和 height 选项可以保持图片的宽高比。
What are similar projects?mojs, zdog, GSAP, parallax, paper.js, hyalite--liquid-glass, matter-js, konva
Which topics is it in?effects, creative-coding, interactive, canvas, graphics, javascript-library, design, animation, browser, ui, web-development, free
Creator
VincentGarreau
Size
0.2 MB
Stars
30.2K
Updated
CommitMar 25Release2.0.0May 09
Age
12y
Commits · 90 Days