Latest 0.3
Homepage https://github.com/ReactiveCocoa/ReactiveViewModel
License MIT
Platforms ios 6.0, osx 10.8, requires ARC
Dependencies ReactiveCocoa
Authors , ,

ReactiveViewModel Carthage compatible

ReactiveViewModel is a combination code/documentation project for building Cocoa
applications using Model-View-ViewModel and
ReactiveCocoa.

By explaining rationale, documenting best practices, and providing reusable
library components, we want to make MVVM in Objective-C appealing and easy.

Model-View-ViewModel

Most Cocoa developers are familiar with the
Model-View-Controller
(MVC) pattern:

Model-View-Controller

Model-View-ViewModel
(MVVM)
is another architectural paradigm for GUI applications:

Model-View-ViewModel

Although it seems similar to MVC (except with a "view model" object in place of
the controller), there’s one major difference — the view owns the view
model
. Unlike a controller, a view model has no knowledge of the specific view
that’s using it.

This seemingly minor change offers huge benefits:

  1. View models are testable. Since they don’t need a view to do their work,
    presentation behavior can be tested without any UI automation or stubbing.
  2. View models can be used like models. If desired, view models can be
    copied or serialized just like a domain model. This can be used to quickly
    implement UI restoration and similar behaviors.
  3. View models are (mostly) platform-agnostic. Since the actual UI code
    lives in the view, well-designed view models can be used on the iPhone,
    iPad, and Mac, with only minor tweaking for each platform.
  4. Views and view controllers are simpler. Once the important logic is
    moved elsewhere, views and VCs become dumb UI objects. This makes them
    easier to understand and redesign.

In short, replacing MVC with MVVM can lead to more versatile and rigorous UI
code.

What’s in a view model?

A view model is like an adapter
for the model that makes it suitable for presentation. The view model is also
where presentation behavior goes.

For example, a view model might handle:

  • Kicking off network or database requests
  • Determining when information should be hidden or shown
  • Date and number formatting
  • Localization

However, the view model is not responsible for actually presenting
information or handling input — that’s the sole domain of the view layer. When
the view model needs to communicate something to the view, it does so through
a system of data binding.

What about view controllers?

OS X and iOS both have view (or window) controllers, which may be confusing at
first glance, since MVVM only refers to a view.

But upon closer inspection, it becomes apparent that view controllers are
actually just part of the view layer, since they handle things like:

  • Layout
  • Animations
  • Device rotation
  • View and window transitions
  • Presenting loaded UI

So, "the view" actually means the view layer, which includes view controllers.
There’s no need to have a view and a view controller for the same section of the
screen, though — just pick whichever class is easier for the use case.

No matter whether you decide to use a view or a view controller, you’ll still
have a view model.

ReactiveCocoa

MVVM is most successful with a powerful system of data
binding
.
ReactiveCocoa is one such
system.

By modeling changes as
signals, the view
model can communicate to the view without actually needing to know that it
exists (similarly for model → view model communication). This decoupling is
why view models can be tested without a view in place — the test simply needs to
connect to the VM’s signals and verify that the behavior is correct.

ReactiveCocoa also includes other conveniences that are hugely beneficial for
MVVM, like
commands,
and built-in bindings for AppKit and UIKit.

Getting Started

To build ReactiveViewModel in isolation, open ReactiveViewModel.xcworkspace. To integrate it into your project, include ReactiveViewModel.xcodeproj and ReactiveCocoa.xcodeproj and link your target against the ReactiveViewModel and ReactiveCocoa targets for your platform.

More Resources

Model-View-ViewModel was originally developed by
Microsoft, so many of the examples are specific to WPF
or Silverlight, but there are still a few resources that may be useful:

Blog posts:

Presentations:

Latest podspec

{
    "name": "ReactiveViewModel",
    "version": "0.3",
    "summary": "Model-View-ViewModel, using ReactiveCocoa.",
    "description": "ReactiveViewModel is a combination code/documentation project for building Cocoa applications using Model-View-ViewModel and ReactiveCocoa.nnBy explaining rationale, documenting best practices, and providing reusable library components, we want to make MVVM in Objective-C appealing and easy.",
    "homepage": "https://github.com/ReactiveCocoa/ReactiveViewModel",
    "license": {
        "type": "MIT",
        "file": "LICENSE.md"
    },
    "authors": {
        "Alan Rogers": "[email protected]",
        "Just Spahr-Summers": "[email protected]",
        "Josh Abernathy": "[email protected]"
    },
    "platforms": {
        "ios": "6.0",
        "osx": "10.8"
    },
    "source": {
        "git": "https://github.com/ReactiveCocoa/ReactiveViewModel.git",
        "tag": "0.3"
    },
    "source_files": "ReactiveViewModel/*.{h,m}",
    "requires_arc": true,
    "dependencies": {
        "ReactiveCocoa": [
            "~> 2.4"
        ]
    },
    "prepare_command": "find . \( -regex '.*EXT.*\.[mh]$' -o -regex '.*metamacros\.[mh]$' \) -execdir mv {} RAC{} \;nfind . -regex '.*\.[hm]' -exec sed -i '' -E '[email protected]"(EXT.*|metamacros)\.h"@"RAC\1.h"@' {} \;nfind . -regex '.*\.[hm]' -exec sed -i '' -E '[email protected]@@' {} \;n"
}

Pin It on Pinterest

Share This