使用文档
Particles 是一个零依赖的轻量 Canvas 背景特效,支持高分屏、连线、互动与主题。
快速开始
<canvas id="bg"></canvas>
<script src="assets/js/particles.js"></script>
<script>
const p = new Particles(document.getElementById('bg'), {
count: 120,
connect: true,
linkDistance: 120,
mouse: 'repel',
theme: 'dark'
});
p.start();
</script>
参数
- count: 粒子数量(建议 60–240)。
- speed: 基础速度(0.1–2,默认 0.6)。
- connect: 是否绘制粒子连线。
- linkDistance: 连线阈值距离(像素)。
- mouse: 鼠标交互模式:none/repel/attract。
- theme: 主题:dark/light/neon/forest。
- mode: 场景模式:constellation/flow/orbit/spray/glow。
- colors: { particle, line } 自定义颜色。
API
- start(): 启动渲染循环。
- stop(): 停止渲染循环。
- setConfig(partial): 动态更新配置(自动热应用)。
- setScene(name): 应用预设场景。
- resize(): 手动触发自适应。
嵌入技巧
- 确保 Canvas 全屏覆盖:使用
position: fixed; inset: 0;
。 - 使用
pointer-events: none
让交互落在页面内容上。 - 深色主题更适合连线与荧光效果。