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
MIT License
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.
.AddMvvmNavigation()
call to your Host builder or IServiceCollection
:public sealed partial class App
{
public App()
{
AppHost = Host
.CreateDefaultBuilder()
.AddMvvmNavigation()
.Build();
}
}
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))]
or in .csproj:
<ItemGroup Label="Navigation">
<AssemblyAttribute Include="Mvvm.Navigation.MapViews">
<_Parameter1>nameof(MyNamespace.Views)</_Parameter1>
<_Parameter1_IsLiteral>true</_Parameter1_IsLiteral>
<_Parameter2>nameof(MyNamespace.ViewModels)</_Parameter2>
<_Parameter2_IsLiteral>true</_Parameter2_IsLiteral>
<ViewLifetime>Mvvm.Navigation.ServiceLifetime.Transient</ViewLifetime>
<ViewLifetime_IsLiteral>true</ViewLifetime_IsLiteral>
<ViewModelLifetime>Mvvm.Navigation.ServiceLifetime.Scoped</ViewModelLifetime>
<ViewModelLifetime_IsLiteral>true</ViewModelLifetime_IsLiteral>
</AssemblyAttribute>
</ItemGroup>
Default lifetime is ServiceLifetime.Transient
for View and ServiceLifetime.Scoped
for ViewModel.
3. Add Navigator to your ViewModel:
public Navigator<ObservableObject> Navigator { get; }
<Grid>
<Button
Command="{Binding Navigator.NavigateByTypeCommand}"
CommandParameter="{x:Type viewModels:BlueViewModel}"
/>
<ContentControl Content="{Binding Navigator.CurrentView}"/>
</Grid>
Tip: you can use CommandParameter="{mvvm:Type Type=viewModels:BlueViewModel}"
for WinUI/UWP/Uno platforms.
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:
mvvm:Navigation.ViewModel
and mvvm:Navigation.Navigator
(includes ServiceProvider) attached dependency properties.<ContentControl Content="{Binding Navigator.CurrentView}"/>
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