Navigation

A project for key to view navigation using ReactiveUI and Flurl.

Platforms

Platform	TFM
.NET Standard 2.0	netstandard2.0
.NET 6.0	net6.0
.NET 6.0 Android	net6.0-android
.NET 6.0 WPF	net6.0-windows7.0
.NET 6.0 WinUI	net6.0-windows10.0.19041
UWP 16299	uap10.0.19041

Installation

Replace X with the version you want!

.NET CLI

dotnet add package P41.Navigation --version X

Package Reference

<PackageReference Include="P41.Navigation" Version="X" />

Getting Started

You get started by configuring the NavigationHost for a platform:

UWP

// Application (App.xaml.cs in sample)
services.AddSingleton(sp =>
    new NavigationHost()
    .Map("page1", static () => typeof(Page1))
    .Map("page2/{}", static () => new Page2()) // {} means parameter.
    .Map("page3", static () => typeof(Page3)));

// At the end of Application OnLaunched
Window.Current.Activate();
Services.Resolve<INavigationHost>().Navigate("page1/100");

Android

// Application (AndroidApp in sample)
services.AddSingleton(sp =>
    new NavigationHost()
    .Map("page1", static () => new Page1())
    .Map("page2/{}", static () => new Page2()) // {} means parameter.
    .Map("page3", static () => new Page3())
);

// Main Activity (Shell in sample) at the end of OnCreate
host.SetFragmentManager(SupportFragmentManager)
    .SetFragmentContainerId(R.Id.MainContainer)
    .Navigate("page1");

All targets plus .NET 6.0 or .NET Standard 2.0

Then from your code you call navigation methods:

// Shared ViewModel constructor
Navigate = ReactiveCommand.Create<string>(page =>
{
    this.Navigate(page);
});

GoBack = ReactiveCommand.Create<Unit>(_ =>
{
    this.GoBack());
}

You also register code to run on NavigatedTo and NavigatingFrom similar to ReactiveUI activation.

this.WhenNavigated((Flurl.Url url, CompositeDisposable d) =>
{
});

When the ViewModel is being NavigatedFrom Dispose() is called on the CompositeDisposable.

There are also samples in the samples folder that you should see and try!

Build

Install Visual Studio 2022 Preview and .NET 6.0

Clone the project and open the solution then you just build the whole solution or the specific projects/solution folder you want to build.

Contribute

Contributions are welcome and appreciated, before you create a pull request please open a GitHub Issue to discuss what needs changing and or fixing if the issue doesn't exist!