InfoBar StackedNotificationsBehavior

[vgromfeld]

Fixes #4194

Following the discussion we had on adding new features to InAppNotificationControls, I investigated the ability to replace the WCT InAppNotificationContol by WinUI's InfoBar adding what is missing to it.

PR Type

• Feature

What is the current behavior?

Currently, there is 2 options to display in app notifications:

• WCT InAppNotificationControl
• WinUI InfoBar

InAppNotificationControl supports stacking whereas InfoBar provides a better layout but does not have any advanced features

What is the new behavior?

I'm proposing a new StackedNotificationBehavior to add InAppNotification's behavior to InfoBar.

This new behavior handles:

• notifications stacking
• auto dismiss of notifications
• keep notification visible when hovered

Each notification can be triggered using a Notification object containing:

• a title
• a message
• a severity
• a duration (if needed)

The default control configuration will be used for all notifications.
This default configuration can be overriden per notification using NotificationWithOverrides. This allows a notification to alter any property from the InfoBar control.

PR Checklist

Please check if your PR fulfills the following requirements:

• Tested code with current supported SDKs
• New component
  • Pull Request has been submitted to the documentation repository instructions. Link:
  • Added description of major feature to project description for NuGet package (4000 total character limit, so don't push entire description over that)
  • If control, added to Visual Studio Design project
• Sample in sample app has been added / updated (for bug fixes / features)
  • Icon has been created (if new sample) following the Thumbnail Style Guide and templates
• New major technical changes in the toolkit have or will be added to the Wiki e.g. build changes, source generators, testing infrastructure, sample creation changes, etc...
• Tests for the changes have been added (for bug fixes / features) (if applicable)
• Header has been added to all new source files (run build/UpdateHeaders.bat)
• Contains NO breaking changes

[ghost]

Thanks vgromfeld for opening a Pull Request! The reviewers will test the PR and highlight if there is any conflict or changes required. If the PR is approved we will proceed to merge the pull request 🙌

[XAML-Knight]

Nice implementation. Not convinced we need a separate NotificationWithOverrides class, though.

[ghost]

This PR has been marked as "needs attention 👋" and awaiting a response from the team.

[ghost]

This pull request has been automatically marked as stale because it has been marked as requiring author feedback but has not had any activity for 15 days. It will be closed if no further activity occurs within 30 days of this comment.

[ghost]

This PR has been marked as "needs attention 👋" and awaiting a response from the team.

[michael-hawker]

Build failing due to style cop rules:

D:\a\1\s\Microsoft.Toolkit.Uwp.UI.Behaviors\InfoBar\Notification.cs(6,1): error SA1208: Using directive for 'System' should appear before directive for 'Microsoft.UI.Xaml.Controls' [D:\a\1\s\Microsoft.Toolkit.Uwp.UI.Behaviors\Microsoft.Toolkit.Uwp.UI.Behaviors.csproj]
D:\a\1\s\Microsoft.Toolkit.Uwp.UI.Behaviors\InfoBar\Notification.cs(7,1): error SA1210: Using directives should be ordered alphabetically by the namespaces. [D:\a\1\s\Microsoft.Toolkit.Uwp.UI.Behaviors\Microsoft.Toolkit.Uwp.UI.Behaviors.csproj]
D:\a\1\s\Microsoft.Toolkit.Uwp.UI.Behaviors\InfoBar\StackedNotificationsBehavior.cs(6,1): error SA1208: Using directive for 'System' should appear before directive for 'Microsoft.UI.Xaml.Controls' [D:\a\1\s\Microsoft.Toolkit.Uwp.UI.Behaviors\Microsoft.Toolkit.Uwp.UI.Behaviors.csproj]
D:\a\1\s\Microsoft.Toolkit.Uwp.UI.Behaviors\InfoBar\StackedNotificationsBehavior.cs(7,1): error SA1208: Using directive for 'System.Collections.Generic' should appear before directive for 'Microsoft.UI.Xaml.Controls' [D:\a\1\s\Microsoft.Toolkit.Uwp.UI.Behaviors\Microsoft.Toolkit.Uwp.UI.Behaviors.csproj]

[michael-hawker]

@vgromfeld we've moved this over to the new Windows Community Toolkit Labs. 🎉 CommunityToolkit/Labs-Windows#211 - tracking experiment here: CommunityToolkit/Labs-Windows#210

I've copied over most of your PR (waiting for some sample improvements to make it easier to implement more samples over the next couple of weeks). Also, a bit tripped up on a build issue with long-path I think.

Anyway, going to close out this PR over here for now, as we'll continue that work forward and then bring the component back to the main repo after we re-organize for 8.0. Labs will allow us to continue development easily and gather more feedback, make improvements, etc... in the meantime! Thanks!