Mvvm.Navigation.WinUI 1.2.3

.NET 6.0 This package targets .NET 6.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package Mvvm.Navigation.WinUI --version 1.2.3                

                    
                

            
NuGet\Install-Package Mvvm.Navigation.WinUI -Version 1.2.3
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="Mvvm.Navigation.WinUI" Version="1.2.3" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add Mvvm.Navigation.WinUI --version 1.2.3                

                    
                

            
#r "nuget: Mvvm.Navigation.WinUI, 1.2.3"
#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 Mvvm.Navigation.WinUI as a Cake Addin
#addin nuget:?package=Mvvm.Navigation.WinUI&version=1.2.3

// Install Mvvm.Navigation.WinUI as a Cake Tool
#tool nuget:?package=Mvvm.Navigation.WinUI&version=1.2.3

Mvvm.Navigation

CI/CD License: MIT Discord NuGet NuGet NuGet NuGet NuGet NuGet NuGet NuGet

Provides platform independent navigation at the MVVM level and a Source Generator that automatically binds view and view models and registers this in your DI container.

🔥Features🔥

  • Uses DI to resolve your view from view model.
  • Generates an extension method for you with all your Views and ViewModels to register them in DI.
  • Does not contain custom controls, everything happens based on the attached dependency property and does not limit the user.
  • Allows forward/backward navigation like in Chrome.
  • Allows you to receive activation/deactivation events - just implement IActivatableViewModel for your ViewModel.
  • Allows you to generate a typed ViewModel property via an attribute, bound to your BindingContext and initialized from DI.
  • Supports automatic mapping between View and ViewModel based on a global attribute.
  • Allows case-by-case, attribute-based control for Views.

Usage

  1. Add .AddMvvmNavigation() call to your Host builder or IServiceCollection:
public sealed partial class App
{
    public App()
    {
        AppHost = Host
            .CreateDefaultBuilder()
            .AddMvvmNavigation()
            .Build();
    }
}
  1. Add ViewFor attribute to your views:
using Mvvm.Navigation;

[ViewFor<MainViewModel>]
public partial class MainPage : UserControl;

or assembly level attribute(nameof behavior is ignored and the full namespace is taken):

[assembly:MapViews(
    viewsNamespace: nameof(MyNamespace.Views),
    viewModelsNamespace: nameof(MyNamespace.ViewModels))]
  1. Add Navigator to your ViewModel:
public Navigator<ObservableObject> Navigator { get; }
  1. Add commands to your views(or just use Navigator from ViewModel):
<Grid>
    <Button
        Command="{Binding Navigator.NavigateByTypeCommand}"
        CommandParameter="{x:Type viewModels:BlueViewModel}"
        />
    <ContentControl mvvm:Properties.Navigator="{Binding Navigator}"/>
</Grid>

Tip: you can use CommandParameter="{mvvm:Type Type=viewModels:BlueViewModel}" for WinUI/UWP/Uno platforms.

Base

The library was written as a replacement for ReactiveUI in a real project, and inherits some concepts from it, excluding reactivity.
If you have the same task, then the changes are as follows:

  • Replace RoutingState with Navigator
  • Replace IScreen with INavigable
  • Replace ReactiveUserControl with UserControl
  • Replace ReactiveWindow with Window
  • Replace RoutedViewHost and ViewModelViewHost with ContentControl
  • Use mvvm:Properties.ViewModel and mvvm:Properties.Resolver/mvvm:Properties.Navigator(includes resolver) attached dependency properties.

Support

Priority place for bugs: https://github.com/HavenDV/Mvvm.Navigation/issues
Priority place for ideas and general questions: https://github.com/HavenDV/Mvvm.Navigation/discussions
I also have a Discord support channel:
https://discord.gg/g8u2t9dKgE

Product Compatible and additional computed target framework versions.
.NET net6.0-windows10.0.17763 is compatible.  net7.0-windows was computed.  net7.0-windows10.0.17763 is compatible.  net8.0-windows was computed.  net9.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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.5.1 157 3/5/2024
1.5.0 133 3/4/2024
1.4.5 213 12/4/2023
1.4.4 137 12/4/2023
1.4.3 129 12/4/2023
1.4.1 130 12/3/2023
1.4.0 126 12/3/2023
1.3.0 136 12/1/2023
1.2.7 226 9/22/2023
1.2.6 183 9/22/2023
1.2.5 200 9/21/2023
1.2.4 167 9/16/2023
1.2.3 182 9/16/2023
1.2.2 217 9/14/2023
1.2.1 217 9/14/2023
1.2.0 203 9/14/2023
1.1.3 220 9/11/2023
1.1.2 206 9/11/2023
1.1.1 202 9/7/2023
1.1.0 230 9/5/2023
1.0.1 233 9/4/2023
1.0.0 233 9/3/2023
0.2.0 225 9/3/2023
0.1.0 243 9/2/2023

⭐ Last 10 features:
- feat: Added BeforeInitializeComponent/AfterInitializeComponent partial methods when generating constructors. Fixed ViewModel init order. 2023-09-14
- feat: Now you can implement IActivatable for window/control and it will work. 2023-09-14
- feat: Implemented assembly:MapViews attribute. 2023-09-05
- feat: Added Activation support. 2023-09-04
- feat: Added separate property for InitializeComponent constructor. 2023-09-03
- feat: Released 0.2.0. 2023-09-03
- feat: Added Type markup extension. 2023-09-03
- feat: Added Properties.ViewModelType. 2023-09-02
- feat: Added HostApplicationBuilderExtensions. 2023-09-02
- feat: Removed Ioc.Default from main code. 2023-09-02

🐞 Last 10 bug fixes:
- fix: Fixed issue with combined MapViews and ViewFor. 2023-09-16
- fix: Added try to resolve IResolver from Ioc.Default. 2023-09-15
- fix: Fixed ambiguities with resolver. 2023-09-14
- fix: Generated ViewModel property can be null now. 2023-09-12
- fix: Fixed problems with DependencyPropertyGenerator. 2023-09-11
- fix: Fixed "An expression is too long or complex to compile" in big projects. 2023-09-07
- fix: Fixed "An expression is too long or complex to compile" in big projects. 2023-09-07
- fix: Fixed MAUI bug without ViewFor attributes. 2023-09-05
- fix: Now Navigator is transient by default 2023-09-04
- fix: Fixed Properties logic. 2023-09-04