Skip to content

Каталог форм ​

Этот каталог перечисляет наиболее распространенные значения particles.shape.type и показывает, когда particles.shape.options добавляет настройки для конкретной формы.

Исходные папки:

Распространенные типы форм ​

  • circle (по умолчанию, без дополнительных параметров формы)
  • square / edge (без дополнительных параметров формы)
  • triangle (без дополнительных параметров формы)
  • line (без дополнительных параметров формы)
  • polygon (options.polygon.sides)
  • star (options.star.sides, options.star.inset)
  • text (options.text.value, font, weight, style, close)
  • emoji (options.emoji.value)
  • image / images (options.image.src, name, width, height, replaceColor, close)
  • gif / gifs (options.gif.src, name, width, height, loopCount)
  • ribbon (options.ribbon.angle, count, drag, mass, oscillationDistance, oscillationSpeed, particleDist, velocityInherit)

Примечания по алиасам и бандлам ​

  • square и edge - алиасы одной и той же формы.
  • character и char - алиасы одной и той же группы параметров.
  • image и images используют один и тот же объект параметров.
  • Большинство расширенных форм требуют @tsparticles/slim (или @tsparticles/all) либо отдельные shape-пакеты.

Чтобы быстро протестировать их с кнопками Start/Pause и редактируемым JSON, используйте /playground/shapes.

Быстрые примеры ​

Polygon ​

ts
particles: {
  shape: {
    type: "polygon",
    options: {
      polygon: {
        sides: 6,
      },
    },
  },
}

Emoji ​

ts
particles: {
  shape: {
    type: "emoji",
    options: {
      emoji: {
        value: ["😀", "🎉", "✨"],
        font: "Apple Color Emoji",
        padding: 0,
      },
    },
  },
}

Text ​

ts
particles: {
  shape: {
    type: "text",
    options: {
      text: {
        value: ["TS", "DOCS"],
        font: "Verdana",
        weight: "700",
        style: "",
      },
    },
  },
}

Image ​

ts
particles: {
  shape: {
    type: "image",
    options: {
      image: {
        src: "https://particles.js.org/images/hdr/fruits/strawberry.png",
        name: "strawberry",
        width: 64,
        height: 64,
        replaceColor: false,
      },
    },
  },
}