Provide the ability to show popups without having to subclass Popup

samples/CommunityToolkit.Maui.Sample/MauiProgram.cs

@@ -252,6 +252,8 @@ static void RegisterViewsAndViewModels(in IServiceCollection services)
 		services.AddTransientPopup<CsharpBindingPopup, CsharpBindingPopupViewModel>();
 		services.AddTransientPopup<UpdatingPopup, UpdatingPopupViewModel>();
 		services.AddTransientPopup<XamlBindingPopup, XamlBindingPopupViewModel>();
+
+		services.AddTransientPopupContent<PopupContentView, PopupContentViewModel>();
 	}
 
 	static void RegisterEssentials(in IServiceCollection services)

samples/CommunityToolkit.Maui.Sample/Pages/Views/Popup/MultiplePopupPage.xaml

@@ -31,6 +31,8 @@
                 <Button Text="C# Binding Popup" Command="{Binding CsharpBindingPopupCommand}" />
 
                 <Button Text="Updating Popup" Command="{Binding UpdatingPopupCommand}" />
+
+                <Button Text="Show Popup content" Command="{Binding ShowPopupContentCommand}" />
             </VerticalStackLayout>
         </ScrollView>
     </ContentPage.Content>

samples/CommunityToolkit.Maui.Sample/ViewModels/Views/Popup/MultiplePopupViewModel.cs

@@ -10,14 +10,22 @@ Task OnCsharpBindingPopup(CancellationToken token)
 	{
 		return popupService.ShowPopupAsync<CsharpBindingPopupViewModel>(
 			onPresenting: viewModel => viewModel.Load("This is a platform specific popup with a .NET MAUI View being rendered. The behaviors of the popup will confirm to 100% this platform look and feel, but still allows you to use your .NET MAUI Controls."),
-			token);
+			token: token);
 	}
 
 	[RelayCommand]
 	Task OnUpdatingPopup(CancellationToken token)
 	{
 		return popupService.ShowPopupAsync<UpdatingPopupViewModel>(
 			onPresenting: viewModel => viewModel.PerformUpdates(10),
-			token);
+			token: token);
+	}
+
+	[RelayCommand]
+	Task OnShowPopupContent(CancellationToken token)
+	{
+		return popupService.ShowPopupAsync<PopupContentViewModel>(
+			onPresenting: viewModel => viewModel.SetMessage("This is a dynamically set message, shown in a popup without the need to create your own Popup subclass."),
+			token: token);
 	}
 }

samples/CommunityToolkit.Maui.Sample/ViewModels/Views/Popup/PopupContentViewModel.cs

@@ -0,0 +1,11 @@
+using CommunityToolkit.Mvvm.ComponentModel;
+
+namespace CommunityToolkit.Maui.Sample.ViewModels.Views;
+
+public sealed partial class PopupContentViewModel : BaseViewModel
+{
+    [ObservableProperty]
+	string message = "";
+
+    internal void SetMessage(string text) => this.Message = text;
+}

samples/CommunityToolkit.Maui.Sample/Views/Popups/PopupContentView.xaml

@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<Grid
+    xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
+    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
+    x:Class="CommunityToolkit.Maui.Sample.Views.Popups.PopupContentView"
+    xmlns:viewModels="clr-namespace:CommunityToolkit.Maui.Sample.ViewModels.Views"
+    x:DataType="viewModels:PopupContentViewModel">
+
+    <Label
+        Text="{Binding Message}"
+        HorizontalTextAlignment="Center"
+        VerticalTextAlignment="Center"
+        Margin="20" />
+
+</Grid>

samples/CommunityToolkit.Maui.Sample/Views/Popups/PopupContentView.xaml.cs

@@ -0,0 +1,13 @@
+using CommunityToolkit.Maui.Sample.ViewModels.Views;
+
+namespace CommunityToolkit.Maui.Sample.Views.Popups;
+
+public partial class PopupContentView : Grid
+{
+	public PopupContentView(PopupContentViewModel popupContentViewModel)
+	{
+		InitializeComponent();
+
+		BindingContext = popupContentViewModel;
+	}
+}

src/CommunityToolkit.Maui.Core/IPopupService.cs

@@ -1,4 +1,5 @@
 using System.ComponentModel;
+using Microsoft.Maui.Primitives;
 
 namespace CommunityToolkit.Maui.Core;
 
@@ -11,31 +12,61 @@ public interface IPopupService
 	/// Resolves and displays a <see cref="CommunityToolkit.Maui.Core.IPopup"/> and <typeparamref name="TViewModel"/> pair that was registered with <c>AddTransientPopup</c>.
 	/// </summary>
 	/// <typeparam name="TViewModel">The type of the view model registered with the <see cref="CommunityToolkit.Maui.Core.IPopup"/>.</typeparam>
-	void ShowPopup<TViewModel>() where TViewModel : INotifyPropertyChanged;
+	/// <param name="canBeDismissedByTappingOutsideOfPopup">A <see cref="bool"/> indicating whether the <see cref="CommunityToolkit.Maui.Core.IPopup"/> can be dismissed by tapping outside of it.</param>
+	/// <param name="resultWhenUserTapsOutsideOfPopup">An <see cref="object"/> that will be returned when the user taps outside of the <see cref="CommunityToolkit.Maui.Core.IPopup"/>.</param>
+	/// <param name="verticalOptions">The vertical alignment of the <see cref="CommunityToolkit.Maui.Core.IPopup"/>.</param>
+	/// <param name="horizontalOptions">The horizontal alignment of the <see cref="CommunityToolkit.Maui.Core.IPopup"/>.</param>
+	/// <param name="size">The size of the <see cref="CommunityToolkit.Maui.Core.IPopup"/>.</param>
+	/// <param name="color">The background color of the <see cref="CommunityToolkit.Maui.Core.IPopup"/>.</param>
+	void ShowPopup<TViewModel>(
+		bool canBeDismissedByTappingOutsideOfPopup = true,
+		object? resultWhenUserTapsOutsideOfPopup = default,
+		LayoutAlignment verticalOptions = LayoutAlignment.Center,
+		LayoutAlignment horizontalOptions = LayoutAlignment.Center,
+		Size size = default,
+		Color? color = default) where TViewModel : INotifyPropertyChanged;
 
 	/// <summary>
 	/// Resolves and displays a <see cref="CommunityToolkit.Maui.Core.IPopup"/> and <typeparamref name="TViewModel"/> pair that was registered with <c>AddTransientPopup</c>.
 	/// The supplied <paramref name="onPresenting"/> provides a mechanism to invoke any methods on your view model in order to load or pass data to it.
 	/// </summary>
 	/// <typeparam name="TViewModel">The type of the view model registered with the <see cref="CommunityToolkit.Maui.Core.IPopup"/>.</typeparam>
 	/// <param name="onPresenting">An <see cref="Action{TViewModel}"/> that will be performed before the popup is presented.</param>
-	void ShowPopup<TViewModel>(Action<TViewModel> onPresenting) where TViewModel : INotifyPropertyChanged;
-
-	/// <summary>
-	/// Resolves and displays a <see cref="CommunityToolkit.Maui.Core.IPopup"/> and <typeparamref name="TViewModel"/> pair that was registered with <c>AddTransientPopup</c>.
-	/// </summary>
-	/// <typeparam name="TViewModel">The type of the view model registered with the <see cref="CommunityToolkit.Maui.Core.IPopup"/>.</typeparam>
-	/// <param name="viewModel">The view model to use as the <c>BindingContext</c> for the <see cref="CommunityToolkit.Maui.Core.IPopup"/>.</param>
-	[Obsolete("This method will be removed in an upcoming version. Use ShowPopup<TViewModel> instead.")]
-	void ShowPopup<TViewModel>(TViewModel viewModel) where TViewModel : INotifyPropertyChanged;
+	/// <param name="canBeDismissedByTappingOutsideOfPopup">A <see cref="bool"/> indicating whether the <see cref="CommunityToolkit.Maui.Core.IPopup"/> can be dismissed by tapping outside of it.</param>
+	/// <param name="resultWhenUserTapsOutsideOfPopup">An <see cref="object"/> that will be returned when the user taps outside of the <see cref="CommunityToolkit.Maui.Core.IPopup"/>.</param>
+	/// <param name="verticalOptions">The vertical alignment of the <see cref="CommunityToolkit.Maui.Core.IPopup"/>.</param>
+	/// <param name="horizontalOptions">The horizontal alignment of the <see cref="CommunityToolkit.Maui.Core.IPopup"/>.</param>
+	/// <param name="size">The size of the <see cref="CommunityToolkit.Maui.Core.IPopup"/>.</param>
+	/// <param name="color">The background color of the <see cref="CommunityToolkit.Maui.Core.IPopup"/>.</param>
+	void ShowPopup<TViewModel>(
+		Action<TViewModel> onPresenting,
+		bool canBeDismissedByTappingOutsideOfPopup = true,
+		object? resultWhenUserTapsOutsideOfPopup = default,
+		LayoutAlignment verticalOptions = LayoutAlignment.Center,
+		LayoutAlignment horizontalOptions = LayoutAlignment.Center,
+		Size size = default,
+		Color? color = default) where TViewModel : INotifyPropertyChanged;
 
 	/// <summary>
 	/// Resolves and displays a <see cref="CommunityToolkit.Maui.Core.IPopup"/> and <typeparamref name="TViewModel"/> pair that was registered with <c>AddTransientPopup</c>.
 	/// </summary>
 	/// <typeparam name="TViewModel">The type of the view model registered with the <see cref="CommunityToolkit.Maui.Core.IPopup"/>.</typeparam>
+	/// <param name="canBeDismissedByTappingOutsideOfPopup">A <see cref="bool"/> indicating whether the <see cref="CommunityToolkit.Maui.Core.IPopup"/> can be dismissed by tapping outside of it.</param>
+	/// <param name="resultWhenUserTapsOutsideOfPopup">An <see cref="object"/> that will be returned when the user taps outside of the <see cref="CommunityToolkit.Maui.Core.IPopup"/>.</param>
+	/// <param name="verticalOptions">The vertical alignment of the <see cref="CommunityToolkit.Maui.Core.IPopup"/>.</param>
+	/// <param name="horizontalOptions">The horizontal alignment of the <see cref="CommunityToolkit.Maui.Core.IPopup"/>.</param>
+	/// <param name="size">The size of the <see cref="CommunityToolkit.Maui.Core.IPopup"/>.</param>
+	/// <param name="color">The background color of the <see cref="CommunityToolkit.Maui.Core.IPopup"/>.</param>
 	/// <param name="token"><see cref="CancellationToken"/> </param>
 	/// <returns>A <see cref="Task"/> that can be awaited to return the result of the <see cref="CommunityToolkit.Maui.Core.IPopup"/> once it has been dismissed.</returns>
-	Task<object?> ShowPopupAsync<TViewModel>(CancellationToken token = default) where TViewModel : INotifyPropertyChanged;
+	Task<object?> ShowPopupAsync<TViewModel>(
+		bool canBeDismissedByTappingOutsideOfPopup = true,
+		object? resultWhenUserTapsOutsideOfPopup = default,
+		LayoutAlignment verticalOptions = LayoutAlignment.Center,
+		LayoutAlignment horizontalOptions = LayoutAlignment.Center,
+		Size size = default,
+		Color? color = default,
+		CancellationToken token = default) where TViewModel : INotifyPropertyChanged;
 
 	/// <summary>
 	/// Resolves and displays a <see cref="CommunityToolkit.Maui.Core.IPopup"/> and <typeparamref name="TViewModel"/> pair that was registered with <c>AddTransientPopup</c>.
@@ -44,16 +75,20 @@ public interface IPopupService
 	/// <typeparam name="TViewModel">The type of the view model registered with the <see cref="CommunityToolkit.Maui.Core.IPopup"/>.</typeparam>
 	/// <returns>A <see cref="Task"/> that can be awaited to return the result of the <see cref="CommunityToolkit.Maui.Core.IPopup"/> once it has been dismissed.</returns>
 	/// <param name="onPresenting">An <see cref="Action{TViewModel}"/> that will be performed before the popup is presented.</param>
+	/// <param name="canBeDismissedByTappingOutsideOfPopup">A <see cref="bool"/> indicating whether the <see cref="CommunityToolkit.Maui.Core.IPopup"/> can be dismissed by tapping outside of it.</param>
+	/// <param name="resultWhenUserTapsOutsideOfPopup">An <see cref="object"/> that will be returned when the user taps outside of the <see cref="CommunityToolkit.Maui.Core.IPopup"/>.</param>
+	/// <param name="verticalOptions">The vertical alignment of the <see cref="CommunityToolkit.Maui.Core.IPopup"/>.</param>
+	/// <param name="horizontalOptions">The horizontal alignment of the <see cref="CommunityToolkit.Maui.Core.IPopup"/>.</param>
+	/// <param name="size">The size of the <see cref="CommunityToolkit.Maui.Core.IPopup"/>.</param>
+	/// <param name="color">The background color of the <see cref="CommunityToolkit.Maui.Core.IPopup"/>.</param>
 	/// <param name="token"><see cref="CancellationToken"/> </param>
-	Task<object?> ShowPopupAsync<TViewModel>(Action<TViewModel> onPresenting, CancellationToken token = default) where TViewModel : INotifyPropertyChanged;
-
-	/// <summary>
-	/// Resolves and displays a <see cref="CommunityToolkit.Maui.Core.IPopup"/> and <typeparamref name="TViewModel"/> pair that was registered with <c>AddTransientPopup</c>.
-	/// </summary>
-	/// <typeparam name="TViewModel">The type of the view model registered with the <see cref="CommunityToolkit.Maui.Core.IPopup"/>.</typeparam>
-	/// <param name="viewModel">The view model to use as the <c>BindingContext</c> for the <see cref="CommunityToolkit.Maui.Core.IPopup"/>.</param>
-	/// <param name="token"><see cref="CancellationToken"/> </param>
-	/// <returns>A <see cref="Task"/> that can be awaited to return the result of the <see cref="CommunityToolkit.Maui.Core.IPopup"/> once it has been dismissed.</returns>
-	[Obsolete("This method will be removed in an upcoming version. Use ShowPopupAsync<TViewModel> instead.")]
-	Task<object?> ShowPopupAsync<TViewModel>(TViewModel viewModel, CancellationToken token = default) where TViewModel : INotifyPropertyChanged;
+	Task<object?> ShowPopupAsync<TViewModel>(
+		Action<TViewModel> onPresenting,
+		bool canBeDismissedByTappingOutsideOfPopup = true,
+		object? resultWhenUserTapsOutsideOfPopup = default,
+		LayoutAlignment verticalOptions = LayoutAlignment.Center,
+		LayoutAlignment horizontalOptions = LayoutAlignment.Center,
+		Size size = default,
+		Color? color = default,
+		CancellationToken token = default) where TViewModel : INotifyPropertyChanged;
 }