https://github.com/MugenMvvmToolkit/MugenMvvmToolkit

https://github.com/MugenMvvmToolkit/MugenMvvmToolkit

Last synced: 3 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/MugenMvvmToolkit/MugenMvvmToolkit
• Owner: MugenMvvmToolkit
• License: ms-pl
• Created: 2014-08-07T15:55:11.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2022-06-30T13:55:38.000Z (over 2 years ago)
• Last Synced: 2024-07-08T05:37:26.977Z (4 months ago)
• Language: C#
• Size: 72.3 MB
• Stars: 161
• Watchers: 16
• Forks: 31
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: license.txt

Awesome Lists containing this project

• awesome-xamarin - MugenMvvmToolkit ★127 - Cross-platform MVVM toolkit. (MVVM)

README

        
[![MugenMvvmToolkit](https://raw.githubusercontent.com/MugenMvvmToolkit/MugenMvvmToolkit/master/logo_horizontal.png)](https://github.com/MugenMvvmToolkit/MugenMvvmToolkit)

----------

Mugen MVVM Toolkit makes it easier to develop cross-platform application using the Model-View-ViewModel design pattern. The Mugen MVVM Toolkit makes extensive use of Net Standard Library to provide maintainable cross platform C# native applications.

The Mugen MVVM Toolkit provides a cross-platform MVVM development framework built on top of:

 - WinForms

 - WPF

 - Xamarin.Android

 - Xamarin.iOS

 - Xamarin.Forms

 - UWP

 

# Questions & support

We have a [group on Slack](https://join.slack.com/t/mugenmvvmtoolkit/shared_invite/enQtNzYxMzExNzg4OTI4LWUxOTVjZDhkODUwZjEwNjJiOWUzM2E0OGE1ZThhYTY5MTgzOTA5MjY1MTY5NzI2YWQ4NDg3ODQxNmM5NTBkNzc) where we will be glad to answer your questions.

# Documentation

Please chek out MugenMvvmToolkit [documentation](https://mugenmvvmtoolkit.readme.io/docs).

# Links

 - [Nuget](http://www.nuget.org/packages?q=MugenMvvmToolkit)

 - [Samples](https://github.com/MugenMvvmToolkit/MugenMvvmToolkit.Samples)

 - [MugenMvvmToolkit.Fody plugin repository](https://github.com/MugenMvvmToolkit/MugenMvvmToolkit.Fody)

# Features

The MVVM framework includes the following features that differs this project from other frameworks:

 - Deep integration with each platform.

 - Supports state preservation and restoration for mobile platforms.

 - Full Fragment support for Android, you do not need to worry about activity, fragments, sub-fragments or their state all this makes the framework.

 - Solves the nested user controls problem in MVVM, all view models are dynamically created by you, using the `GetViewModel` and `GetViewModel` methods and you do not need to use the `ViewModelLocator`.

 - Supports all kinds of navigation like modal window, page navigation, tab navigation, back stack fragment navigation for android. You can also easily add a new kind of navigation.

 - Navigation system works with view models and allows to expect the completion of the operation. You can pass any parameters between view models. 

# Installation

Under Visual Studio you can use [NuGet Package Manager](https://www.nuget.org/) to get MugenMvvmToolkit.

To start developing under **iOS, Android, UWP** platforms use:

```

PM> Install-Package MugenMvvmToolkit.StarterPack

```

To start developing under **WPF**  use:

```

PM> Install-Package MugenMvvmToolkit.StarterPack.WPF

```

To start developing under **Windows Forms**  use:

```

PM> Install-Package MugenMvvmToolkit.StarterPack.WinForms

```

# Navigation example

An example of how the navigation looks in other frameworks:

```csharp

Navigate(new DetailParameters() { Index = 2 });

```

 An example of how the navigation looks in MugenMvvmToolkit:

```csharp

using (var editorVm = GetViewModel())            

{

   var productModel = new ProductModel { Id = Guid.NewGuid() };

   editorVm.InitializeEntity(productModel, true);

   if (!await editorVm.ShowAsync())

	   return;

   //Code that will be called after the completion of navigation, and yes, this code will be executed even if the application had been tombstoned and then restored.

}

```

*For UWP you should install the [MugenMvvmToolkit.Fody](http://www.nuget.org/packages/MugenMvvmToolkit.Fody/) plugin to support async operation restore.*

 - Good design mode support, for xaml platforms supports the creation of design view model with any constructor parameters.

 - Supports bindings on all platforms, all of the native binding features available for WPF platform available on all platforms and even more.

 - Binding supports C# language expressions like Linq, Extension methods, method call, ternary operator (?:), coalescing operator (??), null conditional operator (?.) etc.

`(Text Items.First(x => x == Name).Value), (Text $string.Format('{0} {1}', Prop1, Prop2))`.

 - Supports subscription to any control event.

 `(TextChanged ViewModelMethod($args)), (DoubleClick Command)`.

 - Built-in support for validation. 

`(Text Prop1, Validate=True), (Text $GetErrors(Prop1).FirstOrDefault())`

 - You can easily write their own extensions for bindings.

  `(Text $i18.MyLocalizableString), (Text $MyCustomMethod(Prop1))`.

 - Supports attached members (properties, events, methods), you can extend any object as you want.

 - Special editor for WinForms, you do not need to write code to create bindings.

 - Binding parser builds syntax tree that allows you to easily change or extend the bindings, without manipulation of the raw text.

 - Binding supports fluent syntax.

 - Excellent binding performance.