Skip to content
Unity3D uGUI mvvm databinding via the standard IXChanged interfaces used in wpf (INotifyPropertyChanged, INotifyCollectionChanged, etc)
Branch: master
Clone or download
Latest commit 4ef8f2c Jul 9, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src Merge pull request #12 from AdamMitchell-ms/u/adam/scopes Jul 8, 2019
.gitattributes git settings, unity folder setup Aug 24, 2015
.gitignore ignore weird .vs cache stuff Feb 21, 2018
LICENSE Update LICENSE Aug 27, 2015
README.md Update README.md Aug 28, 2015

README.md

ugui-mvvm

Unity GUI (the new one) databinding done via the standard INotifyPropertyChanged/INotifyCollectionChanged interfaces that are used in WPF applications.

Basic Use

There are two ways to create your viewmodels:

  • As MonoBehaviour-derived components
  • As POCOs, bound to via DataContext and CommandBinding components

Opening the example scene will show a mix of the ways the binding works

As a reminder, both ways require implementing INotifyPropertyChanged to work. To greatly reduce INPC workload, it is recommended you use UnityFody with the PropertyChanged plugin.

Referencing components in the binding fields.

As referencing specific components on other objects in unity is pretty much impossible, There is a new menu item that can be accessed by clicking on any component's gear icon -> 'Copy Component Reference'. This will then cause a small square button to the right of component fields of INPCBinding and CommandBinding to show up. Pressing this button will then paste the reference to the component into the field. example

Binding

Databinding

All databinding is done through the INPCBinding component. One component is needed per bound property.

  • MonoBehaviour viewmodels can be directly referenced in the INPCBinding component. DataBinding to MonoBehaviour example
  • POCOs are referenced via their instance in the DataContext component (assign the DataContext component to the INPCBinding viewmodel component field)

INPCBinding recognizes when a DataContext component is referenced as a viewmodel, and will display the DataContext's referenced type's properties, instead of the DataContext's type properties.

Converters

Converters work off of ScriptableObject child classes implementing IValueConverter. Assign the asset of the scriptableobject (you'll need a separate tool to help you to create them) to the Converter field of INPCBinding

Command binding

Command binding is only necessary if you're using DataContext. Otherwise, you can just do normal binding on the button's events to the viewmodel. Command binding is via properties returning ICommand, just like with WPF.

ICommand's CanExecute and CanExecuteChanged will cause the CommandBinding to modify the view's 'interactable' property (from type Selectable). This is shown in both example scenes with the 'Can Toggle' and 'Can Say Something' toggles. CommandBinding to POCO DataContext example

Collections

Collections can be done via ItemsControl components. The viewmodel collection must be an IEnumerable, with optionally implementing INotifyCollectionChanged.

Because the event binding gets set up at compile time, as well as it being harder to create UnityEngine.Object types (cannot simply new()), it is recommended you use POCOs as collection items. ItemsControl example

You can’t perform that action at this time.