[Proposal] Animation Behavior

Animation Behavior

• Proposed
• Prototype
• Implementation
  • iOS Support
  • Android Support
  • macOS Support
  • Windows Support
• Unit Tests
• Documentation: https://github.com/MicrosoftDocs/CommunityToolkit/pull/121
• Sample: https://github.com/CommunityToolkit/Maui/blob/main/samples/CommunityToolkit.Maui.Sample/Pages/Behaviors/AnimationBehaviorPage.xaml

Summary

AnimationBehavor is a Behavior that can be attached to any VisualElement, allowing developers to trigger the following animations via ICommand AnimateCommand:

• #519
• FlipHorizontalAnimation
• FlipVerticalAnimation
• RotateAnimation
• ScaleAnimation
• ShakeAnimation

Motivation

AnimationBehavior solves the following challenges:

• Animations are not easily accomplished in XAML
• Animations are not easily accomplished using ICommand

Following the implementation of AnimationBehavior, developers will easily be able to create bindable animations for any VisualElement

Detailed Design

AnimationBehavior.shared.cs

AnimationBehavior is a Behavior can be attached to any VisualElement.

AnimationBehavior implements EventToCommandBehavior.

public class AnimationBehavior : EventToCommandBehavior
{
    public static readonly BindableProperty AnimationTypeProperty;
    public static readonly BindableProperty AnimateCommandProperty;

    public AnimationBase? AnimationType { get; set; }
    public ICommand AnimateCommand { get; }
}

AnimationBase<TView>

AnimationBase is an abstract class implementing BindableObject that allows for creating animations.

public abstract class AnimationBase<TView> : BindableObject where TView : View
{
    public static readonly BindableProperty DurationProperty;
    public static readonly BindableProperty EasingTypeProperty

    public uint Duration { get; set; }
    public Easing Easing { get; set; }

    public abstract Task Animate(TView? view);
}

[bijington]

Hi @bijington, I’ve unassigned myself so go for it!

Thank you and thanks for all the hard work in getting it to this stage it really is appreciated!

[stefanbogaard86]

Hi @bijington, I’ve unassigned myself so go for it!