博客
关于我
强烈建议你试试无所不能的chatGPT,快点击我
用Next.js快速上手React服务器渲染
阅读量:6044 次
发布时间:2019-06-20

本文共 8809 字,大约阅读时间需要 29 分钟。

hot3.png

新前端时代的服务端渲染也提了很久了,各种技术演进层出不穷。

带你领略一下基于React和Nodejs架构的服务端渲染技术,让你快速上手,开发Next服务端渲染的项目。

本文参考官方文档,做精简总结,用一些小例子,让你快速理解Next.js项目的开发。

全文3800字左右,阅读全文约15分钟。

 

本文同步发表于知乎专栏:前端微志。欢迎关注。

什么是服务端渲染?

 

服务端渲染,是指页面的渲染和生成由服务器来完成,并将渲染好的页面返回客户端。而客户端渲染是页面的生成和数据的渲染过程是在客户端(浏览器或APP)完成。

随着前后端分离模式的兴起,从服务端渲染到服务端渲染的演进,前端Web App给前端开发带来了很大的便利,并减轻后端服务器压力。

前后端解耦,让前端专注做好用户UI层,专注于提升用户体验,让后端专注于业务逻辑处理,分离成微服务,专心做好一件事。

前后端分离前的服务端渲染技术有:PHP,ASP,JSP等方式,分离后的前端SPA(单页面应用)渲染拥有独立的路由和页面渲染(React,Vue和Angular等),而SPA的最大问题是对SEO不友好,当项目对SEO有需求时,SPA就不是一个好的选择。

近两年来,React和Vue也开始支持服务端渲染(Server Side Render ),行业内也有这方面的实践,其中掘金就使用Vue的SSR功能做了全站服务端渲染,且效果良好。

我们现在介绍一个React生态中表现突出的服务端渲染框架:Next.js。

Next.js是什么?它有什么优点?

 

 

 

640?wx_fmt=png&tp=webp&wxfrom=5&wx_lazy=1

 

Next.js是一个基于React的一个服务端渲染简约框架。它使用React语法,可以很好的实现代码的模块化,有利于代码的开发和维护。

Next.js带来了很多好的特性:

  • 默认服务端渲染模式,以文件系统为基础的客户端路由

  • 代码自动分隔使页面加载更快

  • (以页面为基础的)简洁的客户端路由

  • 以webpack的热替换为基础的开发环境

  • 使用React的JSX和ES6的module,模块化和维护更方便

  • 可以运行在Express和其他Node.js的HTTP 服务器上

  • 可以定制化专属的babel和webpack配置

怎么开始构建一个Next.js项目?

 

 

在开始构建Next.js项目之前,需要做好一些准备:

  1. 首先,不管你使用哪个操作系统,你需要一个趁手的命令行工具,在Mac系统和Linux下自带的命令行工具比较好用,在Windows系统下,我推荐一个命令行工具:Cmder;

  2. 已经在本地安装好Nodejs和Npm;

  3. 熟悉React技术栈开发及ES6语法;

  4. 熟悉Express架构的Nodejs开发。

下面开始构建一个Next.js项目。

创建项目

在命令行工具中依次执行下面语句:

// 在本地创建一个项目跟目录$ mkdir hello-next // 切换到项目根目录$ cd hello-next// 用npm初始化项目$ npm init -y// 将react和next安装到本地依赖$ npm install --save react react-dom next// 创建文件夹 pages$ mkdir pages

创建完文件夹之后,打开hello-next文件下的package.json文件,在 scripts 下添加一个script,如下:

{  "scripts": {    "dev": "next"  }}

至此,项目准备工作完成,运行下面这条命令开启项目服务器:

$ npm run dev

命令执行完毕后,在浏览器中打开 http://localhost:3000,你会看到这样的页面:

640?wx_fmt=png&tp=webp&wxfrom=5&wx_lazy=1

这个页面是Next.js默认生成的404页面,而开启服务后访问的之所以是404页面,是因为我们还没有设置项目主页。

创建页面

Next.js是从服务器生成页面,再返回给前端展示。Next.js默认从 pages 目录下取页面进行渲染返回给前端展示,并默认取 pages/index.js 作为系统的首页进行展示。注意,pages 是默认存放页面的目录,路由根路径也是pages目录。

在 pages/index.js 中创建一个React函数式组件:

const Index = () => (  

Hello Next.js

)export default Index

Next.js默认使用Webpack构建项目,webpack的热部署功能一样能提升开发效率。创建完 pages/index.js 后,再访问 http://localhost:3000 即可看到设置好的页面。

多页面构建

使用Next.js的目的就是构建非SPA的多页面项目。下面开始构建多页面应用,创建第二个页面。

在 pages 目录下创建文件 pages/about.js :

export default () => (  
   

This is the about page

 
)

创建完之后,可以通过 http://localhost:3000/about 访问该页面。至此,所有的页面的路由都是通过后端服务器来控制的,要想实现客户端路由,需要借助Next.js的Link API

Link API

从 next/link中可以引用到 Link 组件。在pages/index.js文件中引用Link,修改如下:

// This is the Link APIimport Link from 'next/link'const Index = () => (  
   
     
About Page        

Hello Next.js

 
)export default Index

在浏览器中访问首页 http://localhost:3000 时,点击 About Page即可跳转到about页面

Link组件是通过location.history的浏览器API保存历史路由,所以,你可以通过浏览器左上角的前进后退按钮来切换历史路由。而在开发过程中,你不需要再单独写客户端路由的配置。

Link组件是React的高阶组件的实现,不能对它进行样式的设置,它只是起到路由的跳转功能,但是它的复用性强,只要包含一个能触发onClick事件的组件即可。

组件复用

Next.js是以多页面为中心,只要将页面文件放在pages目录下,就可以在浏览器上以文件名为路由名来访问到。

组件的设置跟React一样,通过export导出,通过import导入。一般,只要不想让用户通过页面直接访问的组件,都不放在pages目录下。对除了pages目录,组件放在哪个目录下没有要求,开发者可以自定义设置。

下面再 components 目录下,创建一个公用组件 Header,用于各个文件的头部导航,通过导航可以在页面见切换。

import Link from 'next/link'const linkStyle = {  marginRight: 15}const Header = () => (  
   
     
Home        
     
About      
)export default Header

在 pages/index.js 中引入Header:

import Header from '../components/Header'export default () => (  
   
   

Hello Next.js

 
)

在 pages/about.js 中同样引入 Header 组件,在浏览器上通过点击导航切换页面。

0?wx_fmt=gif&tp=webp&wxfrom=5&wx_lazy=1

 

进一步封装Header组件,创建一个自动包含Header和Content的组件 components/MyLayout.js:

import Header from './Header'const layoutStyle = {  margin: 20,  padding: 20,  border: '1px solid #DDD'}const Layout = (props) => (  
   
   {props.children}  
)export default Layout

创建动态页面

使用Next.js创建动态页面,与使用React或Vue创建一个SPA页面大体相同,唯一的区别就是页面的渲染主体不同,前者是Nodejs服务器获取到后端数据渲染完页面后再返回给前端展示,后者是前端先获取页面主体架构,再通过ajax的方式请求后端的数据,在前端渲染展示。

以一个简易的博客页面为例,创建博客列表页,修改 pages/index.js:

import Layout from '../components/MyLayout.js'import Link from 'next/link'const PostLink = (props) => (  
  •    
         {props.title}      
  • )export default () => (  
       

    My Blog

       
           
           
           
         
     
    )

    访问 http://localhost:3000/ 访问,页面如下:

    640?wx_fmt=png&tp=webp&wxfrom=5&wx_lazy=1

    有了列表页,需要再写一个博客的详情页,从上面的代码中也可看到,我们需要创建一个 pages/post.js 文件:

    import Layout from '../components/MyLayout.js'export default (props) => (  
       

    {props.url.query.title}

       

    This is the blog post content.

     
    )

    在博文列表页,点击博文名可跳转到对应博文的详情页。

     

    640?wx_fmt=png&tp=webp&wxfrom=5&wx_lazy=1

    用路由遮盖(Route Masking)的干净的URL

    Next.js上提供了一个独特的特性:路由遮盖(Route Masking)。它可以使得在浏览器上显示的是路由A,而App内部真正的路由是B。这个特性可以让我们来设置一些比较简洁的路由显示在页面,而系统背后是使用一个带参数的路由。比如上面的例子中,地址栏中显示的是 http://localhost:3000/post?title=Hello%20Next.js ,这个地址含有一个title参数,看着很不整洁。下面我们就用Next.js来改造路由,使用路由遮盖来创建一个更加简洁的路由地址。比如我们将该地址改造成 http://localhost:3000/p/hello-nextjs。

    首先我们要修改 pages/index.js 下的PostLink组件,会使用到 next/link 组件的 as 属性,并给组件添加一个属性 id:

    import Layout from '../components/MyLayout.js'import Link from 'next/link'const PostLink = (props) => (  
  •    
         {props.title}      
  • )export default () => (  
       

    My Blog

       
           
           
           
         
     
    )

    当在 Link 组件上使用 as 属性时,浏览器上显示的是 as 属性的值,走的是客户端路由,而服务器真正映射的是 href 属性的值,走的是服务端路由。

    这样就会有一个问题,如果在前端路由间切换不会有问题,可以正常显示,但是在页面 http://localhost:3000/p/hello-nextjs 时刷新页面,会显示 404页面。这是因为路由遮盖默认只在客户端路由中有效,要想在服务端也支持路由遮盖,需要在服务端单独设置路由解析的方法。

    服务端支持路由遮盖

    上面说到,服务器默认不支持路由遮盖,要让服务器支持它,需要单独对路由进行设置。下面以 Express (你也可以使用Koa等其他Nodejs的Web服务器框架)创建后端服务器讲解如何设置服务器来支持路由遮盖

    首先需要将 express 安装到项目依赖中:

    $ npm install --save express

    在项目目录下创建 server.js ,添加内容如下:

    const express = require('express')const next = require('next')const dev = process.env.NODE_ENV !== 'production'const app = next({ dev })const handle = app.getRequestHandler()app.prepare().then(() => {  const server = express()  server.get('/p/:id', (req, res) => {    const actualPage = '/post'    const queryParams = {         title: req.params.id     }     app.render(req, res, actualPage, queryParams)  })  server.get('*', (req, res) => {    return handle(req, res)  })  server.listen(3000, (err) => {    if (err) throw err    console.log('> Ready on http://localhost:3000')  })}).catch((ex) => {  console.error(ex.stack)  process.exit(1)})

    并更新 package.json 文件中的 scripts :

    {  "scripts": {    "dev": "node server.js"  }}

    这时候,服务器已经可以支持路由遮盖了,在显示遮盖路由的页面,刷新页面也可以正常显示内容。具体的实现是在服务器中对 /p/* 开头的路由进行重写,然后重定向到 /post 开头的路由上,最后将内容返回给前端。具体代码是这一段:

    server.get('/p/:id', (req, res) => {  const actualPage = '/post'  const queryParams = {       title: req.params.id   }   app.render(req, res, actualPage, queryParams)})

    请求接口,获取数据

    Next.js 在 React 的基础上为组件添加了一个新的特性: getInitialProps (有点像是getInitialState),它用于获取并处理组件的属性,返回组件的默认属性。我们可以在改方法中请求数据,获取页面需要的数据并渲染返回给前端页面。

    引入一个支持在客户端和服务器端发送 fetch 请求的插件 isomorphic-unfetch,当然你也可以使用 axios 等其他工具。

    $ npm install --save isomorphic-unfetch

    然后修改 pages/index.js 里的内容,换成下面这样:

    import Layout from '../components/MyLayout.js'import Link from 'next/link'import fetch from 'isomorphic-unfetch'const Index = (props) => (  
       

    Batman TV Shows

       
           {props.shows.map(({show}) => (        
    •          
                 {show.name}                  
    •      ))}    
     
    )Index.getInitialProps = async function() {  const res = await fetch('https://api.tvmaze.com/search/shows?q=batman')  const data = await res.json()  console.log(`Show data fetched. Count: ${data.length}`)  return {    shows: data  }}export default Index

    上述代码中,在 getInitialProps 中使用了 async 和 await 来处理异步请求,并将取到的数据当做一个属性赋给页面,页面拿到这个属性的值后会用于页面的初始化渲染。页面展示效果如下图:

     

    640?wx_fmt=png&tp=webp&wxfrom=5&wx_lazy=1

    样式化组件

    Next.js 提供了一个 css-in-js 的特性,它允许你在组件内部写一些样式,你只需要在组件内使用 <style jsx> 标签来写 css 即可。举个例子,比如我们在 pages/index.js 里添加样式:

    import Layout from '../components/MyLayout.js'import Link from 'next/link'function getPosts () {  return [    {       id: 'hello-nextjs',       title: 'Hello Next.js'    },    {       id: 'learn-nextjs',       title: 'Learn Next.js is awesome'    },    {       id: 'deploy-nextjs',       title: 'Deploy apps with ZEIT'    }  ]}export default () => (  
       

    My Blog

       
           {getPosts().map((post) => (        
    •          
                 {post.title}                  
    •      ))}    
       
     
    )

    在上述代码中,我们没有直接使用 <style> 标签来书写样式代码,而是写在一个模板字符串({``})里面。Next.js 使用 babel插件来解析 styled-jsx ,它支持样式命名空间,未来还将支持变量赋值。

    需要注意的是:styled-jsx 的样式不会应用到子组件,如果想要该样式适用于子组件,可以在 styled-jsx 标签添加属性 global:<style jsx global>。

    怎么部署一个next.js项目

    Next.js 项目的部署,需要一个 Node.js的服务器,可以选择 Express, Koa 或其他 Nodejs 的Web服务器。本文中以 Express 为例来部署 Next 项目。

    服务器的入口文件就使用上文中提到的 server.js,在 server.js 里添加了针对部署环境的选择,代码如下:

    const dev = process.env.NODE_ENV !== 'production'

    为了区分部署环境,我们需要在 package.json 中修改 script 属性如下:

     

    "scripts": {  "build": "next build",  "start": "NODE_ENV=production node server.js -",  "dev": "NODE_ENV=dev node server.js"}

    其中,build 命令是用于打包项目,start 命令是用于生产环境部署,dev 命令是用于本地开发。

    执行如下命令即可将 Next项目 部署到服务器:

    $ npm run build$ npm run start

    执行完命令后,可在 http://host:3000 访问。其中,host 是指服务器的IP地址。

    转载于:https://my.oschina.net/u/3053883/blog/1941574

    你可能感兴趣的文章
    Excel技巧之——英文大小写转换(转)
    查看>>
    Google 翻译的妙用
    查看>>
    常用的集合
    查看>>
    Unity3D工程源码目录
    查看>>
    杀死进程命令
    查看>>
    cookie 和session 的区别详解
    查看>>
    Mongodb对集合(表)和数据的CRUD操作
    查看>>
    Target runtime Apache Tomcat is not defined.错误解决方法
    查看>>
    VC++ 监视文件(夹)
    查看>>
    【转】keyCode对照表及JS监听组合按键
    查看>>
    [Java开发之路](14)反射机制
    查看>>
    mac gentoo-prefix安装git svn
    查看>>
    浅尝异步IO
    查看>>
    C - Train Problem II——(HDU 1023 Catalan 数)
    查看>>
    Speak loudly
    查看>>
    iOS-在项目中引入RSA算法
    查看>>
    [译] 听说你想学 React.js ?
    查看>>
    gulp压缩合并js与css
    查看>>
    块级、内联、内联块级
    查看>>
    Predicate
    查看>>