Blazor MVVM Sample for CommunityToolkit.Mvvm using Blazing.Mvvm

[!IMPORTANT] *Merged into Blazing.MVVM repo

This repo is no longer maintained.

I released the Blazing.MVVM library that enables Blazor to use the CommunityToolkit.Mvvm with minimal effort. It also incldes Navigation by ViewModel (class/interface) - no more magic strings!

Whilst the repo contains a basic sample project showing how to use the library, I wanted to include a sample that takes an existing project for a different application type and, with minimal changes, make it work for Blazor. So I have taken Microsoft's Xamarin Sample Project and converted it to Blazor.

Changes made to Xamarin Sample for Blazor

The MvvmSample.Core project remains mostly unchanged, I've added base classes to the ViewModels to enable Blazor binding updates.

So, as an example, the SamplePageViewModel was changed from:

public class MyPageViewModel : ObservableObject
{
    // code goes here
}

to:

public class MyPageViewModel : ViewModelBase
{
    // code goes here
}

The ViewModelBase wraps the ObservableObject class. No other changes required.

For the Xamarin Pages, wiring up the DataContext is done with:

BindingContext = Ioc.Default.GetRequiredService<MyPageViewModel>();

With Blazing.MVVM, it is simply:

@inherits MvvmComponentBase<MyPageViewModel>

Lastly, I have updated all of the documentation used in the Sample application from Xamarin-specific to Blazor. If I have missed any changes, please let me know and I will update.

Components

Xamarin comes with a rich set of controls. Blazor is lean in comparison. To keep this project lean, I have included my own ListBox and Tab controls - enjoy! When I have time, I will endeavor to complete and release a control library for Blazor.

WASM + New WPF & Avalonia Blazor Hybrid sample applications

I have added new WPF/Avalonia Hybrid apps to demonstrate Calling into Blazor from WPF/Avalonia using MVVM. To do this, I have:

• moved the core shared parts from the BlazorSample app to a new RCL (Razor Class Library)
• Moved the Assets to a standard Content folder as the wwwroot is no longer accessable. The BlazorWebView host control uses ip address 0.0.0.0 which is invalid for the httpClient.
• Added new FileService class to the WPF/Avalonia app to use the File class and not the HttpClient.
• Added a new App.Razor to the WPF/Avalonia app for custom Blazor layout and hook the shared state for handling navigation requests from WPF/Avalonia

To enable the calling into the Blazor app, I have used a static state class to hold a reference to the NavigationManager and MvvvmNavigationManager classes.

Summary

I have kept the code as close to the original solution as possible. Blazor does not have a rich data binding system, so there as small variations to the original code, however no huge changes made. Most of the work is handled by the Blazing.MVVM library.

Download the project, run it, and compare with the original.

Updates

v1.0.0 10 May, 2023

• Initial release.

v1.1.0 26 July, 2023

• Added Wpf & Avalonia sample Blazor Hybrid Apps

v1.4.0 21 November, 2023

• Updated to .Net 8.0

Support

If you find this library useful, then please consider buying me a coffee ☕.