前兩篇教程介紹了 Redux 的基本用法和異步操做,今天是最後一部分,介紹如何在 React 項目中使用 Redux。java
爲了方便使用,Redux 的做者封裝了一個 React 專用的庫 React-Redux,本文主要介紹它。react
這個庫是能夠選用的。實際項目中,你應該權衡一下,是直接使用 Redux,仍是使用 React-Redux。後者雖然提供了便利,可是須要掌握額外的 API,而且要遵照它的組件拆分規範。git
1、UI 組件
React-Redux 將全部組件分紅兩大類:UI 組件(presentational component)和容器組件(container component)。github
UI 組件有如下幾個特徵。redux
- 只負責 UI 的呈現,不帶有任何業務邏輯
- 沒有狀態(即不使用
this.state
這個變量)- 全部數據都由參數(
this.props
)提供- 不使用任何 Redux 的 API
下面就是一個 UI 組件的例子。異步
const Title = value => <h1>{value}</h1>;
由於不含有狀態,UI 組件又稱爲"純組件",即它純函數同樣,純粹由參數決定它的值。async
2、容器組件
容器組件的特徵偏偏相反。ide
- 負責管理數據和業務邏輯,不負責 UI 的呈現
- 帶有內部狀態
- 使用 Redux 的 API
總之,只要記住一句話就能夠了:UI 組件負責 UI 的呈現,容器組件負責管理數據和邏輯。
你可能會問,若是一個組件既有 UI 又有業務邏輯,那怎麼辦?回答是,將它拆分紅下面的結構:外面是一個容器組件,裏面包了一個UI 組件。前者負責與外部的通訊,將數據傳給後者,由後者渲染出視圖。
React-Redux 規定,全部的 UI 組件都由用戶提供,容器組件則是由 React-Redux 自動生成。也就是說,用戶負責視覺層,狀態管理則是所有交給它。
3、connect()
React-Redux 提供connect
方法,用於從 UI 組件生成容器組件。connect
的意思,就是將這兩種組件連起來。
import { connect } from 'react-redux' const VisibleTodoList = connect()(TodoList);
上面代碼中,TodoList
是 UI 組件,VisibleTodoList
就是由 React-Redux 經過connect
方法自動生成的容器組件。
可是,由於沒有定義業務邏輯,上面這個容器組件毫無心義,只是 UI 組件的一個單純的包裝層。爲了定義業務邏輯,須要給出下面兩方面的信息。
(1)輸入邏輯:外部的數據(即
state
對象)如何轉換爲 UI 組件的參數(2)輸出邏輯:用戶發出的動做如何變爲 Action 對象,從 UI 組件傳出去。
所以,connect
方法的完整 API 以下。
import { connect } from 'react-redux' const VisibleTodoList = connect( mapStateToProps, mapDispatchToProps )(TodoList)
上面代碼中,connect
方法接受兩個參數:mapStateToProps
和mapDispatchToProps
。它們定義了 UI 組件的業務邏輯。前者負責輸入邏輯,即將state
映射到 UI 組件的參數(props
),後者負責輸出邏輯,即將用戶對 UI 組件的操做映射成 Action。
4、mapStateToProps()
mapStateToProps
是一個函數。它的做用就是像它的名字那樣,創建一個從(外部的)state
對象到(UI 組件的)props
對象的映射關係。
做爲函數,mapStateToProps
執行後應該返回一個對象,裏面的每個鍵值對就是一個映射。請看下面的例子。
const mapStateToProps = (state) => { return { todos: getVisibleTodos(state.todos, state.visibilityFilter) } }
上面代碼中,mapStateToProps
是一個函數,它接受state
做爲參數,返回一個對象。這個對象有一個todos
屬性,表明 UI 組件的同名參數,後面的getVisibleTodos
也是一個函數,能夠從state
算出 todos
的值。
下面就是getVisibleTodos
的一個例子,用來算出todos
。
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
對象。
// 容器組件的代碼 // <FilterLink filter="SHOW_ALL"> // All // </FilterLink> const mapStateToProps = (state, ownProps) => { return { active: ownProps.filter === state.visibilityFilter } }
使用ownProps
做爲參數後,若是容器組件的參數發生變化,也會引起 UI 組件從新渲染。
connect
方法能夠省略mapStateToProps
參數,那樣的話,UI 組件就不會訂閱Store,就是說 Store 的更新不會引發 UI 組件的更新。
5、mapDispatchToProps()
mapDispatchToProps
是connect
函數的第二個參數,用來創建 UI 組件的參數到store.dispatch
方法的映射。也就是說,它定義了哪些用戶的操做應該看成 Action,傳給 Store。它能夠是一個函數,也能夠是一個對象。
若是mapDispatchToProps
是一個函數,會獲得dispatch
和ownProps
(容器組件的props
對象)兩個參數。
const mapDispatchToProps = ( dispatch, ownProps ) => { return { onClick: () => { dispatch({ type: 'SET_VISIBILITY_FILTER', filter: ownProps.filter }); } }; }
從上面代碼能夠看到,mapDispatchToProps
做爲函數,應該返回一個對象,該對象的每一個鍵值對都是一個映射,定義了 UI 組件的參數怎樣發出 Action。
若是mapDispatchToProps
是一個對象,它的每一個鍵名也是對應 UI 組件的同名參數,鍵值應該是一個函數,會被看成 Action creator ,返回的 Action 會由 Redux 自動發出。舉例來講,上面的mapDispatchToProps
寫成對象就是下面這樣。
const mapDispatchToProps = { onClick: (filter) => { type: 'SET_VISIBILITY_FILTER', filter: filter }; }
6、<Provider> 組件
connect
方法生成容器組件之後,須要讓容器組件拿到state
對象,才能生成 UI 組件的參數。
一種解決方法是將state
對象做爲參數,傳入容器組件。可是,這樣作比較麻煩,尤爲是容器組件可能在很深的層級,一級級將state
傳下去就很麻煩。
React-Redux 提供Provider
組件,可讓容器組件拿到state
。
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
屬性,請看源碼。
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
,代碼大體以下。
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
。
7、實例:計數器
咱們來看一個實例。下面是一個計數器組件,它是一個純的 UI 組件。
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
的映射。
function mapStateToProps(state) { return { value: state.count } } function mapDispatchToProps(dispatch) { return { onIncreaseClick: () => dispatch(increaseAction) } } // Action Creator const increaseAction = { type: 'increase' }
而後,使用connect
方法生成容器組件。
const App = connect( mapStateToProps, mapDispatchToProps )(Counter)
而後,定義這個組件的 Reducer。
// 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
在根組件外面包一層。
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') );
完整的代碼看這裏。
8、React-Router 路由庫
使用React-Router
的項目,與其餘項目沒有不一樣之處,也是使用Provider
在Router
外面包一層,畢竟Provider
的惟一功能就是傳入store
對象。
const Root = ({ store }) => ( <Provider store={store}> <Router> <Route path="/" component={App} /> </Router> </Provider> );
(完)