react-native-reactive

react-native-reactive

React Native Reactive Model-View using react-native-router-flux and Reactive Programming

What is it?

It is alternative to Redux. Redux is great, but you have to code a lot of boilerplate to use it:

• create string actions constants for each action
• build bulky switch statements within your reducers
• connect each component to redux or create componentShouldUpdate to prevent re-rendering each state change (i.e. define minimal necessary 'sub-state' of your state which is necessary for your component).
• import action constants and call quite bulky this.props.dispatch({type:ACTION_CONSTANT, ...data}) for action.

Reactive Model-View is similar to Model-View-Intent from Cycle.JS or MVC-Reactivated and mostly based on Calmm-JS, slides.

Introduction to Reactive Programming

Instead of creation of reducers/actions you have to create Reactive Model, aka "Reactive State" using supported reactive library (Kefir/Bacon). Everything could be represented as event stream or Observables. To represent your store Calmm-JS introduces Atom, Observable 'property' which easily could be set/get from your React Components. You could consider Atom as replacement of your Redux Store and Obserables (that observe your Atom(s)) are replacements of reducers.

React Native Router Flux is used to connect your Reactive Model and your React components. It wraps each component Scene with special wrapper that replaces all observables to their actual values. Once any passed observable changes, the component will be re-rendered with new values. Note that you could pass only needed sub-state of your Atom(s) using Partial Lenses to avoid needless re-rendering of the components.

How to use it?

This component is just thin wrapper around react-native-router-flux (RNRF), so just import it instead of RNRF.

Example of reactive model counter:

Example.js:

import React from 'react';
import {Router, Scene} from 'react-native-reactive';

// view and model for Counter scene
import Counter from './components/Counter';
import {increase, decrease, counter, total} from './model/counter';

export default () =>
  <Router>
    <Scene key="launch" component={Counter} hideNavBar {...{increase, decrease, counter, total}}/>
  </Router>

counter.js (reactive model)

import Atom from 'kefir.atom';

// our simplest store ever - counter
export const counter = Atom(0).log("counter");

export function increase(){
  counter.modify(x=>x+1);
}

export function decrease(){
  counter.modify(x=>x-1);
}

// example of 'computed' value = number of total operations
export const total = counter.scan((prev, next) => prev + 1, -1);

Counter.js (view)

import React from 'react';
import {
  View,
  Text,
  TouchableOpacity,
  StyleSheet
} from 'react-native';
import Button from 'react-native-button';

const Counter = (model) =>
  <View style={styles.container}>
    <Text style={styles.welcome}>
      Welcome to React Native Reactive!
    </Text>
    <Text>Counter: {model.counter}</Text>
    <Text>Total clicks: {model.total}</Text>
    <Button onPress={model.increase}>+</Button>
    <Button onPress={model.decrease}>-</Button>
  </View>

const styles = StyleSheet.create({
  container: {
    flex: 1,
    justifyContent: 'center',
    alignItems: 'center',
    backgroundColor: '#F5FCFF',
  },
  welcome: {
    fontSize: 20,
    textAlign: 'center',
    margin: 10,
  },
  instructions: {
    textAlign: 'center',
    color: '#333333',
    marginBottom: 5,
  },
});

export default Counter;