Skip to content

The small and smart MVVM framework made with ❤ for Xamarin.Forms.

License

Notifications You must be signed in to change notification settings

iamvignesh/MvvmNano

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

91 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MvvmNano

The small and smart MVVM framework made with ❤ for Xamarin.Forms.

Build Status NuGet Package
Build status NuGet version
  1. Manifesto
  2. Download
  3. Demo
  4. Getting started
  5. Data Binding
  6. Navigation
  7. Dependency Injection
  8. Cleaning up
  9. XAML Support
## Manifesto
  1. Each View (aka Page) must have its own View Model.
  2. Views know their View Models, but not vice versa: View Models never know their Views.
  3. Therefore navigation works from View Model to View Model only, without involving the View.
  4. When navigating, passing complex objects along must be possible.
  5. There should be no limits in how to present Views.
  6. View Models must be easily testable, so Dependency Injection is a basic prerequisite.
  7. Both Views and View Models must be easy to clean up.
## Download
Install-Package MvvmNano.Forms
## Demo

Just download this repo and take a look at the demo app which can be found within the /demo folder.

## Getting started

Preliminary remarks

  • MvvmNano comes as two Portable Class Libraries (PCL) with profile 78 (MvvmNano.Core and MvvmNano.Forms)
  • MvvmNano.Forms references Xamarin.Forms
  • MvvmNano.Core references Portable.Ninject

Add the NuGet package

You can add MvvmNano easily via NuGet:

Install-Package MvvmNano.Forms

Important: Add it to your Xamarin.Forms library as well as to your native app projects, so NuGet can resolve the right assemblies of the dependencies Xamarin.Forms and Portable.Ninject on each target (for example PCL, Xamarin.iOS, Xamarin.Android).

Add your first View Model and its Page

Your View Model needs to inherit from MvvmNanoViewModel<TNavigationParameter> or MvvmNanoViewModel. Let's start with the latter and thereby without a parameter.

public class LoginViewModel : MvvmNanoViewModel
{
    // ...
}

Now add the Page. Note that by convention it needs to be named after your View Model, except for the ViewModel suffix (so LoginViewModel becomes LoginPage). You also need to inherit from MvvmNanoContentPage<TViewModel>.

public class LoginPage : MvvmNanoContentPage<LoginViewModel>
{
    // ...
}

Set up your App class

Each Xamarin.Forms app has an entry point – a class called App which is derived from Application. Change that base class to MvvmNanoApplication.

You also want to tell your application the first Page and View Model which should be used when the app gets started for the first time. Put this setup inside of OnStart(), but don't forget to call base.OnStart(). This is important in order to set up the Presenter correctly (for more on that see below).

public class App : MvvmNanoApplication
{
    protected override void OnStart()
    {
        base.OnStart();

        SetUpMainPage();
    }

    private void SetUpMainPage()
    {
        var viewModel = MvvmNanoIoC.Resolve<LoginViewModel>();
        viewModel.Initialize();

        var page = new LoginPage();
        page.SetViewModel(viewModel);

        MainPage = new MvvmNanoNavigationPage(page);
    }
}

That's it!

If you now build and run your app(s), you'll see your first Page which is running with it's View Model behind. Nothing spectacular so far, but the fun is just getting started.

## Data Binding

Xamarin.Forms comes with really powerful data binding features which you're fully able to leverage with MvvmNano, so we are not reinventing the wheel here.

NotifyPropertyChanged()

MvvmNano View Models implement INotifyPropertyChanged and offer a small helper method called NotifyPropertyChanged() (without the leading I).

private string _username;
public string Username
{
    get { return _username; }
    set
    {
        _username = value;
        NotifyPropertyChanged();
        NotifyPropertyChanged("IsFormValid");
    }
}

As you can see, NotifyPropertyChanged() can be called with and without the name of the property it should be notifying about. If you leave it out, it will automatically use the name of the property you're calling it from.

(Scared from so much boilerplate code? Take a look at Fody PropertyChanged.)

BindToViewModel()

This is a small helper method baked in to MvvmNanoContentPage, which makes binding to your View Model a no-brainer when writing your views (pages) in code:

var nameEntry = new Entry
{
    Placeholder = "Your name"
};

BindToViewModel(nameEntry, Entry.TextProperty, x => x.Username);

Commands

Xamarin.Forms supports ICommand, and so does MvvmNano.

View Model:

public MvvmNanoCommand LogInCommand
{
	get { return new MvvmNanoCommand(LogIn); }
}

private void LogIn()
{
	// ...
}

Page:

BindToViewModel(loginButton, Button.CommandProperty, x => x.LogInCommand);

Commands with parameters

View Model:

public MvvmNanoCommand<string> LogInCommand
{
    get { return new MvvmNanoCommand<string>(LogIn); }
}

private void LogIn(string userName)
{
	// ...
}

Page:

BindToViewModel(loginButton, Button.CommandProperty, x => x.LogInCommand);
BindToViewModel(loginButton, Button.CommandParameterProperty, x => x.Username);
## Navigation

Navigation works from View Model to View Model only, not involving the View aka Page directly. Instead all work is delegated to a central Presenter, which is responsible for creating the Page, its View Model and also passing a parameter, if specified.

This way you can keep your application independent from the UI implementation – if you ever have to switch to Xamarin.iOS or Xamarin.Android, in parts or even completely, you don't have to throw your View Models away.

Navigation without parameter

NavigateTo<AboutViewModel>();

Navigates to AboutViewModel without passing a parameter.

Navigation with a parameter

Let's say you want to get a parameter of the type Club each time your View Model is being called. Then you have to derive from MvvmNanoViewModel<TViewModel> and make TViewModel Club.

public class ClubViewModel : MvvmNanoViewModel<Club>
{
    public override void Initialize(Club parameter)
    {
        // ...
    }
}

Overriding the Initialize() method will now make that Club being passed available after the View Model is being created.

To actually pass that parameter, navigate to your ClubViewModel from the calling View Model as follows:

NavigateTo<ClubViewModel, Club>(club);

Opening Pages modally or in a completely customized fashion

The default presenter coming with MvvmNano will push a page to the existing navigation stack. But you are completely free to customize that, so you can define on a per-View Model basis how its view should be presented (maybe displayed modally or rendered in a completely different way).

A custom presenter could look like this:

public class DemoPresenter : MvvmNanoFormsPresenter
{
    public DemoPresenter(Application app) : base(app)
    {
    }

    protected override void OpenPage(Page page)
    {
        if (page is AboutPage)
        {
            Device.BeginInvokeOnMainThread(async () =>
                await CurrentPage.Navigation.PushModalAsync(new MvvmNanoNavigationPage(page)
            ));

            return;
        }

        base.OpenPage(page);
    }
}

In order to pass every navigation request through it, you have register it within your App class:

protected override void SetUpPresenter()
{
    MvvmNanoIoC.RegisterAsSingleton<IPresenter>(
        new DemoPresenter(this)
    );
}
## Dependency Injection

Having a Initialize() or Initialize(TNavigationParameter parameter) method in your View Model comes with a benefit: the constructor is still free for parameters being automatically injected.

We're not inventing the wheel here neither, because the portable version of Ninject does a fabolous job for us behind the scenes.

In front of it there is a small static helper class called MvvmNanoIoC, which provides the following methods for registering dependencies:

  • MvvmNanoIoC.Register<TInterface, TImplementation>()
  • MvvmNanoIoC.RegisterAsSingleton<TInterface, TImplementation>()
  • MvvmNanoIoC.RegisterAsSingleton<TInterface>(TInterface instance)
  • MvvmNanoIoC.Resolve<TInterface>()

Sample: Registering a dependency

public class App : MvvmNanoApplication
{
    protected override void OnStart()
    {
        base.OnStart();

        SetUpDependencies();
    }

    private static void SetUpDependencies()
    {
        MvvmNanoIoC.Register<IClubRepository, MockClubRepository>();
    }
}

Sample: Constructor Injection

public class WelcomeViewModel : MvvmNanoViewModel
{
    public List<Club> Clubs { get; private set; }

    public WelcomeViewModel(IClubRepository clubs)
    {
        Clubs = clubs.All();
    }
}

PS: Usually you won't need the Resolve<TInterface>() method, because constructor injection works out of the box.

## Cleaning up

Cleaning up your View Models and your Views aka Pages is a must in order to prevent memory leaks. Read more about it here. Unfortunately Xamarin doesn' think that way, so their whole Xamarin.Forms framework lacks IDisposable implementations.

MvvmNano fixes that. Both MvvmNanoViewModel and MvvmNanoContentPage implement IDisposable, so you can use the Dispose() method in both to detach event handlers, dispose "heavy resources" such as images etc.

Important: In order to get that Dispose() method actually called, you must use MvvmNanoNavigationPage instead of the framework's default Navigationpage. It takes care of calling Dispose() at the right time whenever a Page is being removed from the stack.

## XAML Support

XAML is fully supported, take a look at the demo or these snippets.

View Model:

public class ClubViewModel : MvvmNanoViewModel<Club>
{
    private string _name;
    public string Name
    {
        get { return _name; }
        private set { _name = value; NotifyPropertyChanged(); }
    }

    private string _country;
    public string Country
    {
        get { return _country; }
        private set { _country = value; NotifyPropertyChanged(); }
    }

    public override void Initialize(Club parameter)
    {
        Name = parameter.Name;
        Country = parameter.Country;
    }
}

Page:

<?xml version="1.0" encoding="UTF-8"?>
<pages:MvvmNanoContentPage xmlns="http://xamarin.com/schemas/2014/forms"
    xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
    xmlns:pages="clr-namespace:MvvmNano.Forms"
    xmlns:vm="clr-namespace:MvvmNanoDemo"
    x:Class="MvvmNanoDemo.ClubPage"
    x:TypeArguments="vm:ClubViewModel"
    Title="{Binding Name}">
    <ContentPage.Content>
        <StackLayout>
            <Label Text="{Binding Country}" />
        </StackLayout>
    </ContentPage.Content>
</pages:MvvmNanoContentPage>

About

The small and smart MVVM framework made with ❤ for Xamarin.Forms.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C# 99.8%
  • Batchfile 0.2%