Add and delete animations

  • Article

List animations let you insert or remove single or multiple items from a collection, such as a photo album or a list of search results.

Important APIs: AddDeleteThemeTransition class

Do's and don'ts

  • Use list animations to add a single new item to an existing set of items. For example, use them when a new email arrives or when a new photo is imported into an existing set.
  • Use list animations to add several items to a set at one time. For example, use them when you import a new set of photos to an existing collection. The addition or deletion of multiple items should happen at the same time, with no delay between the action on the individual objects.
  • Use add and delete list animations as a pair. Whenever you use one of these animations, use the corresponding animation for the opposite action.
  • Use list animations with a list of items to which you can add or delete one element or group of elements at once.
  • Don't use list animations to display or remove a container. These animations are for members of a collection or set that is already being displayed. Use pop-up animations to show or hide a transient container on top of the app surface. Use content transition animations to display or replace a container that is part of the app surface.
  • Don't use list animations on an entire set of items. Use the content transition animations to add or remove an entire collection within your container.