【单页面博客从前端到后端】基于 DVA+ANTD 搭建博客前后台界面

在上篇文章我们已经搭建好了基础的开发环境，接下来会介绍如何引入 DVA 和 ANTD ，以及在引入过程中需要注意的问题。这里只会详细的书写部分组件，其他的组件都是大同小异。你可以在 github仓库中找到这些组件。

博客的原型图

这里我简单的画了一个博客的轮廓图。这样在写组件的过程中有助于有个整体性的思路，不迷路…

添加目录结构

blog 
├─ dist           # 输出目录
├─ task           # 这里来放webpack处理和配置文件
├─ src
|  ├─ assets      # 静态文件文件夹
|  ├─ components  # 组件
|  |  ├─ Home     # Home 页面的文件夹
|  |  ├─ Archive 
|  |  ├─ About
|  |  ├─ Admin    # 后台界面文件夹
|  |  ├─ Header.js    # 公共的 Header 组件
|  |  ├─ Footer.js    # 公共的 Footer 组件
|  |  ├─ UserCard.js  # 公共的 UserCard 组件
|  |  ├─ Login.js     # 公共的 Login 组件
|  ├─ containers  # Redux 的容器组件
|  |  ├─ Home.js      # Home 组件的容器
|  |  ├─ Archive.js
|  |  ├─ About.js
|  |  ├─ Admin        # 后台各界面的容器文件夹
|  ├─ router.js   # React 路由
|  └ index.js     # 入口文件
| package.json

引入 DVA 和 ANTD

DVA 的简单引入

Lightweight front-end framework based on redux, redux-saga and [email protected]. (Inspired by elm and choo)

要知道 dva 是对 redux , redux-saga , react-router 的封装，使用上有点像 express.js ，那么你就要多少对他们有所了解，dva 的 github 仓库有详细的入门指南、概念和示例，可以先去了解一下。

更改入口文件 src/index.js

import dva from 'dva'
const app = dva()

app.router(require('./router'))
app.start('#root')

新建路由文件 src/router.js

import React from 'react'
import { Router, Route, IndexRoute, IndexRedirect } from 'dva/router'

import AppLayout from './container/App'
import Home from './container/Home'
import Archive from './container/Archive'
import About from './container/About'
import Article from './container/Article'
import AdminArticles from './container/Admin/Articles'
import AdminKeywrods from './container/Admin/Keywords'
import AdminEditor from './container/Admin/Editor'
import AdminLayout from './container/Admin/Admin'

export default ({history, app}) => {
    return (
        
            
                
                
                
                
                
                    
                    
                    
                    
                
            
        
    )
}

从这里可以看出， dva 自己在内部引入 react-router-redux ，然后使用 react-router-redux 提供的 combineReducers 把 routerRedux 合并到用户的 reducers 中

限于文章的篇幅，dva 的 model 的设计会放到下一次的文章来描述

引入 ANTD

按需加载

在引入 ANTD 之前，我们先来实现 按需加载 。其实概念很简单，就是我们在引入一个样式库的时候，往往只会用到这个样式库的部分组件，但是工具会把整个组件库都打包到我们的项目中，这是我们不想看到的。按需加载 就是用来打包我们引入的组件，可以使用 babel-plugin-import 来具体实现。

在 task/config.js 的 babel-loader 的 plugins 配置中添加:
["import", { "libraryName": "antd", "style": true }]

自定义主题

由脚手架 atool-build 和官网介绍，我们已经自己配置并新建好了主题文件 theme.js 。

添加 less-loader 处理样式文件

上节我们只是添加了对 .module.less 文件进行编译，在自定义主题时，需要对 less 变量进行覆盖，所以要求 babel-plugin-import 的 style 选项设置为 true ，让它导出 antd 组件的 .less 样式文件才能进行变量覆盖操作。

在 task/config.js 中 module.rules 追加

{
    test: function(path){
        return /\.less$/.test(path) && !/\.module\.less$/.test(path)
    },
    loader: ExtractTextPlugin.extract({
        fallback: 'style-loader', 
        use: [
            {
                loader: 'css-loader', 
            },
            {
                loader: 'postcss-loader',
                options: {
                    plugins: postcssPlugins
                }
            },
            {
                loader: 'less-loader', 
                options: {"modifyVars": theme}
            }
        ]
    })
},

注意 /\.less/ 至少会匹配到 .module.less 和 .less 文件，所以要排除 .module.less ，因为它需要被 css-module 处理。

你也可能会通过添加 exclude , include 来对样式库中的 less 文件和自己编写的文件进行区别，毕竟样式库肯定都是从 node_modules 目录中加载，而自己的是从 src 目录下加载的。也正因为样式库是从 node_modules 目录下加载的，所以这样做可能会导致降低 webpack 的编译速度。

添加容器组件和展示组件

容器组件

在 /src/containers 下新建 App.js

import React, { PropTypes } from 'react'
import { connect } from 'dva'
import { Layout, Menu, Breadcrumb, Row, Col, Icon } from 'antd'
import HeaderComponent from 'components/Header'
import FooterComponent from 'components/Footer'
import LoginModel from 'components/Login'
const { Header, Content, Footer } = Layout

const App = ({children, routes}) => {
    return (
        
            
                
                     {}} />
                
            
            
                {children}
            
            
                
            
        
    )
}

export default connect()(App)

因为 dva 封装了 redux ，源文件中也是直接导出 react-redux 的 connect 方法。所以在创建容器组件的时候还是等同于 react-redux 。

注意，这个 App组件是作为子路由组件的父组件，即 children 代表的就是那些子组件 Home , Archive …

其他的展示组件，即 /src/containers 文件夹下面的组件，都是大同小异，就不一一赘述。

展示组件

我们看到 src/container/App.js 展示组件，引入了一个 HeaderComponent ，在 src/components 下面新建一个 Header.js

import React from 'react'
import { Layout, Menu, Breadcrumb, Row, Col } from 'antd'
import { Router, Link } from 'dva/router'

const HeaderComponent = (props) => {
    const { children, routes } = props
    const routePath = (routes[routes.length - 1] || {}).path || '/'
    return (
        
            
                
                    
                        Home
                        Archive
                        About me
                    
                
                
                    
                        {children}
                    
                
            
        
    )
}

export default HeaderComponent

这就是个普通的 React 的展示组件没什么好说的，这些组件可以直接在 Antd 的官网上找到用法，而且都有示例代码。

const routePath = (routes[routes.length - 1] || {}).path || '/'
找到路由路径中的最后一个名称，如 /home 中的 home ，作为 Menu 的默认选中项，这样在当前页面刷新，就可以让当前页面对应的导航高亮。

其他的展示型组件也都是大同小异，你可以在 github仓库中找到它们的实现。

引入 url-loader 来处理文件路径

在 task/config.js 中的 module.rules 追加：

{
    test: /\.(png|jpe?g|gif|svg)(\?.*)?$/,
    loader: 'url-loader',
    options: {
        limit: 10000,
        name: 'img/[name].[hash:7].[ext]'
    }
},
{
    test: /\.(woff2?|eot|ttf|otf)(\?.*)?$/,
    loader: 'url-loader',
    options: {
        limit: 10000,
        name: 'fonts/[name].[hash:7].[ext]'
    }
},

关于 url-loader 的配置方法，可以在 webpack 的文档中查看

小结

这篇文章主要是引入了两个重要的库 dva 和 antd ，以及编写部分展示组件。接下来，我们会对 dva 的数据层，已经后台初步搭建，同步进行前后端的开发。