【单页面博客从前端到后端】基于 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 react-router@2.x. (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 (
        <Router history={history}>
            <Route path="/" component={AppLayout}>
                <IndexRoute component={Home} />
                <Route path="archive" component={Archive} />
                <Route path="about" component={About} />
                <Route path="article/:id" component={Article} />
                <Route path="admin" component={AdminLayout}>
                    <IndexRedirect to="articles" />
                    <Route path="articles" component={AdminArticles} />
                    <Route path="keywords" component={AdminKeywrods} />
                    <Route path="editor" component={AdminEditor} />
                </Route>
            </Route>
        </Router>
    )
}

从这里能够看出， 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 (
        <Layout>
            <Header>
                <HeaderComponent routes={routes}>
                    <LoginModel doLogin={() => {}} />
                </HeaderComponent>
            </Header>
            <Content style={{ margin: '24px 100px 0', background: '#fff', minHeight: 280, overflow: 'hidden' }}>
                {children}
            </Content>
            <Footer>
                <FooterComponent />
            </Footer>
        </Layout>
    )
}

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 (
        <div>
            <Row>
                <Col span={16}>
                    <Menu
                        mode="horizontal"
                        defaultSelectedKeys={[routePath]}
                        style={{ lineHeight: '64px', backgroundColor: 'transparent' }}
                    >
                        <Menu.Item key="/"><Link to="/">Home</Link></Menu.Item>
                        <Menu.Item key="archive"><Link to="archive">Archive</Link></Menu.Item>
                        <Menu.Item key="about"><Link to="about">About me</Link></Menu.Item>
                    </Menu>
                </Col>
                <Col span={8}>
                    <div style={{ lineHeight: '64px', float: 'right', padding: '0 20px' }}>
                        {children}
                    </div>
                </Col>
            </Row>
        </div>
    )
}

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 的数据层，已经后台初步搭建，同步进行先后端的开发。

• 【单页面博客从前端到后端】环境搭建

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

• 【单页面博客从前端到后端】基于 Passport 和 Koa@2 的权限验证与 DVA 的 Model 设计