zz.js v2.0 一个可以用来做项目的ssr开发骨架,基于 koa2 + react16 + router5 + wp4 搭建
zz.js v2.0 一个可以用来做项目的ssr开发骨架,基于 koa2 + react16 + router5 + wp4 搭建
node10+ babel7 react-router5 webpack4
ssr 学习参考资源 从这里开始你将了解到怎样让 zz 在本地快速的跑起来,然后进行实际项目开发。
首先你需要安装 node ,并且确保 node 版本是10.0或以上。mac 下推荐使用 nvm 来管理 node 版本)
$ node -v
10.0x为了方便我们创建应用和页面,这里提供了一个配套的 zz-cli 脚手架。
先全局安装脚手架。
$ npm i zzjs-cli -g
//初始化项目
$ zzjs -i
$
$ cd
$ npm i
$ npm run dev //本地开发的watch 模式
$ open http://:9001可通过不同的命令开启不同的渲染模式。
$ npm run dev //开启本地开发 可修改配置内的属性 __IS_SSR__ 来支持两种渲染模式
$ //更多.....├── dist // 生产环境打包后的资源目录
│ ├── static //打包的静态资源文件
│ ├── server //用于同构的运行于 node 端的文件
| │ ├── app.js //服务启动入口
├── docs // 帮助文档
├── src // 开发时 react 组件相关代码
│ ├── server //服务端代码目录
│ ├── client //页面和组件目录
| │ ├── app //应用入口
│ │ ├── layout //layout 组件
│ │ ├── index.js //webpack entry 打包入口
│ ├── pages // 业务页面
│ │ ├── index //默认首页
│ ├── router // 路由相关
│ ├── share //存放公共代码
├── test // 单页测试
├── webpack //构建配置页面入口
关于/src/pages/下每个页面的入口的约定,目前只支持一级路由的设置,所有的页面的入口都是 index.js, zz内部会自动进行识别。
路由约定
每个页面的路由配置的方式不再是集中式配置,而是分治配置,每个页面对应一个路由配置,请按照下面的格式进行配置
举个栗子
// /src/pages/index 页面目录
// /src/pages/index/config/route.js 路由配置
//路由代码,可以方便的设置路由是否按需加载
import React from 'react';
import BaseBundle from '../../../routes/route-base-bundle';
//import LazyPageCom from '../index'; //静态组件模式
//动态组件配置
const LazyPageCom = (props) => (
import(/*webpackChunkName:"chunk-index"*/'../index')}>
{(CompIndex) => }
);
//一个页面组件可配置多个路由入口
export default [
{
path:'/',
component: LazyPageCom,
exact:true
},{
path: '/index',
component: LazyPageCom
}
]
你只需要修改 webpackChunkName 的名称和 export 导出的数据即可,当然也可以对当前页面配置多个路由.
可通过脚手架快速的创建页面
$ cd
//初始化项目
$ zzjs -p
$
$ open http://:8808/为了方便维护和扩展,zz 把路由进行了分治管理,每个页面的路由都是独立的,只需要单独的配置即可。
请参考路由约定
数据预取的目的是在 node 端渲染组件前提前从接口或者某个数据源获取到数据,也可以让某个页面在 CSR 下可以拿到数据,进行组件的 update。
为了方便的实现同构我们在页面组件内约定了一个数据预取的静态方法 getInitialProps,当前页面首屏数据都是从这个方法内进行返回。
…在 数据预取同构 已经看到了 getInitialProps 方法返回的数据是一个固定的格式,结果内包含一个 page字段.
page 字段表示的就是当前页面的 SEO 的信息.
//此处代码已略
return {
page:{
tdk: {
title: 'ksr 框架',
keyword: 'ssr react',
description: '我是描述'
}
},
fetchData: resArr
} 一个page 的渲染
页面组件需要继承一个 zz 的基础组件 ZzPageBase,为我们封装了一些基础数据获取和存储功能.
需要设置 static contextType = RootContext 为的是让组件可以获得全局的数据.
实现 static async getInitialProps 数据预取方法.
componentDidMount 内是否需要做数据的更新,如果需要更新可以调用getInitialProps方法.
参考完整代码
…__SERVER__ 常量、表示当前是否是服务端渲染,经常会在组件内被使用
this.isSSR 常量、表示当前页面的渲染是服务端渲染还是客户端渲染
this.hasSpaCacheData 常量 、 表示当前页面内是否有伪 pwa 的数据
可以加作者微信:223344386,备注"进群".
笔 名: 前端双月 (zz_jesse)
公众号: 前端技术江湖
No open issues yet, or sync has not completed.