react-redux

sbwxffnhc發表於2019-01-08

react-redux

在react-redux 框架中,給我提供了兩個常用的API來配合Redux框架的使用,其實在我們的實際專案開發中,我們完全可以不用react-redux框架,但是如果使用此框架,就如虎添翼了。

我們來簡單聊聊這兩個常用的API

  • connect()
  • Provider 元件

React-Redux 將所有元件分成兩大類:UI 元件(presentational component)和容器元件(container component)。

UI 元件

UI 元件有以下幾個特徵。

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

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

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的意思,就是將這兩種元件連起來。

import { connect } from 'react-redux'
const VisibleTodoList = connect()(TodoList);
複製程式碼

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

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

  • 輸入邏輯:外部的資料(即state物件)如何轉換為 UI 元件的引數
  • 輸出邏輯:使用者發出的動作如何變為 Action 物件,從 UI 元件傳出去。

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

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執行後應該返回一個物件,裡面的每一個鍵值對就是一個對映。請看下面的例子。

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 元件的更新。

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
  };
}
複製程式碼

元件

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。

例項:計數器

我們來看一個例項。下面是一個計數器元件,它是一個純的 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')
);
複製程式碼

總結

本系列教程是參照阮老師的Redux入門教程文章和Redux中文文件進行的整合和擴充。更多更詳細的Redux使用方式請參照教程一中的參考文獻。

摘取一部分程式碼: index.js

import React from 'react'
import ReactDOM from 'react-dom'
import Counter2 from './components/Counter2'

import counter from './reducers/counter'
import Provider from './components/Provider';
import {createStore} from './redux';

//import {Provider} from 'react-redux';
//import {createStore} from 'redux';

let store = createStore(counter);

//Provider 就是簡單的給元件傳值 的,其他子元件不需要層層呼叫再傳

ReactDOM.render(
<Provider store={store}>
    <Counter2/>
</Provider>,document.querySelector('#root')
)



複製程式碼

Provider.js

import React from 'react';
import {PropTypes} from 'prop-types';

//實現頂層定義的,不需要層層呼叫,用來定義connect裡面需要的store
//context  'prop-types'

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

Provider.childContextTypes={
    store:PropTypes.object
}

export default Provider;
複製程式碼

connect.js

import React from 'react';
import {PropTypes} from 'prop-types';

//store一般在index裡面傳進來

//把老元件傳進去,返回一個新元件
//connect方法,用於從 UI 元件生成容器元件
//mapStateToProps 把store裡的狀態物件對映成屬性
//這個語法就是一個函式,傳入一個引數,返回一個函式
let connect = (mapStateToProps,mapDispatchToProps)=>(_component)=>{
    //Proxy,容器元件,有狀態
    class Proxy extends React.Component{
        constructor(){
            super();
            this.state = mapStateToProps(this.context.store.getState());
        }        
        //訂閱狀態變化
        componentWillMount(){
            store.subscribe(()=>{
                console.log(this.context.store.getState());//
                this.unsubscribe = this.setState(mapStateToProps(store.getState()));
            })
        }
        componentWillUnmount(){
            this.unsubscribe();
        }
        render(){
            //將值對映到Counter2中   ,  ...是展開的意思
            //把結果作為屬性傳出去給UI元件去呼叫,如Counter2
            return <_component {...this.state}
            {...mapDispatchToProps(this.context.store.dispatch)}/>
        }
    }
    Proxy.contextType={
        store:PropTypes.object
    }
    return Proxy;
}

export default  connect;
複製程式碼

Counter2.js

import React from 'react';
import {createStore} from '../redux';
import counter from '../reducers/counter'
import connect from '../connect'
//import {connect} from 'react-redux'

//其實這些檔案都是缺失的,還沒有封裝好,
let store = createStore(counter);

export default class Counter2 extends React.Component{
    constructor(){
        super();
        //建立從store中state物件到當前元件狀態物件的對映 
        this.state = {value:store.getState().number};
    }

    render(){
        return(
            <div>
                <p>{this.props.value}</p>
                <button onClick={this.props.onIncrease}>+</button>
                <button onClick={this.props.onDecrease}>-</button>
            </div>
        )
    }
}


//傳入state物件,返回一個物件
let mapStateToProps = (state)=>({
    value:state.number
})
//把dispatch 方法對映成UI元件的屬性(物件)
let mapDispatchToProps = (dispatch)=>(
    {
        onIncrease:()=>dispatch({type:INCREASE}),//這是一個函式//action
        onDecrease:()=>dispatch({type:DECREASE}),
    }
)

//connect :狀態對映 , action對映
//傳入一個UI元件Counter2,返回(形成)一個容器元件Proxy
export default connect(mapStateToProps,
    mapDispatchToProps)(Counter2);



複製程式碼

相關文章