首页 > 代码库 > webpack+react+antd 单页面应用实例

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

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一下啦!谢谢~

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

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