philipp2604.WpfNavigation 1.1.0

dotnet add package philipp2604.WpfNavigation --version 1.1.0                
NuGet\Install-Package philipp2604.WpfNavigation -Version 1.1.0                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="philipp2604.WpfNavigation" Version="1.1.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add philipp2604.WpfNavigation --version 1.1.0                
#r "nuget: philipp2604.WpfNavigation, 1.1.0"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install philipp2604.WpfNavigation as a Cake Addin
#addin nuget:?package=philipp2604.WpfNavigation&version=1.1.0

// Install philipp2604.WpfNavigation as a Cake Tool
#tool nuget:?package=philipp2604.WpfNavigation&version=1.1.0                

WpfNavigation

License: MIT build and test GitHub Release NuGet Version

Description

This library allows for simple adding of navigation regions to WPF applications.

This means, you can navigate to different views (optionally with view models) in ContentControls.

Download

You can acquire this library either directly via the NuGet package manager or by downloading it from the NuGet Gallery.

Quick Start

I recommend having a look at the example project.

  1. Prepare your existing view by adding a ContentControl and registering it to the RegionNavigationService with a specific region key.

    • Registration of regions can be done by calling RegionNavigationService.RegisterRegion(_YourRegionKey_, _YourContentControl_)
    • Or by using the NavigationService.NavigationRegion="_YourRegionKey_" property inside the ContentControl's xaml.
  2. Create the views that you want to navigate to.

  3. Optionally, create view models for your views.

    • If needed, you can implement the INavigationAware interface in your view models, making them being notified when navigation occurs.
  4. Register your views and view models to the RegionContentService with a specific content key.

    • Views-only are registered by calling RegionContentService.RegisterContent<_YourViewType_>(_YourContentKey_).
    • If you want to register a view and a view model, you can call RegionContentService.RegisterContent<_YourViewType_, _YourViewModelType_>(_YourContentKey_).
  5. Done! You can now navigate to your views by simply calling RegionNavigationService.Navigate(_YourRegionKey_, _YourContentKey_).

Questions? Problems?

Feel free to reach out!

Ideas

  • Add support for more Controls (Frames, ...).

Third Party Software / Packages

Please have a look at THIRD-PARTY-LICENSES for all the awesome packages used in this library.

License

This library is MIT licensed.

Product Compatible and additional computed target framework versions.
.NET net8.0-windows7.0 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net8.0-windows7.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.1.0 92 8/15/2024
1.0.1 92 8/14/2024
1.0.0 90 8/14/2024

Initial release but with updated package definition.