Files
frontend-bootcamp/step2-05/demo/README.md
2019-03-03 09:31:59 -08:00

4.1 KiB

Step 2.5 - Redux: The Store (Demo)

Lessons | Exercise | Demo

In this step, we will look at solving the problems of complex application (as mentioned in Step 4) with a library called Redux.

  1. Introduction to Redux
  2. Why Use Redux?
  3. Creating the Redux store
  4. Writing reducers
  5. Dispatching actions

Introduction to Redux

As a reminder, the problem that we want to address are:

  1. Data needs to be passed down from component to component via props. Even when some components do not need to know about some data.
  2. There is a lack of coordination of changes that can happen to the data

Redux is an implementation of the Flux architectural pattern:

Flux Diagram

View

A view is a React component that consumes the store as its data.

Action

Actions are serializable JSON messages that represent some event, such as a user's action or a network request. With the aid of reducers, they affect the overall state. At the minimum, it should contain a type key. Sometimes it contains additional data as a payload.

Store

The store consists of a state tree, a dispatcher, and reducers.

  1. The state tree is a singleton, serializable, immutable json data. It is updated from one snapshot to another through reducers.

  2. The dispatcher accepts actions passing them to the reducers.

  3. Reducers are functions that take in the current state tree and an action, producing the next snapshot of the state tree.

Why Use Redux?

There are lots of alternatives available, but here are some really good reasons to go with Redux:

  1. For more complex applications, Flux pattern forces code to be written in a way that is easy to reason about
  2. There maybe a need to serialize the application state to be transmitted across the wire somehow
  3. Dev tooling is really amazing
  4. Popularity of the framework means the ecosystem is mature at this point

Creating the Redux store

The createStore() function is provided by Redux and can take in several arguments. The simplest form just takes in reducers.

const store = createStore(reducer, initialState);

createStore() creates a store with a reducer, and some initial state.

Writing Reducers

We will write our reducers with the help of some utilities from redux-starter-kit. Here is how we will write our reducers:

1. Organize reducers according to the keys of the state tree object:

import { createReducer } from 'redux-starter-kit';

const todosReducer = createReducer({}, {
  // first argument is the initial state
  // second argument is an object where the keys corresponds to the "action.type"
  addTodo: (state, action) => ...
});

const filterReducer = createReducer('all', {
  setFilter: (state, action) => ...
});

const reducer = combineReducer({
  todos: todosReducer,
  filter: filterReducer
})

2. Write the reducers with mutables.

createReducer() will automatically translate all the mutations to the state into immutable snapshots (!!!!!):

const todosReducer = createReducer(
  {},
  {
    // first argument is the initial state
    // second argument is an object where the keys corresponds to the "action.type"
    addTodo: (state, action) => {
      state[action.id] = { label: action.label, completed: false };
    }
  }
);

Dispatching Actions

Dispatching action will pass the action and the current state to the reducers. The root reducer will produce a new snapshot for the entire state tree. We can inspect the affected snapshot with the help of getState().

const store = createStore(reducer, initialState);
store.dispatch({ type: 'addTodo', label: 'hello' });
store.dispatch({ type: 'addTodo', label: 'world' });
console.log(store.getState());

Creating these action messages by hand is tedious, so we use action creators to do that:

const actions = {
  addTodo = (label: string) => ({ label, id: nextId(), completed: false })
};

store.dispatch(actions.addTodo('hello'));