[Proposal] Behaviors extension to VisualElementExtensions

Behaviors extension to VisualElementExtensions

• Proposed
• Prototype
• Implementation
  • iOS Support
  • Android Support
  • macOS Support
  • Windows Support
• Unit Tests
• Sample
• Documentation

Link to Discussion

#28

Summary

I would like to propose that we add the WithBehavior(this VisualElement visualElement, Behavior behavior) and WithBehaviors(this VisualElement visualElement, params Behavior[] behaviors) extensions that will add the supplied behavior to visualElement.Behaviors.

Motivation

Reduces the amount of code developers need to write 😄

Detailed Design

public static class VisualElementExtensions
{
    public static WithBehavior(this VisualElement visualElement, Behavior behavior)
    {
        visualElement.Behaviors.Add(behavior);
        return visualElement;
    }

    public static WithBehaviors(this VisualElement visualElement, params Behavior[] behaviors)
    {
        foreach (var behavior in behaviors)
        {
            WithBehavior(behavior);
        }
        return visualElement;
    }
}

Usage Syntax

Content = new Entry
{
    Placeholder = "Start typing until MaxLength is reached...",
    MaxLength = 100
}.WithBehavior(new MaxLengthReachedBehavior().Bind(
        MaxLengthReachedBehavior.CommandProperty,
        nameof(ViewModel.MaxLengthReachedCommand));

Drawbacks

n/a

Alternatives

n/a

Unresolved Questions

n/a

[bijington]

Hey team & community,

@brminnick @jfversluis @VladislavAntonyuk @pictos

Would you mind voting on whether you would like to approve this PR or not. Given the RC is coming very soon it would be nice to get this in to help with the docs writing.

👍 for yes and 👎 for no

[bijington]

I think this is done with merging the Docs?

Oh yeah thanks! Closed now 😄