tiagobigotto / prism.plugin.popups

This provides extensibility for Prism.Forms INavigationService to handle Popup Views

Prism.Plugin.Popups

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	MyGet
Prism.Plugin.Popups.Autofac
Prism.Plugin.Popups.DryIoc
Prism.Plugin.Popups.Ninject
Prism.Plugin.Popups.Unity

Symbols

Builds are now generated with a symbols package. This will allow users to better debug code when using our symbol server feed. Packages published to NuGet prior to (and including) 2.0.0-pre2 do not have symbols available. You can add the following Symbol Server for all Prism Plugins.

https://www.myget.org/F/prism-plugins/symbols/

Support

If this project helped you reduce time to develop and made your app better, please help support this project.

Usage

Version 2.X

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.

Because 2.X simply uses INavigationService one of the benefits you will get is support for Deep Linking like shown here:

NavigationService.NavigateAsync("MainPage/PopupPageA/PopupPageB");

Autofac

protected override void RegisterTypes()
{
    Builder.RegisterPopupNavigatioService();
}

All other containers

protected 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. The RegisterPopupNavigationService method will also register IPopupNavigation if it has not yet been registered.

Version 1.X

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();
    }
}