<!--
{
  "availability" : [
    "Apple News Format: 1.7.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AppleNewsFormat",
  "identifier" : "/documentation/AppleNewsFormat/ComponentAnimation",
  "metadataVersion" : "0.1.0",
  "role" : "Object",
  "symbol" : {
    "kind" : "Object",
    "modules" : [
      "Apple News Format"
    ],
    "preciseIdentifier" : "data:news_format:ComponentAnimation"
  },
  "title" : "ComponentAnimation"
}
-->

# ComponentAnimation

Properties that all types of animations share.

```
object ComponentAnimation
```

## Discussion

Apply an animation to a component to add movement and interest to your article.

> Note:
> Don’t use this object type directly. Instead, use objects (such as ``doc://com.apple.applenews/documentation/AppleNewsFormat/AppearAnimation``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/FadeInAnimation``, ``doc://com.apple.applenews/documentation/AppleNewsFormat/MoveInAnimation``, and ``doc://com.apple.applenews/documentation/AppleNewsFormat/ScaleFadeAnimation``) that extend animation.

Apple News Format applies a `ComponentAnimation` just once each time someone views your article. (Compare that with component behaviors whose effects are persistent and happen every time someone sees the component in your article.)

A person can control some animations with an optional `userControllable` property.

You can use this object in [`Component`](/documentation/AppleNewsFormat/Component).

## See Also

  <doc://com.apple.applenews/documentation/AppleNews/adding-animations>

## Relationships

### Inherited By

[`MoveInAnimation`](/documentation/AppleNewsFormat/MoveInAnimation)

[`FadeInAnimation`](/documentation/AppleNewsFormat/FadeInAnimation)

[`AppearAnimation`](/documentation/AppleNewsFormat/AppearAnimation)

[`ScaleFadeAnimation`](/documentation/AppleNewsFormat/ScaleFadeAnimation)

---

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)