webpack+react+antd 单页面应用实例

React框架已经火了好长一段时间了，再不学就out了！

对React还没有了解的同学可以看看我之前的一篇文章，可以快速简单的认识一下React。React入门最好的实例－TodoList

自己从开始接触react一窍不通，到慢慢的似懂非懂，通过各种途径学习也有一阵了。学习过程中还会接触到很多新的东西，比如ES6、webpack，过程艰辛谁人懂，见坑填坑慢慢来。今天把学习过程过滤了一下，只说项目实际需要用的东西，总结了一套能看到的东西，分享给大家，希望能让读者少踩一些坑！

本文看点

• 实际项目效果：最终你只需要在本地启一个服务，就能看到运行效果。
• webpack的配置：项目实战中常用的插件和配置方法。
• React用法：React在MVC（模型Model－视图View－控制器Controller）层面上主要扮演了视图的作用。我们可以学习它在项目中到底该如何使用。
• React-router配置：单页面应用（SPA）离不开路由，我们可以学习在项目中React-router如何配置。
• ES6语法：我们会用到一些在项目中常见的ES6语法。
• antd的使用：蚂蚁金服出的一款基于React的框架，我们可以学习如何去使用。

项目效果

项目代码已经上传至github，项目代码github地址。大家把代码下载下来之后，跟随以下步骤即可在本地看到效果。

• 首先安装node环境。

• 全局安装webpack

  npm install webpack -g
  

• 安装项目依赖

  npm install
  

• 开发模式，启动本地服务

  npm run dev
  

  至这一步成功后，在浏览器输入localhost:8888就能看到如下图的效果了。

  

• 在build文件夹下打包

  npm run build
  

webpack配置

基于React的项目配合webpack来打包管理最合适不过了。但是不学不知道，一学吓一跳，webpack的学习TM复杂了，各种报错，各种坑，就是webpack让我在学习的过程中一度想要放弃。然而过来人告诉你，坚持就是胜利！

学会怎么配置webpack，是独立管理项目的第一步。每个用webpack管理的项目都有一个webpack.config.js文件，先来看看这个项目的webpack.config.js文件：

'use strict';
var ExtractTextPlugin = require("extract-text-webpack-plugin");  //css单独打包
var CommonsChunkPlugin = require("webpack/lib/optimize/CommonsChunkPlugin");
module.exports = {
    devtool: 'eval-source-map',
    entry: {
        main: './src/entry.js', //唯一入口文件
        vendor: ['react']   //这里是依赖的库文件配置，和CommonsChunkPlugin配合使用可以单独打包
    },
    output: {
        path: './build', //打包后的文件存放的地方
        filename: 'main.js', //打包后输出文件的文件名
        publicPath: 'http://localhost:8888/build/'  //启动本地服务后的根目录
    },
    module: {
        loaders: [
            { test: /\.js$/, loader: "jsx!babel", include: /src/},
            { test: /\.css$/, loader: ExtractTextPlugin.extract("style", "css!postcss")},
            { test: /\.scss$/, loader: ExtractTextPlugin.extract("style", "css!postcss!sass")},
            { test: /\.(png|jpg|gif)$/, loader: 'url?limit=819200'}
        ]
    },
    babel: {
        presets: ['es2015', 'stage-0', 'react'],
        plugins: ['transform-runtime', ['import', {
          libraryName: 'antd',
          style: 'css'
        }]]
    },
    postcss: [
        require('autoprefixer')    //调用autoprefixer插件,css3自动补全
    ],
    devServer: {
        // contentBase: './src/views'  //本地服务器所加载的页面所在的目录
        port: 8888,
        colors: true,  //终端中输出结果为彩色
        historyApiFallback: true,  //不跳转
        inline: true  //实时刷新
    },
    plugins: [
        new ExtractTextPlugin('main.css'),
        new CommonsChunkPlugin({
           name: 'vendor',
           filename: 'vendor.js'
        })
    ]
}

一个完整项目的基本webpack配置就是这些了，重要的配置项已经在上述代码中作了注释。另外，也可以深入学习，推荐看看这篇文章。webpack详细指南

React用法

React本身真的非常简单。你可以把一个页面分为很多个组件的组成，而React就是开发这些组件的。所以React其实就是view层，说白了就是html，只不过每个组件是通过js创建的，每个组件还有自己的状态和自己的方法。

React Component（一个组件）提供一个render方法以及其他可选的生命周期函数、组件相关的事件或方法定义。常用API就以下几个：

• constructor：构造函数

  class component extends React.Component {
  	constructor(props) {
  		super(props);
  		this.state = {
  			color: props.initialColor
  		};
  	}
  }
  

• render：组件返回的dom内容（必须）

• componentWillMount：在render之前自动调用，你可以在这个方法里面调用setState改变状态，并且不会导致额外调用一次render

• componentDidMount：在render之后自动调用，从这里开始可以通过this.getDOMNode()获取到组件的DOM节点

• componentWillUpdate: 组件收到新的state，更新view之前自动调用

• componentDidUpdate: 组件收到新的state，更新view完成之后自动调用

然后回到我们这个项目实例，拿代码中的进度条组件（src-components-progress.js）代码作为展示：

import React from 'react';    //引入react
import { Progress, Button } from 'antd';    //引入antd
const ButtonGroup = Button.Group;
class myProgress extends React.Component {
    constructor(props) {
        super(props)
        this.state = {   //初始化组件的状态
            percent: 0
        }
    }
    increase() {   //自定义函数
        let percent = this.state.percent + 10;
        if (percent > 100) {
            percent = 100;
        }
        this.setState({ percent });   //设置组件的状态
    }
    decline() {   //自定义函数
        let percent = this.state.percent - 10;
        if (percent < 0) {
            percent = 0;
        }
        this.setState({ percent });
    }
    render() {
        return (
            <div className="progress-wrap">    //类名使用className
                <Progress percent={this.state.percent} />
                <Progress type="circle" percent={this.state.percent} />
                <ButtonGroup>
                    <Button type="ghost" onClick={this.decline.bind(this)} icon="minus" />
                    <Button type="ghost" onClick={this.increase.bind(this)} icon="plus" />
                </ButtonGroup>
                <span>点击按钮可以看到进度条的变化</span>
            </div>
        )
    }
}
export default myProgress;  //导出这个组件（ES6语法）

代码我已经给出了注释，不做赘述。

React-router配置

独立的前端应用离不开路由配置，就像angular框架也有自己的路由一样。在React项目中使用路由，需要依赖React-Router模块。我们直接来看看此项目中的路由配置：

import ReactDom from 'react-dom';
import { Router, Route, Link, hashHistory, IndexRoute, Redirect, IndexLink} from 'react-router';
ReactDom.render((
    <Router history={hashHistory}>   //路由容器
        <Route path="/" component={Sider}>    //一级路由，路径为"/"时，加载“Sider”组件
            <IndexRoute component={myIntroduce} />   //默认路由，加载“Sider”和“myIntroduce”组件
            <Route path="myIntroduce" component={myIntroduce} />   //二级路由
            <Route path="myTable" component={myTable} />    //二级路由
            <Route path="myForm" component={myForm} />   //二级路由
            <Route path="myProgress" component={myProgress} />   //二级路由
            <Route path="myCarousel" component={myCarousel} />   //二级路由
        </Route>
    </Router>
), document.getElementById('app'));

React的路由配置其实很简单，就是把路径和定义好的组件一一对应起来就好了。上述代码结合实际运行效果，一看就明白。

ES6语法

我之前写过一篇关于ES6常见语法的文章，总结ES6常用的新特性。

。

另外，上述贴出的代码中已经出现过很多的ES6语法。ES6的学习就是见多学多的过程，多使用，多总结，自然就会了。

antd的使用

antd可以理解为是一个基于react的ui组件库。引入这个库之后，我们就可以直接使用很多现成的组件，比如按钮、图标、表单、菜单、导航等等。去antd官网发现更多牛逼的组件。

比如上面已经贴过的进度条组件：

import { Progress, Button } from 'antd';    //引入antd
const ButtonGroup = Button.Group;   //按钮组
......
<Progress percent={this.state.percent} />    //使用进度条组件，percent是组件提供的配置项
<Progress type="circle" percent={this.state.percent} />
<ButtonGroup>
	<Button type="ghost" onClick={this.decline.bind(this)} icon="minus" />
	<Button type="ghost" onClick={this.increase.bind(this)} icon="plus" />
</ButtonGroup>
......

另外，由于antd组件比较多，所以库文件比较大，所以我们在开发的时候可以按需引入对应的库。webpack配置需要用到babel-plugin-import模块。

babel: {
	presets: ['es2015', 'stage-0', 'react'],
	plugins: ['transform-runtime', ['import', {
		libraryName: 'antd',
		style: 'css'
	}]]
}

总结

上面的项目我已放到了Github上。基于react+antd的项目实例，喜欢的看管麻烦star一下啦！谢谢～

学习的过程枯燥艰辛，但是取得的成果却令人兴奋。所以我们还是要不忘初心，不忘学习！