Adding Navigation Builder

[dansiegel]

Description

Fluent builders can be extremely helpful and on top of Prism's URI navigation. This unlocks a lot of possibilities for dynamically building a URI from adding query parameters to individual segments, to ViewModel first navigation. The Builders are finalized with a Navigate call which can be easily used whether or not you're in an async method. The overloads additionally make it easy to invoke callback logic OnSuccess or OnError.

// Shown with option OnError callback
navigationService.CreateBuilder()
                .AddNavigationSegment("MainPage")
                .AddNavigationPage()
                .AddNavigationSegment<ViewAViewModel>()
                .AddNavigationSegment("ViewB")
                .Navigate(HandleNavigationError);

// This returns the INavigationResult... 
// Also available with overloads to provide OnSuccess & OnError callbacks
navigationService.CreateBuilder()
                .AddTabbedSegment(b =>
                {
                    b.CreateTab(t => t.AddNavigationSegment<ViewAViewModel>())
                     .CreateTab("ViewB")
                     .CreateTab(t => t.AddNavigationPage().AddNavigationSegment<ViewCViewModel>())
                     .SelectTab<ViewBViewModel>();
                })
                .NavigateAsync();