Particles.js 粒子特效库使用指南与参数详解

作者：半夏时间：2026-10-22 08:07:42浏览：472

本文详细介绍Particles.js库的集成方法与核心配置。涵盖从HTML引入脚本到JSON参数文件的完整流程，重点解析粒子数量、颜色、形状、运动轨迹及鼠标交互事件的详细参数设置，帮助开发者快速实现科幻风格的背景特效。

Particles.js 简介与资源

在产品开发过程中，优质的用户界面至关重要。近期发现一种散射原子颗粒的视觉特效效果出众，因此进行了相关实践与整理。

该项目的官方GitHub仓库地址为：https://github.com/VincentGarreau/particles.js/

官方提供了一个在线Demo制作工具，使用时可能需要网络环境支持。

此链接提供的在线工具支持将制作好的Demo导出：https://codepen.io/VincentGarreau/pen/pnlso

该网址提供了在线配置不同视觉效果的功能：http://vincentgarreau.com/particles.js/

集成与配置步骤

集成方法

首先需加载 particle.js 库并进行相应的粒子配置。

在 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 文件用于存储核心的配置参数。

需注意脚本加载的顺序，否则可能导致功能异常。

实际运行效果展示。


<!DOCTYPE html>
<html >
<head>
 <meta charset="UTF-8">
 <title>particles.js</title>
  <link rel="stylesheet" href="style.css" rel="external nofollow" >
</head>
<body>
<div id="particles-js"></div>
</body>
 <script src='particles.min.js'></script> 这个玩意需要放在下面
 <script src="index.js"></script>
</html>

Particles.js 简介与资源

如需获取完整Demo代码，可加入相关QQ群下载。其中黑色原子效果极具科幻感，表现良好。

结合CSS颜色定义与JSON配置文件，即可定制出独特的科幻视觉效果。

核心参数详解

详细参数说明

键值	参数选项/ 说明	实例
`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 原子之间吸引X水平距离	`3000`
`particles.move.attract.rotateY`	number y垂直距离	`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`

总结

以上为Particles.js中文开发手册及参数详解内容，希望能对开发者有所帮助。如有疑问欢迎留言，小编会及时回复。感谢支持。

作者最新文章

JavaScript闭包与类(Class)的区别及适用场景对比

2026-11-05 15:48:57

JavaScript入门要学ES6吗？let与箭头函数等新特性解析

2026-11-05 14:49:16

JavaScript 8种数据类型详解：基本类型与引用类型的区别

2026-11-05 14:25:15

怎么在JavaScript中使用async/await优化Ajax异步流程

2026-11-05 13:56:15

JavaScript replace回调函数实现动态正则替换逻辑

2026-11-05 13:52:13