A Programmatic Animations guide is missing in aio

I believe that the animations aio guides are missing a section about programmatic animations, nothing there explains how to create and use an AnimationPlayer (via AnimationBuilder and AnimationFactory) to programmatically create animations.

Some minimal information about it can be found in the AnimationBuilder’s API Docs Usage Notes, but it is very minimal and in my opinion not complete/correct as it sort of suggests that only animate() can be used in the AnimationBuilder#build method, which is not the case (group(), query(), stagger(), etc… can be used too)

Currently the animations guides comprise of the following guides/pages:

• Introduction
• Complex Sequences
• Reusable Animations
• Route Transition Animations

I’m suggesting that a new guide/page (called “Programmatic Animations” or something like that) could be added to explain how to programmatically create and play animations (with explanations as to why going such route, examples, etc…).

(Note: the guide/page should also make clear that programmatic animations are not the suggested use of animations and that they should be used just when needed and that the standard ones via the animations field in the Component decorator should generally be preferred)

Also the animations live examples should get an additional example of programmatic animations.

[mgechev]

Hey @dario-piotrowicz, thank you for opening this feature request! There’s definitely a gap in the documentation for these APIs. Since animations are not on the immediate backlog for the docs team and we did not collect a sufficient number of votes, I’ll close the issue for now and reevaluate in the future.

[angular-automatic-lock-bot[bot]]

This issue has been automatically locked due to inactivity. Please file a new issue if you are encountering a similar or related problem.

Read more about our automatic conversation locking policy.

_{This action has been performed automatically by a bot.}