Skip to content

CASpringAnimation: perceptualDuration property ​

The perceptualDuration property is how long the animation appears to last; it's shorter than settlingDuration.

Value ​

A number, in seconds.

  • Read-only. Assigning to it throws TypeError.
  • Computed from mass, stiffness, damping, and initialVelocity, using their current values on every read. So read it only after all of them are set.
  • 0.628 with the default parameters.
  • No change event: it changes only along with the properties above, and only your own code changes those.

Examples ​

js
const spring = CASpringAnimation.animationWithKeyPath('position');
console.log(spring.perceptualDuration.toFixed(3));

Result: the console prints 0.628.

Corresponding iOS API ​

CASpringAnimation.perceptualDuration.

See also ​