Mvvm.Navigation.Maui 1.4.1

.NET 8.0 This package targets .NET 8.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.Maui --version 1.4.1                

                    
                

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

                    
                

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

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

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 constructors for your views(optional).
  • 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.ServiceProvider/mvvm:Properties.Navigator(includes ServiceProvider) 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 net8.0 is compatible.  net8.0-android was computed.  net8.0-android34.0 is compatible.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-ios17.0 is compatible.  net8.0-maccatalyst was computed.  net8.0-maccatalyst17.0 is compatible.  net8.0-macos was computed.  net8.0-tizen8.0 is compatible.  net8.0-tvos was computed.  net8.0-windows was computed.  net8.0-windows10.0.19041 is compatible.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos 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 1,450 3/5/2024
1.5.0 124 3/4/2024
1.4.5 586 12/4/2023
1.4.4 166 12/4/2023
1.4.3 143 12/4/2023
1.4.1 160 12/3/2023
1.4.0 146 12/3/2023
1.3.0 166 12/1/2023
1.2.7 277 9/22/2023
1.2.6 200 9/22/2023
1.2.5 245 9/21/2023
1.2.4 256 9/16/2023
1.2.3 250 9/16/2023
1.2.2 259 9/14/2023
1.2.1 269 9/14/2023
1.2.0 282 9/14/2023
1.1.3 256 9/11/2023
1.1.2 259 9/11/2023
1.1.1 272 9/7/2023
1.1.0 266 9/5/2023
1.0.1 302 9/4/2023
1.0.0 256 9/3/2023
0.2.0 274 9/3/2023
0.1.0 280 9/2/2023

⭐ Last 10 features:
- feat: Replaced Resolver with ServiceProvider extension. 2023-12-03
- feat: Released 1.3.0. 2023-12-01
- feat(apps): Updated Uno app. 2023-11-30
- feat: Updated to net8.0. 2023-11-08
- 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

🐞 Last 10 bug fixes:
- fix: Fixed problems with Avalonia. 2023-12-04
- fix: Properties now is static class. 2023-12-04
- fix: Fixed Tizen. 2023-11-16
- fix: Fixed. 2023-11-16
- fix: Fixed WinUI build. 2023-11-16
- fix: Fixed Package versions. 2023-11-16
- fix: Fixed WinUI project. 2023-11-13
- fix: Fixed issues with DependencyPropertyGenerator. 2023-11-08
- fix: Removed Tizen for now. 2023-11-01
- apps(Uno): Removed ContentControl fixed size. 2023-09-22