Redux 入門教程（3）：React-Redux 的用法

前兩篇教程介紹了 Redux 的基本用法和非同步操作，今天是最後一部分，介紹如何在 React 專案中使用 Redux。

為了方便使用，Redux 的作者封裝了一個 React 專用的庫 React-Redux，本文主要介紹它。

這個庫是可以選用的。實際專案中，你應該權衡一下，是直接使用 Redux，還是使用 React-Redux。後者雖然提供了便利，但是需要掌握額外的 API，並且要遵守它的元件拆分規範。

一、UI 元件

React-Redux 將所有元件分成兩大類：UI 元件（presentational component）和容器元件（container component）。

UI 元件有以下幾個特徵。

• 只負責 UI 的呈現，不帶有任何業務邏輯
• 沒有狀態（即不使用this.state這個變數）
• 所有資料都由引數（this.props）提供
• 不使用任何 Redux 的 API

下面就是一個 UI 元件的例子。

JavaScript

const Title = value => <h1>{value}</h1>;

1 2	const Title =   value => <h1>{value}</h1>;

因為不含有狀態，UI 元件又稱為”純元件”，即它純函式一樣，純粹由引數決定它的值。

二、容器元件

容器元件的特徵恰恰相反。

• 負責管理資料和業務邏輯，不負責 UI 的呈現
• 帶有內部狀態
• 使用 Redux 的 API

總之，只要記住一句話就可以了：UI 元件負責 UI 的呈現，容器元件負責管理資料和邏輯。

你可能會問，如果一個元件既有 UI 又有業務邏輯，那怎麼辦？回答是，將它拆分成下面的結構：外面是一個容器元件，裡面包了一個UI 元件。前者負責與外部的通訊，將資料傳給後者，由後者渲染出檢視。

React-Redux 規定，所有的 UI 元件都由使用者提供，容器元件則是由 React-Redux 自動生成。也就是說，使用者負責視覺層，狀態管理則是全部交給它。

三、connect()

React-Redux 提供connect方法，用於從 UI 元件生成容器元件。connect的意思，就是將這兩種元件連起來。

JavaScript

import { connect } from 'react-redux' const VisibleTodoList = connect()(TodoList);

1 2	import { connect } from 'react-redux' const VisibleTodoList = connect()(TodoList);

上面程式碼中，TodoList是 UI 元件，VisibleTodoList就是由 React-Redux 通過connect方法自動生成的容器元件。

但是，因為沒有定義業務邏輯，上面這個容器元件毫無意義，只是 UI 元件的一個單純的包裝層。為了定義業務邏輯，需要給出下面兩方面的資訊。

（1）輸入邏輯：外部的資料（即state物件）如何轉換為 UI 元件的引數

（2）輸出邏輯：使用者發出的動作如何變為 Action 物件，從 UI 元件傳出去。

因此，connect方法的完整 API 如下。

JavaScript

import { connect } from 'react-redux' const VisibleTodoList = connect( mapStateToProps, mapDispatchToProps )(TodoList)

1 2 3 4 5 6

import { connect } from 'react-redux'   const VisibleTodoList = connect(   mapStateToProps,   mapDispatchToProps )(TodoList)

上面程式碼中，connect方法接受兩個引數：mapStateToProps和mapDispatchToProps。它們定義了 UI 元件的業務邏輯。前者負責輸入邏輯，即將state對映到 UI 元件的引數（props），後者負責輸出邏輯，即將使用者對 UI 元件的操作對映成 Action。

四、mapStateToProps()

mapStateToProps是一個函式。它的作用就是像它的名字那樣，建立一個從（外部的）state物件到（UI 元件的）props物件的對映關係。

作為函式，mapStateToProps執行後應該返回一個物件，裡面的每一個鍵值對就是一個對映。請看下面的例子。

JavaScript

const mapStateToProps = (state) => { return { todos: getVisibleTodos(state.todos, state.visibilityFilter) } }

1 2 3 4 5

const mapStateToProps = (state) => {   return {     todos: getVisibleTodos(state.todos, state.visibilityFilter)   } }

上面程式碼中，mapStateToProps是一個函式，它接受state作為引數，返回一個物件。這個物件有一個todos屬性，代表 UI 元件的同名引數，後面的getVisibleTodos也是一個函式，可以從state算出 todos 的值。

下面就是getVisibleTodos的一個例子，用來算出todos。

JavaScript

const getVisibleTodos = (todos, filter) => { switch (filter) { case 'SHOW_ALL': return todos case 'SHOW_COMPLETED': return todos.filter(t => t.completed) case 'SHOW_ACTIVE': return todos.filter(t => !t.completed) default: throw new Error('Unknown filter: ' + filter) } }

1 2 3 4 5 6 7 8 9 10 11 12

const getVisibleTodos = (todos, filter) => {   switch (filter) {     case 'SHOW_ALL':       return todos     case 'SHOW_COMPLETED':       return todos.filter(t => t.completed)     case 'SHOW_ACTIVE':       return todos.filter(t => !t.completed)     default:       throw new Error('Unknown filter: ' + filter)   } }

mapStateToProps會訂閱 Store，每當state更新的時候，就會自動執行，重新計算 UI 元件的引數，從而觸發 UI 元件的重新渲染。

mapStateToProps的第一個引數總是state物件，還可以使用第二個引數，代表容器元件的props物件。

JavaScript

// 容器元件的程式碼 // <FilterLink filter="SHOW_ALL"> // All // </FilterLink> const mapStateToProps = (state, ownProps) => { return { active: ownProps.filter === state.visibilityFilter } }

1 2 3 4 5 6 7 8 9 10

// 容器元件的程式碼 //    <FilterLink filter="SHOW_ALL"> //      All //    </FilterLink>   const mapStateToProps = (state, ownProps) => {   return {     active: ownProps.filter === state.visibilityFilter   } }

使用ownProps作為引數後，如果容器元件的引數發生變化，也會引發 UI 元件重新渲染。

connect方法可以省略mapStateToProps引數，那樣的話，UI 元件就不會訂閱Store，就是說 Store 的更新不會引起 UI 元件的更新。

五、mapDispatchToProps()

mapDispatchToProps是connect函式的第二個引數，用來建立 UI 元件的引數到store.dispatch方法的對映。也就是說，它定義了哪些使用者的操作應該當作 Action，傳給 Store。它可以是一個函式，也可以是一個物件。

如果mapDispatchToProps是一個函式，會得到dispatch和ownProps（容器元件的props物件）兩個引數。

JavaScript

const mapDispatchToProps = ( dispatch, ownProps ) => { return { onClick: () => { dispatch({ type: 'SET_VISIBILITY_FILTER', filter: ownProps.filter }); } }; }

1 2 3 4 5 6 7 8 9 10 11 12 13

const mapDispatchToProps = (   dispatch,   ownProps ) => {   return {     onClick: () => {       dispatch({         type: 'SET_VISIBILITY_FILTER',         filter: ownProps.filter       });     }   }; }

從上面程式碼可以看到，mapDispatchToProps作為函式，應該返回一個物件，該物件的每個鍵值對都是一個對映，定義了 UI 元件的引數怎樣發出 Action。

如果mapDispatchToProps是一個物件，它的每個鍵名也是對應 UI 元件的同名引數，鍵值應該是一個函式，會被當作 Action creator ，返回的 Action 會由 Redux 自動發出。舉例來說，上面的mapDispatchToProps寫成物件就是下面這樣。

JavaScript

const mapDispatchToProps = { onClick: (filter) => { type: 'SET_VISIBILITY_FILTER', filter: filter }; }

1 2 3 4 5 6

const mapDispatchToProps = {   onClick: (filter) => {     type: 'SET_VISIBILITY_FILTER',     filter: filter   }; }

六、<Provider> 元件

connect方法生成容器元件以後，需要讓容器元件拿到state物件，才能生成 UI 元件的引數。

一種解決方法是將state物件作為引數，傳入容器元件。但是，這樣做比較麻煩，尤其是容器元件可能在很深的層級，一級級將state傳下去就很麻煩。

React-Redux 提供Provider元件，可以讓容器元件拿到state。

JavaScript

import { Provider } from 'react-redux' import { createStore } from 'redux' import todoApp from './reducers' import App from './components/App' let store = createStore(todoApp); render( <Provider store={store}> <App /> </Provider>, document.getElementById('root') )

1 2 3 4 5 6 7 8 9 10 11 12 13

import { Provider } from 'react-redux' import { createStore } from 'redux' import todoApp from './reducers' import App from './components/App'   let store = createStore(todoApp);   render(   <Provider store={store}>     <App />   </Provider>,   document.getElementById('root') )

上面程式碼中，Provider在根元件外面包了一層，這樣一來，App的所有子元件就預設都可以拿到state了。

它的原理是React元件的context屬性，請看原始碼。

JavaScript

class Provider extends Component { getChildContext() { return { store: this.props.store }; } render() { return this.props.children; } } Provider.childContextTypes = { store: React.PropTypes.object }

1 2 3 4 5 6 7 8 9 10 11 12 13 14

class Provider extends Component {   getChildContext() {     return {       store: this.props.store     };   }   render() {     return this.props.children;   } }   Provider.childContextTypes = {   store: React.PropTypes.object }

上面程式碼中，store放在了上下文物件context上面。然後，子元件就可以從context拿到store，程式碼大致如下。

JavaScript

class VisibleTodoList extends Component { componentDidMount() { const { store } = this.context; this.unsubscribe = store.subscribe(() => this.forceUpdate() ); } render() { const props = this.props; const { store } = this.context; const state = store.getState(); // ... } } VisibleTodoList.contextTypes = { store: React.PropTypes.object }

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

class VisibleTodoList extends Component {   componentDidMount() {     const { store } = this.context;     this.unsubscribe = store.subscribe(() =>       this.forceUpdate()     );   }     render() {     const props = this.props;     const { store } = this.context;     const state = store.getState();     // ...   } }   VisibleTodoList.contextTypes = {   store: React.PropTypes.object }

React-Redux自動生成的容器元件的程式碼，就類似上面這樣，從而拿到store。

七、例項：計數器

我們來看一個例項。下面是一個計數器元件，它是一個純的 UI 元件。

JavaScript

class Counter extends Component { render() { const { value, onIncreaseClick } = this.props return ( <div> <span>{value}</span> <button onClick={onIncreaseClick}>Increase</button> </div> ) } }

1 2 3 4 5 6 7 8 9 10 11

class Counter extends Component {   render() {     const { value, onIncreaseClick } = this.props     return (       <div>         <span>{value}</span>         <button onClick={onIncreaseClick}>Increase</button>       </div>     )   } }

上面程式碼中，這個 UI 元件有兩個引數：value和onIncreaseClick。前者需要從state計算得到，後者需要向外發出 Action。

接著，定義value到state的對映，以及onIncreaseClick到dispatch的對映。

JavaScript

function mapStateToProps(state) { return { value: state.count } } function mapDispatchToProps(dispatch) { return { onIncreaseClick: () => dispatch(increaseAction) } } // Action Creator const increaseAction = { type: 'increase' }

1 2 3 4 5 6 7 8 9 10 11 12 13 14

function mapStateToProps(state) {   return {     value: state.count   } }   function mapDispatchToProps(dispatch) {   return {     onIncreaseClick: () => dispatch(increaseAction)   } }   // Action Creator const increaseAction = { type: 'increase' }

然後，使用connect方法生成容器元件。

JavaScript

const App = connect( mapStateToProps, mapDispatchToProps )(Counter)

1 2 3 4

const App = connect(   mapStateToProps,   mapDispatchToProps )(Counter)

然後，定義這個元件的 Reducer。

JavaScript

// Reducer function counter(state = { count: 0 }, action) { const count = state.count switch (action.type) { case 'increase': return { count: count + 1 } default: return state } }

1 2 3 4 5 6 7 8 9 10

// Reducer function counter(state = { count: 0 }, action) {   const count = state.count   switch (action.type) {     case 'increase':       return { count: count + 1 }     default:       return state   } }

最後，生成store物件，並使用Provider在根元件外面包一層。

JavaScript

import { loadState, saveState } from './localStorage'; const persistedState = loadState(); const store = createStore( todoApp, persistedState ); store.subscribe(throttle(() => { saveState({ todos: store.getState().todos, }) }, 1000)) ReactDOM.render( <Provider store={store}> <App /> </Provider>, document.getElementById('root') );

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

import { loadState, saveState } from './localStorage';   const persistedState = loadState(); const store = createStore(   todoApp,   persistedState );   store.subscribe(throttle(() => {   saveState({     todos: store.getState().todos,   }) }, 1000))   ReactDOM.render(   <Provider store={store}>     <App />   </Provider>,   document.getElementById('root') );

完整的程式碼看這裡。

八、React-Router 路由庫

使用React-Router的專案，與其他專案沒有不同之處，也是使用Provider在Router外面包一層，畢竟Provider的唯一功能就是傳入store物件。

JavaScript

const Root = ({ store }) => ( <Provider store={store}> <Router> <Route path="/" component={App} /> </Router> </Provider> );

1 2 3 4 5 6 7

const Root = ({ store }) => (   <Provider store={store}>     <Router>       <Route path="/" component={App} />     </Router>   </Provider> );