The Popups plugin provides an extremely lightweight framework for implementing Popup Pages using the Rg.Plugin.Popup package with Prism.Forms. To do this we simply provide you with some friendly extensions for the INavigationService so that you can navigate in a Prism friendly manner. Note that this does not currently support deep linking.
| Package | Version |
|---|---|
| Prism.Plugin.Popups.Autofac | |
| Prism.Plugin.Popups.DryIoc | |
| Prism.Plugin.Popups.Ninject | |
| Prism.Plugin.Popups.Unity |
Version 2.X deprecates the use of all but the ClearPopupStackAsync extension method. You can now register a PopupNavigationService which uses the base Prism PageNavigationService and adds support for Pushing and Popping PopupPage's. To use the PopupNavigationService see the registration example below for the DI container of your choice.
protected override void RegisterTypes()
{
var builder = new ContainerBuilder();
builder.RegisterPopupNavigatioService();
builder.UpdateContainer( Container );
}protectd override void RegisterTypes()
{
Container.RegisterPopupNavigationService();
}It's worth noting that there is a generic overload for the registration method that accepts any type that inherits from PopupPageNavigationServiceBase in the event that you have custom logic you need to execute in the NavigationService.
There are three primary extensions added for working with Navigation.
- ClearPopupStackAsync
- PopupGoBackAsync (Obsolete in v2.X)
- PushPopupPageAsync (Obsolete in v2.X)
All three of these contain overloads so that you can pass in a NavigationParameters object, or if you have a single key value pair you can pass it in as shown below for the NavigateCommand.
public class MyPageViewModel : BindableBase
{
INavigationService _navigationService { get; }
public MyPageViewModel( INavigationService navigationService )
{
_navigationService = navigationService;
NavigateCommand = new DelegateCommand( OnNavigateCommandExecuted );
GoBackCommand = new DelegateCommand( OnGoBackCommandExecuted );
}
public DelegateCommand NavigateCommand { get; }
public DelegateCommand GoBackCommand { get; }
private async void OnNavigateCommandExecuted()
{
await _navigationService.PushPopupPageAsync( "SomePopupPage", "message", "hello from MyPage" );
}
private async void OnGoBackCommandExecuted()
{
await _navigationService.PopupGoBackAsync();
}
}