webpack+react+redux+es6开发模式

一、预备知识

　　node, npm, react, redux, es6, webpack

二、学习资源

　　ECMAScript 6入门

　　React和Redux的连接react-redux

　　Redux 入门教程 redux middleware 详解 Redux研究

　　React 入门实例教程

　　webpack学习demo

　　NPM 使用介绍

三、工程搭建

　　之前有写过 webpack+react+es6开发模式，文章里介绍了一些简单的配置，欢迎访问。后续文章请参考 webpack+react+redux+es6开发模式---续。

　　1.可以npm init, 创建一个新的工程。创建package.json文件，定义需要的dependency，scripts，version等等。

　　2.新增webpack.config.json文件，定义插件项配置，页面入口文件，文件输出，加载器的配置，其他解决方案配置等。下面提供了简单配置的demo，更详细的讲解，请参考 webpack 入门指南: w2bc.com/Article/50764。

var webpack = require('webpack');

var commonsPlugin = new webpack.optimize.CommonsChunkPlugin('common.js');

module.exports = {

    //插件项

    plugins: [commonsPlugin],

    //页面入口文件配置

    entry: {

        bundle: './index.js'

    },

    //入口文件输出配置

    output: {

        path: './build/',

        filename: '[name].js'

    },

    module: {

        //加载器配置

        loaders: [

            { test: /\.css$/, loader: 'style-loader!css-loader' },

            { test: /\.js$/, loader: 'jsx-loader?harmony' },

            { test: /\.scss$/, loader: 'style!css!sass?sourceMap'},

            { test: /\.(png|jpg)$/, loader: 'url-loader?limit=8192'}

        ]

    },

    //其它解决方案配置

    resolve: {

        root: '******', //绝对路径

        extensions: ['', '.js', '.json', '.scss'],

        alias: {

            AppStore : 'js/stores/AppStores.js',

            ActionType : 'js/actions/ActionType.js',

            AppAction : 'js/actions/AppAction.js'

        }

    }

};

　　3.编写如果文件 main.js。这里创建了provider，store，history，router。实现页面的路由以及react组件以及组件间的state交互。关于react-redux内容请参考 react-redux概念理解，关于react-router内容请参考 React Router 使用教程。

var React = require('react');

var ReactDOM = require('react-dom');

var { Provider } = require('react-redux');

import { Router } from 'react-router';

import routes from 'routes';

import { createHashHistory, useBasename } from 'history';

import { syncReduxAndRouter } from 'redux-simple-router';

import { routeReducer } from 'redux-simple-router';

var configureStore = require('./stores/configureStore');

// Run our app under the /base URL.

const history = useBasename(createHashHistory)({

  basename: '/',

});

const store = configureStore(window.__INITIAL_STATE__);

syncReduxAndRouter(history, store);

ReactDOM.render

(

  <Provider store={store}>

      <Router history={history}>

      {routes}

    </Router>

  </Provider>,

   document.getElementById('root')

);

　　4.创建工程的各个模块

|--demo1

    |--src  //源码

        |--actions     // 存放当前触发Redux的动作行为

        |--components  // 存放工程内部的公共组件

        |--modules     // 存放工程各模块代码

        |--constants   // action动作常量

        |--reducers    // 存放reducer函数，用来修改store状态

        |--routes      // 放置页面路由 react router

        |--stores      // 放置stores配置文件

        |--main.js       // 入口js

        |--index.html  // 工程入口文件html

        |--node_modules  // 存放依赖的第三方模块库,使用命令 npm install

        |--build  //打包文件存放的目录

        |--webpack.config.js

        |--package.json

四、功能开发

　　1.做一个简单的Home页面

　　(1).在modules文件夹新建Home.js, 使用antd 的Menu组件, 展示我们要演示的功能。

import React from 'react';

import 'less/home.less';

import { Scrollbars } from 'react-custom-scrollbars';

import {Menu} from 'antd';

//首页

export class Home extends React.Component{

  constructor(props) {

    super(props);

    this.changeRoute = this.changeRoute.bind(this);

  }

  componentDidMount() {

  }

  changeRoute(e) {

    this.context.history.pushState({}, e.key);

  }

  render() {

    return (

      <div className='home'>

        <Scrollbars style={{ height: 600 }}>

            <Menu className='menu' onClick={this.changeRoute}>

              <Menu.Item key='showSelfMsg'>页面渲染展示信息</Menu.Item>

              <Menu.Item key='frontAndRearInteractive'>模拟前后台交互</Menu.Item>

              <Menu.Item key='pageExchange'>页面切换</Menu.Item>

              <Menu.Item key='extend'>子组件扩展</Menu.Item>

            </Menu>

        </Scrollbars>

      </div>

    );

  }

}

Home.contextTypes = {

  history: React.PropTypes.object.isRequired,

};

module.exports = Home;

　　(2).注册Home页面的路由，对应routes/index.js加入如下代码。

<Route path="/" component={ModuleRouters}>

    <IndexRoute component={Home} />

</Route>

　　(3).启动工程， npm run dev, 浏览器中输入 http://localhost:8000/demo1，即可预览我们的Home页面。

　　2.单页面渲染，完成数据的展示和隐藏

　　(1).在component目录下新建ShowSelfMsg.js, 通过改变state状态，重新渲染页面.

import React from 'react';

import {connect} from 'react-redux';

import {Button} from 'antd';

import 'less/common.less';

var mapStateToProps = function(state){

};

class ShowSelfMsg extends React.Component{

    constructor(props){

        super(props);

        this.state = {

            showContent: false

        };

        this.showContent = this.showContent.bind(this);

    }

    showContent() {

        this.setState({

            showContent: !this.state.showContent

        });

    }

    componentDidMount() {

        const { dispatch} = this.props;

        //加载该页面的数据

    }

    componentWillReceiveProps(nextProps) {

    }

    render() {

        let showContent = this.state.showContent;

        return (

            <div className='main'>

                <div className='content'>

                    <Button type="ghost" onClick={this.showContent}>{!this.state.showContent ? '单击显示内容' : '单击隐藏内容'}</Button>

                    {

                        showContent ? (<div><span>大家好，我是hjzgg</span></div>) : (null)

                    }

                    <div className='back'>

                        <Button type="ghost" onClick={()=>this.context.history.pushState({}, '/')}>返回</Button>

                    </div>

                </div>

            </div>

        );

    }

}

ShowSelfMsg.contextTypes = {

  history: React.PropTypes.object.isRequired,

};

module.exports = connect(mapStateToProps)(ShowSelfMsg);

　　(2).注册路由，在routes/index.js中加入如下代码。

<Route path="/showSelfMsg" component={ShowSelfMsg} />

　　(3).在Home页面中点击 ‘页面渲染展示信息’，即可进入这个页面。

　　3.模拟前后台交互

　　(1).代码编写如下。

　　　　(I).在constants新建ActoinTypesjs，定动作类型；

　　　　(II).在actions目录中新建simulationRquest.js, 定义要分发的动作；

　　　　(III)在reducers目录新建simulationRquest.js，存放reducer函数，用来修改store状态，然后将该函数放入到reducers/index.js中的combineReducers函数中,最终会合并成一个新的reducer；

　　　　(IV)components目录中新建FrontAndRearInteractive.js, dispatch 自定义的动作，实现模拟前后台交互功能。

　　ActionType.js

export const SIMULATION_REQUEST_SUCCESS = 'SIMULATION_REQUEST_SUCCESS';

export const SIMULATION_REQUEST_FAIL = 'SIMULATION_REQUEST_FAIL';

export const INIT_EXTEND_DATA_SUCCESS = 'INIT_EXTEND_DATA_SUCCESS';

export const INIT_EXTEND_DATA_FAIL = 'INIT_EXTEND_DATA_FAIL';

export const SAVE_EXTEND_DATA_SUCCESS = 'SAVE_EXTEND_DATA_SUCCESS';

　　FrontAndRearInteractive.js

import React from 'react';

import {connect} from 'react-redux';

import {Button} from 'antd';

import {simulationRquestAction} from 'actions/simulationRequest';

var mapStateToProps = function(state){

    return {

        myRequest: state.myRequest,

    }

};

class FrontAndRearInteractive extends React.Component{

    constructor(props){

        super(props);

        this.state = {

            showContent: false

        };

        this.simulationRequest = this.simulationRequest.bind(this);

    }

    simulationRequest() {

        const {dispatch} = this.props;

        console.log('props>>>dispath:' + dispatch);

        dispatch(simulationRquestAction());

    }

    componentDidMount() {

        const { dispatch} = this.props;

        //加载该页面的数据

    }

    componentWillReceiveProps(nextProps) {

        const { myRequest } = nextProps;

        if(myRequest.code && myRequest.msg)

            alert('请求结果：code=' + myRequest.code + ', msg=' + myRequest.msg);

    }

    render() {

        const { myRequest } = this.props;

        return (

            <div className='main'>

                <div className='content'>

                    <Button type="ghost" onClick={this.simulationRequest}>模拟请求</Button>

                    {

                        myRequest && myRequest.data ? (<div><span>{myRequest.data}</span></div>) : (null)

                    }

                    <div className='back'>

                        <Button type="ghost" onClick={()=>this.context.history.pushState({}, '/')}>返回</Button>

                    </div>

                </div>

            </div>

        );

    }

}

FrontAndRearInteractive.contextTypes = {

  history: React.PropTypes.object.isRequired,

};

module.exports = connect(mapStateToProps)(FrontAndRearInteractive);

　　actions/simulationRquest.js

import {ajax} from 'utils/ajax';

import url from 'utils/Url';

import {

    SIMULATION_REQUEST_SUCCESS, SIMULATION_REQUEST_FAIL,

    } from 'constants/ActionTypes';

function simulationRquestSuccess(data, msg){

    return {

        type: SIMULATION_REQUEST_SUCCESS,

        data,

        msg,

    }

}

function simulationRquestFail(msg){

    return {

        type: SIMULATION_REQUEST_FAIL,

        msg,

    }

}

export function simulationRquestAction(args){

    return function (dispatch) {

        console.log('actions>>>dispath:' + dispatch);

        /*

            //真是请求

            ajax({

                method : 'GET',

                url :  url.QUERY_ALL_USER,

                query : {'args': args},

                type : 'json',

                success : function(data) {

                  return dispatch(simulationRquestSuccess(data));

                },

                error : function(data) {

                  return dispatch(simulationRquestFail('request fail'));

                }

            });

        */

        //假设请求成功

        return dispatch(simulationRquestSuccess('我是后台返回数据：hjzgg!!!', '获取数据成功'));

  };

}

　　reducers/simulationRquest.js

import {

    SIMULATION_REQUEST_SUCCESS, SIMULATION_REQUEST_FAIL,

    }  from 'constants/ActionTypes';

import assign from 'lodash/assign';

function myRequest(state = {

        data: null,

        msg: null,

        code: null,

    }, action) {

    console.log('reducer action属性>>>>>' + JSON.stringify(action));

    switch(action.type) {

        case SIMULATION_REQUEST_SUCCESS:

            return assign({}, state, {

                msg: action.msg,

                data: action.data,

                code: 'success',

              });

        case SIMULATION_REQUEST_FAIL:

            return assign({}, state, {

                msg: action.msg,

                data: null,

                code: 'fail',

              });

        default:

            return state;

    }

}

module.exports = myRequest;

　　(2).路由注册，在routes/index.js增加如下代码。

<Route path="/frontAndRearInteractive" component={FrontAndRearInteractive} />

　　(3).在Home页面中点击 ‘模拟前后台交互’，即可进入页面。

　　4.页面切换

　　(1).在components目录新建PageExchange.js 和 Childpage.js，分别为父页面和子页面。注意，这里父页面的变量信息是通过路由的方式传递过去的，当然也可以通过state方式传递过去。

　　PageExchange.js

import React from 'react';

import {connect} from 'react-redux';

import {Button} from 'antd';

import 'less/common.less';

var mapStateToProps = function(state){

};

class PageExchange extends React.Component{

    constructor(props){

        super(props);

        this.state = {

            showContent: false

        };

        this.gotoChildPage = this.gotoChildPage.bind(this);

    }

    gotoChildPage() {

        console.log('this.context.history>>>>>>' + JSON.stringify(this.context.history));

        this.context.history.pushState({}, 'childDemoPage/' + '我是父页面信息');

    }

    componentDidMount() {

        const { dispatch} = this.props;

        //加载该页面的数据

    }

    componentWillReceiveProps(nextProps) {

    }

    render() {

        let showContent = this.state.showContent;

        return (

            <div className='main'>

                <div className='content'>

                    <Button type="ghost" onClick={this.gotoChildPage}>进入子页面</Button>

                    <div className='back'>

                        <Button type="ghost" onClick={()=>this.context.history.pushState({}, '/')}>返回</Button>

                    </div>

                </div>

            </div>

        );

    }

}

PageExchange.contextTypes = {

  history: React.PropTypes.object.isRequired,

};

module.exports = connect(mapStateToProps)(PageExchange);

　　Childpage.js

import React from 'react';

import {connect} from 'react-redux';

import {Button} from 'antd';

import 'less/common.less';

var mapStateToProps = function(state){

    return {

    }

};

class ChildPage extends React.Component{

    constructor(props){

        super(props);

        this.returnParentPage = this.returnParentPage.bind(this);

    }

    componentDidMount() {

        const { dispatch} = this.props;

        //加载该页面的数据

    }

    componentWillReceiveProps(nextProps) {

    }

    returnParentPage() {

        this.context.history.pushState(null, 'pageExchange');

    }

    render() {

        const parentPageMsg = this.props.params.parentPageMsg;

        return (

            <div className='main'>

                <div className='content'>

                    <Button type="ghost" onClick={this.returnParentPage}>返回父页面</Button>

                    {

                        parentPageMsg ? (<div><span>{parentPageMsg}</span></div>) : (null)

                    }

                </div>

            </div>

        );

    }

}

ChildPage.contextTypes = {

  history: React.PropTypes.object.isRequired,

};

module.exports = connect(mapStateToProps)(ChildPage);

　　(2).注册路由，在routes/index.js中加入如下代码。

<Route path="/pageExchange" component={PageExchange} />

<Route path="/childDemoPage(/:parentPageMsg)" component={ChildPage}/>

　　(3).在Home页面中点击‘页面切换’，即可进入页面。

　　5.自定义扩展组件

　　(1).先说一下应用场景：多个页面可能需要类似的扩展功能，通过自定义扩展组件，完成对信息的加载。主页面信息保存时，通知扩展组件要保存信息了，扩展组件将最新修改的信息告知主页面，主页面获取到全部信息后，一起将数据传给后台，完成主页面信息和扩展信息的保存。

　　(2).在components目录下新建Page.js和ExtendPage.js，分别为主页面和自定义扩展组件。

　　Page.js

import React from 'react';

import {connect} from 'react-redux';

import {Button, Input, Form} from 'antd';

import ExtendPage from 'components/ExtendPage';

import 'less/common.less';

const FormItem = Form.Item;

var mapStateToProps = function(state){

    return {

        extendStore: state.extendStore

    }

};

class Page extends React.Component{

    constructor(props){

        super(props);

        this.state = {

            childState: false,

        }

        this.handleSubmit = this.handleSubmit.bind(this);

        this.onSaveExtendPage = this.onSaveExtendPage.bind(this);

    }

    componentDidMount() {

        const { dispatch} = this.props;

        //加载该页面的数据

    }

    componentWillReceiveProps(nextProps) {

    }

    //通知扩展组件，准备保存了

    onSaveExtendPage() {

        if(this.state.childState) {

            this.setState({

                childState: false,

            });

        }

    }

    save(values) {

        //打印父级和子级文本

        alert(JSON.stringify(values));

    }

    handleSubmit() {

        var self = this;

        this.props.form.validateFields((err, values) => {

          if (!err) {//表单符合标准

            //values 为当前父页面的数据，接下来获取子页面的数据

            this.setState({childState: true}, function() {

                const { extendStore } = self.props;

                values.extendData = extendStore && extendStore.data || extendStore;

                self.save(values);

            });

          }

        });

    }

    render() {

        const { getFieldProps } = this.props.form;

        const inputProps = getFieldProps('inputText', {

            initialValue: '',

            rules: [

                    {required: true, message: 'the input is required' },

                ],

            validateTrigger: "onBlur"

        });

        return (

            <div style={{marginTop: 50, width: 600, marginLeft: 'auto', marginRight: 'auto'}}>

                <Form onSubmit={this.handleSubmit}>

                  <FormItem {...{labelCol: { span: 6 }, wrapperCol: { span: 14 }}} label="父级文本: ">

                      <Input {...inputProps} id='inputText' type='text'/>

                  </FormItem>

                  <FormItem wrapperCol={{ span: 12, offset: 6 }}>

                      <Button type="primary" htmlType="submit">提交</Button>

                     </FormItem>

                </Form>

                <ExtendPage

                    childState={this.state.childState}

                    callBack={this.onSaveExtendPage}

                />

                <div style={{float: 'right'}}>

                    <Button type="ghost" onClick={()=>this.context.history.pushState({}, '/')}>返回</Button>

                </div>

            </div>

        );

    }

}

Page.contextTypes = {

  history: React.PropTypes.object.isRequired,

};

Page = Form.create()(Page);

module.exports = connect(mapStateToProps)(Page);

　　ExtendPage.js

import React from 'react';

import {connect} from 'react-redux';

import {Button, Form, Input, message} from 'antd';

const FormItem = Form.Item;

import {initExtendData, saveExtendDataAction} from 'actions/extendPage';

var mapStateToProps = function(state){

    return {

        extendStore: state.extendStore

    }

};

class ExtendPage extends React.Component{

    constructor(props){

        super(props);

        this.state = {

        }

        this.saveExtendData = this.saveExtendData.bind(this);

        this.checkText = this.checkText.bind(this);

    }

    checkText(rule, value, callBack) {

        if(/\s+/.test(value)) {

            callBack("不能有空白字符");

        } else {

            callBack();

        }

     }

    saveExtendData() {

        this.props.callBack();//保存成功后，更改父页面的childState的状态

        this.props.form.validateFields((err, values) => {

          if (!err) {//表单符合标准

            console.log('save ExtendPage values: ' + JSON.stringify(values));

            const {dispatch} = this.props;

            dispatch(saveExtendDataAction(values));

          }

        });

    }

    componentDidMount() {

        const { dispatch} = this.props;

        //初始化扩展页的数据

        dispatch(initExtendData());

    }

    componentWillReceiveProps(nextProps) {

        const { extendStore, childState } = nextProps;

        if(extendStore && extendStore.msg) {

            message.info(extendStore.msg, 5);

            extendStore.msg = null;

        }

        if(childState) {//父页面 改变 子页面的状态

            this.saveExtendData();

        }

    }

    render() {

        const { getFieldProps } = this.props.form;

        const { extendStore } = this.props;

        const inputValue = extendStore && extendStore.data && extendStore.data.extendInputText || null;

        const inputProps = getFieldProps('extendInputText', {

            initialValue: inputValue,

            rules: [

                    {required: true, message: 'the input is required' },

                    {validator: this.checkText}

                ],

            validateTrigger: "onBlur"

        });

        return (

            <div>

                <Form>

                  <FormItem {...{labelCol: { span: 6 }, wrapperCol: { span: 14 }}} label="扩展本文: ">

                      <Input {...inputProps} type="text" id="extendInputText"/>

                  </FormItem>

                </Form>

            </div>

        );

    }

}

ExtendPage = Form.create()(ExtendPage);

module.exports = connect(mapStateToProps)(ExtendPage);

　　(3).说一下组件的扩展机制

　　(I).扩展组件自身会维护更新自己state状态，在触发扩展组件保存时，扩展组件将自身数据通过dispatch进行分发，最后通过对应的reducer(这个reducer会通过combineReducers函数合并成一个新的reducer)进行处理，根据逻辑生成新的state。

　　>>定义动作类型

　　>>分发动作

　　>>reducer处理动作，返回新的state

　　>>自定义的reducer函数通过combineReducers函数进行合并

　 (II).父级组件如何获取扩展组件的状态？

　　也就是store中的状态树变化的时候，组件可以通过 mapStateToProps 函数从状态树中获取最新的state。

　　(III).父级组件如何通知扩展组件准备保存数据了？

　　>>扩展组件接收父级组件两个参数：childState, 通知扩展组件状态发生变化; callBack, 修改childState状态，扩张组件通知父级组件更新完成。

　　>>父级组件保存数据时，首先获取到自己的数据，然后通过setState()方法改变childState的值，通知扩展组件。最后通过setState方法传入的回调函数（该函数在组件更新完成之后调用）获取到扩展组件的最新state。

　　>>扩展组件接收到父级组件的通知，刷新store中的state。这样父级组件和扩展组件自身都可以通过mapStateToProps方法获取到最新的state。

　 (4).注册路由，在routes/index.js中加入如下代码。

　　(5).在Home页面中点击‘页面切换’，即可进入页面。

五、问题解惑

　 1.module.filename、__filename、__dirname、process.cwd(): http://www.tuicool.com/articles/bQre2a
　 2.node.js之path模块: http://www.jianshu.com/p/fe41ee02efc8
　 3.react-router: http://www.ruanyifeng.com/blog/2016/05/react_router.html?utm_source=tool.lu
4.出现如下错误：Cannot sync router: route state does not exist. Did you install the routing reducer，参考：

　　 http://stackoverflow.com/questions/34039619/redux-simple-router-react-router-error-route-state-does-not-exist

　　5.module.exprots, export, export default区别：

export default variation

import variation from 'js file'

export variation

import {variation} from 'js file'

module.exports=variation

import variation from 'js file'

　　参考：

　　http://www.2cto.com/kf/201412/360211.html

　　http://www.jb51.net/article/33269.htm

　　http://blog.csdn.net/zhou_xiao_cheng/article/details/52759632

六、dispath疑问

　　react-router相关API

　　react-redux 之 connect 方法详解

　　验证一下 redux store.dispatch 和 react组件 props中的dispath，的确是一样的。

dispath:function (action) {

      return typeof action === 'function' ? action(dispatch, getState) : next(action);

}

七、演示地址

　　http://study.hujunzheng.cn:8000/DEMO_FRONT/

八、完整项目下载

　　https://github.com/hjzgg/webpack-react-redux