选项参考

tsParticles 的 options 体系较深，这一页可作为总览地图，帮助你在进入各子选项前先建立整体认知。

选择你的配置路径

快速视觉结果: 从 preset 开始并覆盖关键字段。
完全控制: 手动定义 particles、interactivity、background。
config-first 路径: 从 @tsparticles/configs 起步，再逐步细化配置。

快速导航（本地）

粒子深度页面

参考文档在哪里

主 options 文档: tsparticles/markdown/Options.md
详细 options 页面: tsparticles/markdown/Options/
TypeScript 接口: tsparticles/engine/src/Options/Interfaces

最常用的 root options

background
fullScreen
interactivity
particles
detectRetina
preset
responsive

最常用的区块

background: canvas 背景与遮罩的基础设置。
particles.number: 粒子数量与密度。
particles.move: 速度、方向与 out modes。
particles.shape: 圆形、多边形、图片、表情或自定义。
particles.palette: 快速切换协调色组。
interactivity: hover/click 模式与外部效果。
detectRetina: 高 DPI 屏幕下的画质与性能平衡。

粒子地图（嵌套视图）

在进入单页详情前，可先参考下列导航树：

text

particles
|- number
|- color
|- shape
|- size
|- opacity
|- move
|- links
|- collisions
|- life
|- destroy
|- group
|- orbit
|- repulse
|- roll
|- rotate
|- shadow
|- stroke
|- tilt
|- twinkle
|- wobble
|- zIndex
`- palette

建议先读 root 文档，再进入深度页面：

基础: Particles
深入阅读: Particles Number, Particles Move, Particles Links

稳妥的 options 配置流程

从 demos 或 presets 中可运行的配置开始。
每次只修改一个区块。
在应用代码中使用 TypeScript（IOptions）校验。
将生产配置放到专用 JSON 文件中。

最小类型示例

import type { ISourceOptions } from "@tsparticles/engine";

export const particlesOptions: ISourceOptions = {
  fpsLimit: 60,
  particles: {
    number: { value: 70 },
    move: { enable: true, speed: 1.5 },
  },
};

性能护栏

非必要情况下优先使用 @tsparticles/slim。
粒子数量应与容器面积成比例。
在真实设备上做 profile 后再添加重交互。

选项参考 ​

选择你的配置路径 ​

快速导航（本地） ​

粒子深度页面 ​

参考文档在哪里 ​

最常用的 root options ​

最常用的区块 ​

粒子地图（嵌套视图） ​

稳妥的 options 配置流程 ​

最小类型示例 ​

性能护栏 ​

相关参考 ​

选项参考

选择你的配置路径

快速导航（本地）

粒子深度页面

参考文档在哪里

最常用的 root options

最常用的区块

粒子地图（嵌套视图）

稳妥的 options 配置流程

最小类型示例

性能护栏

相关参考