react+redux教程(一)
今天,我们通过解读官方示例代码(counter)的方式来学习react+redux。
例子
这个例子是官方的例子,计数器程序。前两个按钮是加减,第三个是如果当前数字是奇数则加一,第四个按钮是异步加一(延迟一秒)。
源代码: https://github.com/lewis617/myReact/tree/master/redux-examples/counter
组件
components/Counter.js
import React, { Component, PropTypes } from 'react' class Counter extends Component { render() { //从组件的props属性中导入四个方法和一个变量 const { increment, incrementIfOdd, incrementAsync, decrement, counter } = this.props; //渲染组件,包括一个数字,四个按钮 return ( <p> Clicked: {counter} times {' '} <button onClick={increment}>+</button> {' '} <button onClick={decrement}>-</button> {' '} <button onClick={incrementIfOdd}>Increment if odd</button> {' '} <button onClick={() => incrementAsync()}>Increment async</button> </p> ) } } //限制组件的props安全 Counter.propTypes = { //increment必须为fucntion,且必须存在 increment: PropTypes.func.isRequired, incrementIfOdd: PropTypes.func.isRequired, incrementAsync: PropTypes.func.isRequired, decrement: PropTypes.func.isRequired, //counter必须为数字,且必须存在 counter: PropTypes.number.isRequired }; export default Counter
上述代码,我们干了几件事:
- 从props中导入变量和方法
- 渲染组件
有的同学可能会急于想知道props的方法和变量是怎么来,下面我们继续解读。
容器
containers/App.js
import { bindActionCreators } from 'redux' import { connect } from 'react-redux' import Counter from '../components/Counter' import * as CounterActions from '../actions/counter' //将state.counter绑定到props的counter function mapStateToProps(state) { return { counter: state.counter } } //将action的所有方法绑定到props上 function mapDispatchToProps(dispatch) { return bindActionCreators(CounterActions, dispatch) } //通过react-redux提供的connect方法将我们需要的state中的数据和actions中的方法绑定到props上 export default connect(mapStateToProps, mapDispatchToProps)(Counter)
看到这里,很多刚接触redux同学可能已经晕了,我来图解下redux的流程。
state就是数据,组件就是数据的呈现形式,action是动作,action是通过reducer来更新state的。
上述代码,我们干了几件事:
- 把state的counter值绑定到props上
- 把action的四个方法绑定到props上
那么为什么就绑定上去了呢?因为有connect这个方法。这个方法是如何实现的,或者我们该怎么用这个方法呢?connect这个方法的用法,可以直接看 api文档 。我也可以简单描述一下:
- 第一个参数,必须是function,作用是绑定state的指定值到props上面。这里绑定的是counter
- 第二个参数,可以是function,也可以是对象,作用是绑定action的方法到props上。
- 返回值,是绑定后的组件
这里还有很多种其他写法,我喜欢在第二个参数绑定一个对象,即
import { bindActionCreators } from 'redux' import { connect } from 'react-redux' import Counter from '../components/Counter' import * as CounterActions from '../actions/counter' //将state.counter绑定到props的counter function mapStateToProps(state) { return { counter: state.counter } } //通过react-redux提供的connect方法将我们需要的state中的数据和actions中的方法绑定到props上 export default connect(mapStateToProps, CounterActions)(Counter)
还可以不写第二个参数,后面用dispatch来触发action的方法,即
import { bindActionCreators } from 'redux' import { connect } from 'react-redux' import Counter from '../components/Counter' import * as CounterActions from '../actions/counter' //将state.counter绑定到props的counter function mapStateToProps(state) { return { counter: state.counter } } //通过react-redux提供的connect方法将我们需要的state中的数据绑定到props上 export default connect(mapStateToProps)(Counter)
后面在组件中直接使用dispatch()来触发action。
action和reducer两个好基友负责更新state
actions/counter.js
export const INCREMENT_COUNTER = 'INCREMENT_COUNTER' export const DECREMENT_COUNTER = 'DECREMENT_COUNTER' //导出加一的方法 export function increment() { return { type: INCREMENT_COUNTER } } //导出减一的方法 export function decrement() { return { type: DECREMENT_COUNTER } } //导出奇数加一的方法,该方法返回一个方法,包含dispatch和getState两个参数,dispatch用于执行action的方法,getState返回state export function incrementIfOdd() { return (dispatch, getState) => { //获取state对象中的counter属性值 const { counter } = getState() //偶数则返回 if (counter % 2 === 0) { return } //没有返回就执行加一 dispatch(increment()) } } //导出一个方法,包含一个默认参数delay,返回一个方法,一秒后加一 export function incrementAsync(delay = 1000) { return dispatch => { setTimeout(() => { dispatch(increment()) }, delay) } } //这些方法都导出,在其他文件导入时候,使用import * as actions 就可以生成一个actions对象包含所有的export
reducers/counter.js
import { INCREMENT_COUNTER, DECREMENT_COUNTER } from '../actions/counter' //reducer其实也是个方法而已,参数是state和action,返回值是新的state export default function counter(state = 0, action) { switch (action.type) { case INCREMENT_COUNTER: return state + 1 case DECREMENT_COUNTER: return state - 1 default: return state } }
reducers/index.js
import { combineReducers } from 'redux' import counter from './counter' //使用redux的combineReducers方法将所有reducer打包起来 const rootReducer = combineReducers({ counter }) export default rootReducer
上述代码我们干了几件事:
- 写了四个action方法
- 写了reducer用于更新state
- 将所有reducer(这里只有一个)打包成一个reducer
看到这里,有很多初次接触redux的同学可能已经晕了,怎么那么多概念?为了形象直观,我们在开发工具(react dev tools)上看看这些state,props什么的:
action的方法和state的变量是不是都绑定上去了啊。state怎么看呢?这个需要借助redux的开发工具,我不想破坏示例代码的结构所以,就不展示state了,不过state是我们自己定义的,我们知道state就只有个数字而已。
注册store
store/configureStore.js
import { createStore, applyMiddleware } from 'redux' import thunk from 'redux-thunk' import reducer from '../reducers' //applyMiddleware来自redux可以包装 store 的 dispatch //thunk作用是使被 dispatch 的 function 会接收 dispatch 作为参数,并且可以异步调用它 const createStoreWithMiddleware = applyMiddleware( thunk )(createStore) export default function configureStore(initialState) { const store = createStoreWithMiddleware(reducer, initialState) //热替换选项 if (module.hot) { // Enable Webpack hot module replacement for reducers module.hot.accept('../reducers', () => { const nextReducer = require('../reducers') store.replaceReducer(nextReducer) }) } return store }
index.js
import React from 'react' import { render } from 'react-dom' import { Provider } from 'react-redux' import App from './containers/App' import configureStore from './store/configureStore' const store = configureStore() render( <Provider store={store}> <App /> </Provider>, document.getElementById('root') )
上述代码,我们干了几件事:
- 用中间件将dispatch触发的方法中加入dispatch参数(action里面有,可以去看看)
- 如果在热替换状态( Webpack hot module replacement )下,允许替换reducer
- 导出store
- 将store放进provider
- 将provider放在组件顶层,并渲染
服务
server.js
var webpack = require('webpack') var webpackDevMiddleware = require('webpack-dev-middleware') var webpackHotMiddleware = require('webpack-hot-middleware') var config = require('./webpack.config') var app = new (require('express'))() var port = 3000 var compiler = webpack(config) app.use(webpackDevMiddleware(compiler, { noInfo: true, publicPath: config.output.publicPath })) app.use(webpackHotMiddleware(compiler)) app.get("/", function(req, res) { res.sendFile(__dirname + '/index.html') }) app.listen(port, function(error) { if (error) { console.error(error) } else { console.info("==> :earth_americas: Listening on port %s. Open up http://localhost:%s/ in your browser.", port, port) } })
webpack.config.js
var path = require('path') var webpack = require('webpack') module.exports = { devtool: 'cheap-module-eval-source-map', entry: [ 'webpack-hot-middleware/client', './index' ], output: { path: path.join(__dirname, 'dist'), filename: 'bundle.js', publicPath: '/static/' }, plugins: [ new webpack.optimize.OccurenceOrderPlugin(), new webpack.HotModuleReplacementPlugin(), new webpack.NoErrorsPlugin() ], module: { loaders: [ { test: /\.js$/, loaders: [ 'babel' ], exclude: /node_modules/, include: __dirname } ] } }
npm start 后执行node server ,触发webpack。webpack插件功能如下:
- OccurenceOrderPlugin的作用 是维持构建编译代码
- HotModuleReplacementPlugin是热替换,热替换和dev-server的hot有什么区别?不用刷新页面,可用于生产环境
- NoErrorsPlugin用于保证编译后的代码永远是对的,因为不对的话会自动停掉。
server.js中的用法是参考 官网 的,没有为什么,express中间件就是在请求后执行某些操作。
结语
好了,终于写完第一篇了。react+redux是当前热点,很高兴可以分享我的经验和习得。请继续关注我的react+redux教程以及其他诸如angular方面的博客,谢谢!