概述
本文是《使用React技术栈的一些收获》系列文章的第一篇(第二篇在这里,介绍了React的一些原理)。这篇文章则介绍了大型React项目是如何架构的以及架构的原理和思想。项目背景是一个博客发布平台,类似于简书,项目地址时光笔记(还未完善...)
具体技术栈
项目技术栈使用的是React全家桶:React+redux+react router+es6+webpack+sass
以及Data到View层我们使用了reselect
。由于数据处理逻辑并不复杂,因此并没有使用immutable.js
和Redux saga
(后来我觉得连Redux
都没必要用);样式方面考虑到可读性和开发人数较少(俩),我们并没有使用流行的css-module。
脚手架的选择
选择脚手架就选择了整体架构,我选择的是davezuko大神的react-redux-starter-kit,也是最受欢迎的脚手架之一。并在它的基础上安装了一些用到的包,删去了一些不用的包,让它更适合我们的项目。
项目架构
项目目录如下:
根据脚手架的架构,我们构建的是一个React单页应用。
总体来说
就是采用React router plain object
+combineReducer
+require.ensure
的写法把不同的路由分割在routes目录下,对应不同的页面,做代码分割、按需加载。逻辑图如下:
具体来说
首先src目录下有一个main.js
,它用来创建store
,并拿到路由(plain object
形式),然后注入到顶层的Provider
组件和其下的Router
组件:
src下的main.js文件:
const initialState = window.___INITIAL_STATE__ const store = createStore(initialState)// 创建store const MOUNT_NODE = document.getElementById('root') let render = () => { const routes = require('./routes/index').default(store)// 拿到路由 ReactDOM.render( <AppContainer store={store} routes={routes} />,//注入 MOUNT_NODE ) }
redux
的store
也随着页面分割而分割:
不同页面下的modules下的文件只负责本页面所需的所有action
和reducer
,并通过加载页面inject
主reducer
里,然后在src/store/reduce.js文件里combine
,最后被引入到src/store/createStore里和同时引入的redux中间件一起创建store
:
src/store目录下的reducer.js:
export const makeRootReducer = (asyncReducers) => { return combineReducers({ auth: auth,form: formReducer,location: locationReducer,...asyncReducers // 各页面下的reducer注入到这里 }) } export const injectReducer = (store,{ key,reducer }) => { store.asyncReducers[key] = reducer store.replaceReducer(makeRootReducer(store.asyncReducers))//注入时更新 }
以及src/store下的createStore文件:
const store = createStore( makeRootReducer(),initialState,compose( applyMiddleware(...middleware),...enhancers ) )
routes
目录下有一个index.js
文件,它使用plain object
的写法集合各路由对应的页面;
routes下的index.js文件:(用来包含各页面)
src/routes/index.js:(采用React router plain object
写法)
import CoreLayout from '../layouts/CoreLayout' import Home from './Home' import FollowRoute from './Follow' import SignRoute from './Sign' import HallRoute from './Hall' import UserPageRoute from './UserPage' import PageNotFound from './PageNotFound' import Redirect from './PageNotFound/redirect' export const createRoutes = (store) => ({ path: '/',component: CoreLayout,indexRoute: Home,childRoutes: [ // 各页面 FollowRoute(store),SignRoute(store),HallRoute(store),UserPageRoute(store),PageNotFound(),Redirect ] })
每个页面目录下也有一个index.js
文件并使用getComponent
+ webpack ensure
按需加载页面的container
和reducer
:
每个页面下的index.js文件:(负责输出这个页面)
src/routes/sign/index.js(其他页面差不多,举个例子)
import { injectReducer } from '../../store/reducers'// 引入注入reducer函数 export default (store) => ({ path: 'sign',//页面路由 getComponent (nextState,cb) { require.ensure([],(require) => { // webpack按需加载 const Sign = require('./containers/SignContainer').default //引入总container const reducer = require('./modules/index').default//引入总reducer injectReducer(store,{ key: 'sign',reducer })// 加载时注入页面reducer到主reducer cb(null,Sign)// 返回页面 }) } })
在每个页面下,index.js是获得每个页面的入口,每个页面都有自己的components
和containers
以及actions
和reducers
,目录看起来像这样:
components
和containers
都是这个页面下的组件和容器,如果其他页面也会使用里面的组件和容器,就会把他们放在src/component和src/containers下共用。modules下的文件是这个页面所有的action和reducer。如果页面逻辑可以分离,会把各逻辑下的reducer抽离并单开一个index.js,并在其中combine:
=>
总结与反思
通过上述架构,项目代码逻辑变得很清晰,每一个文件都有其专属的功能,互不影响,开发过程变得工程化、流程化,思路很清晰,代码出错率大大降低,开发速度大大提高。React router plain object
+redux combineReducer
的组合很好的将代码按不同页面做了分割;而 getComponent
+ webpack ensure
又做到了页面的按需加载,项目页面运行速度提升了不少。但是有一个问题,在react route4.0版本中getComponent
被移除了,并提供了更加简洁的方式(实际上就是替你做了按需加载):Bundle组件+webpack 加载器undle-loader。使用这种方式的话,目录结构将会变得更简单、更容易理解,避免了多层嵌套,因此,项目还需要改善。