<!--
{
  "availability" : [
    "iOS: 7.0.0 -",
    "iPadOS: 7.0.0 -",
    "macCatalyst: 13.1.0 -",
    "tvOS: -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "UIKit",
  "identifier" : "/documentation/UIKit/UIView/perform(_:on:options:animations:completion:)",
  "metadataVersion" : "0.1.0",
  "role" : "Type Method",
  "symbol" : {
    "kind" : "Type Method",
    "modules" : [
      "UIKit"
    ],
    "preciseIdentifier" : "c:objc(cs)UIView(cm)performSystemAnimation:onViews:options:animations:completion:"
  },
  "title" : "perform(_:on:options:animations:completion:)"
}
-->

# perform(_:on:options:animations:completion:)

Performs a specified system-provided animation on one or more views, along with optional parallel animations that you define.

```
class func perform(_ animation: UIView.SystemAnimation, on views: [UIView], options: UIView.AnimationOptions = [], animations parallelAnimations: (() -> Void)?, completion: ((Bool) -> Void)? = nil)
```

## Parameters

`animation`

The system animation to perform; a constant from the [`UIView.SystemAnimation`](/documentation/UIKit/UIView/SystemAnimation) enum.

`views`

The views to perform the animations on.

`options`

A mask of options indicating how you want to perform the animations. For a list of valid constants, see [`UIView.AnimationOptions`](/documentation/UIKit/UIView/AnimationOptions).

`parallelAnimations`

Additional animations you specify to run alongside the system animation, with the same timing and duration that the system animation defines or inherits.

    In your additional animations, do not modify properties of the view on which the system animation is being performed.

`completion`

A block object to be executed when the animation sequence ends. The single Boolean argument indicates whether or not the animations finished before the completion handler was called. If the animation duration is `0`, this block is performed at the beginning of the next run-loop cycle. You can use a `nil` value for this parameter.

## Discussion

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)