Skip to content

Interactivity Modes ​

interactivity.modes defines mode-specific settings used by events.

Example ​

ts
interactivity: {
  modes: {
    grab: {
      distance: 170,
      links: {
        opacity: 0.45,
      },
    },
    bubble: {
      distance: 180,
      size: 12,
      duration: 2,
    },
    push: {
      quantity: 6,
    },
    repulse: {
      distance: 130,
      duration: 0.35,
    },
  },
}

Emitter / Absorber ​

These modes are available when the corresponding plugin package is loaded.

ModeTypeNotes
emitterobject / arraySee Emitters plugin
absorberobject / arraySee Absorbers plugin
absorber-split-Splits the absorber under the cursor, see Absorbers plugin

absorber-split is a click mode: enable it under interactivity.events.onClick.mode to split the absorber under the pointer. The absorber also needs split.enable set to true; the same option enables automatic splitting when the absorber reaches its size limit.

Practical guidance ​

  • Enable only the modes you really use.
  • Keep distances moderate for stable performance.
  • Use Start/Pause controls for expensive mode combinations.

Related pages:

Source reference ​