equadrat.Framework.Mvvm
6.4.4
Prefix Reserved
See the version list below for details.
dotnet add package equadrat.Framework.Mvvm --version 6.4.4
NuGet\Install-Package equadrat.Framework.Mvvm -Version 6.4.4
<PackageReference Include="equadrat.Framework.Mvvm" Version="6.4.4" />
paket add equadrat.Framework.Mvvm --version 6.4.4
#r "nuget: equadrat.Framework.Mvvm, 6.4.4"
// Install equadrat.Framework.Mvvm as a Cake Addin #addin nuget:?package=equadrat.Framework.Mvvm&version=6.4.4 // Install equadrat.Framework.Mvvm as a Cake Tool #tool nuget:?package=equadrat.Framework.Mvvm&version=6.4.4
equadrat Framework Mvvm
The idea of the equadrat Framework is to provide APIs to build applications with an architecture of highly decoupled components. Every single component, aspect or pattern is represented by interfaces. The framework provides a standard implementation for these but each type can be replaced by a custom implementation.
The framework is not about reimplementing components, but making them available using common interfaces.
Getting started
You can use most of the components by simply instantiating them. This is maybe the easiest way to evaluate the framework.
If you're using an IOC/DI container such as Microsoft Extensions DependencyInjection or if you want to use the built-in IOC framework, you can use the bootstrapper and bootstrapper modules to register the framework to the IOC.
Usage
The only requirement for view models is to implement INotifyPropertyChanged.
Have a look at the example applications on my website: www.equadrat.net
Interesting components
This is a list of some (not all) components of the framework which might be interesting for you.
MVVM code generator
- MvvmGeneratePropertyAttribute
- Requires partial class
- Requires MvvmViewModel base class
- Use PropertyName & PropertyType to generate a property
- Use DeclarationType to generate all properties of the specified type of interface
MVVM data container & helper
- IMvvmDataContainerFactory
- MvvmHelper
MVVM shell & navigation
- IMvvmShellService
- IMvvmNavigationService
MVVM views
- IMvvmView
- IMvvmViewFactory
- IMvvmViewRegistry
MVVM view models
- MvvmViewModel (optional to use)
- Base implementation for view models
- Event implementation
- Creates a data container.
MVVM behaviors
- MvvmViewModelPresenterBehavior
- Creates the view for the assigned view model (context) of the current control.
- MvvmViewModelProviderBehavior
- Creates a view model and binds it to the control (context).
- MvvmViewModelVisibilityBehavior
- Synchronizes the view model "visibility" with the visibility of the current control.
Platforms
The MVVM implementation itself is platform agnostic, but there are supporting integrations for some major client GUI frameworks.
Compatibility
The plan is to keep the equadrat Framework compatible to these .net versions as long as possible.
.net version | min | max |
---|---|---|
Core | 3.1 | ≥ 8.x |
Standard | 2.0 | ≥ 2.1 |
Framework | 4.6.2 | ≥ 4.8.x |
Version scheme and breaking changes
Version change | Scope |
---|---|
Major | Overhaul of the project |
Minor | Some types have changed |
Revision | Fully backward compatible |
Build | Set in preview versions only |
Additional documentation
You can find some guides regarding specific features on my website: www.equadrat.net
Feedback
You can contact me on my website: www.equadrat.net
License
Please respect the license and check equadrat.Framework.Mvvm.License.md before using the package.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 is compatible. net5.0-windows was computed. net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 is compatible. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 is compatible. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- equadrat.Framework.Core (>= 6.4.4)
- equadrat.Framework.Core.Interfaces (>= 6.4.4)
- equadrat.Framework.Mvvm.Interfaces (>= 6.4.4)
- Microsoft.Bcl.HashCode (>= 1.1.1)
-
.NETStandard 2.1
- equadrat.Framework.Core (>= 6.4.4)
- equadrat.Framework.Core.Interfaces (>= 6.4.4)
- equadrat.Framework.Mvvm.Interfaces (>= 6.4.4)
-
net5.0
- equadrat.Framework.Core (>= 6.4.4)
- equadrat.Framework.Core.Interfaces (>= 6.4.4)
- equadrat.Framework.Mvvm.Interfaces (>= 6.4.4)
-
net6.0
- equadrat.Framework.Core (>= 6.4.4)
- equadrat.Framework.Core.Interfaces (>= 6.4.4)
- equadrat.Framework.Mvvm.Interfaces (>= 6.4.4)
-
net7.0
- equadrat.Framework.Core (>= 6.4.4)
- equadrat.Framework.Core.Interfaces (>= 6.4.4)
- equadrat.Framework.Mvvm.Interfaces (>= 6.4.4)
-
net8.0
- equadrat.Framework.Core (>= 6.4.4)
- equadrat.Framework.Core.Interfaces (>= 6.4.4)
- equadrat.Framework.Mvvm.Interfaces (>= 6.4.4)
NuGet packages (6)
Showing the top 5 NuGet packages that depend on equadrat.Framework.Mvvm:
Package | Downloads |
---|---|
equadrat.Framework.Mvvm.SinglePageView
A framework to extend the Microsoft .net framework with extra mvvm functionality. |
|
equadrat.Framework.Mvvm.Xamarin.Forms
A framework to extend the Microsoft .net framework with extra mvvm functionality. |
|
equadrat.Framework.Mvvm.Avalonia
A framework to extend the Microsoft .net framework with extra mvvm functionality. |
|
equadrat.Framework.Mvvm.Wpf
A framework to extend the Microsoft .net framework with extra mvvm functionality. |
|
equadrat.Framework.Mvvm.Maui
A framework to extend the Microsoft .net framework with extra mvvm functionality. |
GitHub repositories
This package is not used by any popular GitHub repositories.
====
v6.4.4
====
- Generated MVVM properties are public by default when having a model specified.
- Using nameof-syntax for generated MVVM properties supports referencing generated members.
====
v6.4.3
====
- Compatibility release.
====
v6.4.2
====
- Added code generator for MVVMP properties (equadrat.Framework.Mvvm.CodeGenerator) which can be configured using MvvmGeneratePropertyAttribute.
- Added platform package to support ASP.net WebAssembly.
- Added MvvmEventTracker component for Razor/WebAssembly to call ComponentBase.StateHasChanged when specific MVVM-related events are raised by an event source.
- Added MvvmViewModelVisibilitySetter component for Razor/WebAssembly to set the visibility of a view model while it is attached to a view and reset it on detach.
====
v6.4.1
====
- Added MvvmCloseWindowBehavior for Avalonia and WPF.
- Added IMvvmViewModelOptions.HandleIsModifiedChanged to configure a changed handler for the IsModified state of a view model.
====
v6.4.0
====
- Internal refacorings to use MaybeNullWhenAttribute when applicable.
====
v6.3.3
====
- Added .net 8 support.
====
v6.3.0
====
- Compatibility release.
====
v6.2.0
====
- Compatibility release.
====
v6.1.0
====
- Compatibility release.
====
v6.0.8
====
- Compatibility release.
- Upgraded Avalonia UI NuGet package references to v11.x.
====
v6.0.7
====
- Enabled IL trimming.
- Added README.md file to the NuGet package.
====
v6.0.3
====
- Compatibility release.
====
v6.0.2
====
- Internal release.
====
v6.0.1
====
- Renamed MvvmFrameworkBootstrapperModulesSelector to MvvmFrameworkBootstrapperModuleSelector.
====
v6.0.0
====
- Initial Release