v1.x からの移行
v1.x から現在のバージョンへ移行するには、通常、依存関係の完全な更新と設定の検証が必要です。
実務上よくある障害は次のとおりです。
- 古いパッケージやインポートのパターン。
tsParticles.load(...)の呼び出し形式。- モダンなスキーマで更新されたオプションキー。
Load API の移行
モダンな load は単一のパラメータオブジェクトを受け取ります。
以前(レガシーな位置引数スタイル):
ts
await tsParticles.load("tsparticles", oldOptions);以後:
ts
await tsParticles.load({
id: "tsparticles",
options: oldOptions,
});JSON から読み込む場合:
ts
await tsParticles.load({
id: "tsparticles",
url: "/particles.json",
});主なオプションの移行
まず設定内で次のキーを検索してください。
particles.color->particles.paint.fillparticles.stroke->particles.paint.stroke
書き換え例:
ts
// 以前
particles: {
color: { value: ["#ff6b6b", "#4ecdc4"] },
stroke: { width: 0 }
}
// 以後
particles: {
paint: {
fill: { color: { value: ["#ff6b6b", "#4ecdc4"] } },
stroke: { width: 0 }
}
}推奨手順
- 古いパッケージ名を現在の
@tsparticles/*パッケージに置き換えます。 @tsparticles/engine+@tsparticles/slimから始め、必要なプラグインを追加します。- 古い
load呼び出しをオブジェクトベースのload({ ... })に変換します。 - 現在のドキュメントでオプションキーを検証し、名前変更・削除されたフィールドを修正します。
- デスクトップとモバイルで見た目とパフォーマンスを確認します。
チェックリスト
- 古いパッケージ構造の不要なインポートを削除します。
- インタラクション、リンク、カスタムシェイプが期待どおり動作することを確認します。
particles.jsスタイルの設定では互換レイヤーを検討してください。
便利なオプション資料
- 改名マトリクス:
/migrations/option-rename-matrix particles.paint:/options/particles-paintparticles.colorの移行メモ:/options/particles-colorparticles.strokeの移行メモ:/options/particles-stroke
参考リンク
- レガシー互換性と particles.js ブリッジ:
/migrations/particles-js - インストールマトリクス:
/guide/installation - リポジトリのリリース: https://github.com/tsparticles/tsparticles/releases
