Next.js 实战项目 | 青训营笔记

109 阅读6分钟

  这是我参与【第五届青训营】伴学笔记创作活动的第4天。

课程目标

  具备C端Web应用开发的基本能力

CSR,SSR,SSG

CSR

  客户端渲染(Client-Side Rendering)。常见B端Web应用开发模式,前后端分离,服务器压力相对更轻,渲染工作在客户端进行,服务器直接返回不加工的HTML用户在后续访问操作。
  SPA:单页面应用,它所需的资源(HTML CSS JS等),在一次请求中就加载完成,不需刷新地动态加载,首屏时间更长。

SSR

  SSR:(Server-Side Rendering)。不是什么新型的概念。从原先的JSP/PHP就已经体现了服务器端渲染。

  • 代码耦合度高,且模板语言中混杂编程语言对于一些复杂的功能。维护起来很痛苦。(一般是旧程序,所有东西都在一起,比较乱,维护难)
  • 这种情况下Java、PHP负责渲染的逻辑,而前端只负责UI和交互。

同构SSR

  前后端一体化,一套React代码在服务器上运行一遍,到达浏览器又运行一遍。前端后端都要参与渲染,而且首次渲染出的HTML要一样。(较常用)

      BFF(Backend For Frontend):服务于前端应用的后端。

SSG

  静态站点生成(Static Site Generation),在构建的时候直接把结果页面输出HTML到磁盘,每次访问直接把html返回给客户端,相当于一个静态资源。

  CND:建立并覆盖在Internet之上,由分布在不同区域的边缘节点服务器群组成的分布式网络。

  • 优势:相比SSR,因为不需要每次请求都由服务器端处理,所以可以大幅减轻服务器端的压力。
  • 劣势:缺陷在于只能用于偏静态的页面,无法生成与用户相关的内容。也就是所有的用户访问的页面都是相同的。

SSR,SSG的优势

1.利于SEO

  浏览器的推广程度,取决于搜索引擎对站点检索的排名,搜索引擎可以理解是一种爬虫,它会爬取指定页面的html。并根据用户输入的关键词对页面内容进行排序检索,最后形成我们看到的结果。

2.更短的首屏时间

  SSR/SSG只需要请求一个HTML文件就能展现出页面。虽然在服务器上会调取接口,但服务器之间的通信要远比客户端快,甚至是同一台服务器上的本地接口调取。
  因为不再需要请求大量js文件,这就使得SSR/SSG可以拥有更短的首屏时间。

什么是Next.js

SSR的实现

  基于React提供的相关服务器端渲染API实现,整个过程实现比较繁琐重复,从零实现对新上手同学很不友好。
  迫切需要一个封装好的集合来快速上手,服务器端渲染。

Next.js

  • Next.js是一个构建于Node.js上的开源Web开发框架。支持基于React的Web应用程序功能。例如服务端渲染和生成静态网站。
  • 上手快,能力集全,而且覆盖了足够多的性能优化和生态。
  • 对于新同学掌握前后端一体化的开发模式很友好。
  • 初始化:npx create-next-app@latest--typescript

Next.js 客户端开发

Next.js初始化

  • next-env.d.ts:确保TypeScript编译器选择Next.js类型可以放到.gitignore中,不需要变更。
  • next.config.js:next.js的配置,我们可以补充webpack的一些配置进行。比如补充一些别名。

数据注入

  数据注入是为了使客户端和服务器端数据同步。

1.   客户端注入:

useEffect(不常用)

2.   getlnitialProps
Article.getlnitialProps = async (context) => {
  const { articleId } = context.query;
  const { data } = await axios.get(`${LOCALDOMAIN}/api/articleInfo`, {
    params: {
      articleId,
      },
    });
    return data;
};

  在服务器端执行,只能在页面层面进行绑定,采用同构。首次渲染服务器端渲染,路由跳转使用客户端路由。
  意味着如果使用router跳转当前页,会在客户端执行部分逻辑。

3.  getServerSideProps
export const getServerSideProps = async (context) => {
  const { articleId } = context.query;
  const { data } = await axios.get(`${LOCALDOMAIN}/api/articleInfo`, {
    params: {
      articleId,
      },
    });
    return {
      props: data,  //需要拿props包裹
    };
};

  SSR。
  与getlnitialProps不同的是即使使用router跳转当前页,也只会在服务端执行这部分逻辑。

4.  getStaticProps
export const getStaticPaths: GetStaticPaths = async () => {
  return {
    paths: [{ params: { articleId: "1"}}],
    fallback: false,
  };
};  //将所有可能的参数情况排列出来,因此不适用于数据量大的情况

export const getStaticProps: getStaticProps = async (context) => {
  const { articleId } = context.params as any;
  const { data } = await axios.get(`${LOCALDOMAIN}/api/articleInfo`, {
    params: {
      articleId,
      },
    });
    return {
      props: data,  //需要拿props包裹
    };
};

  SSG,在服务器端构建时执行。
  如果涉及动态路由(带参数),需要使用getStaticPaths配置所有可能的参数情况j。

CSS Modules

  在类名中加入<div class="styles_layout_ewyWz">
  Next.js支持使用文件命名约定的CSS模块。[name].module.css

Layout

  通过在入口文件导入layout,可以实现每个页面公告的页眉页尾。

文件式路由

  预定义路由优先级更高,预定义路由能直接匹配的路由就不会分发给下面的动态路由。
      三种写法:

1. ./pages/demo/index.tsx => /demo
2. ./pages/demo/[id].tsx => /demo/:id
3. ./pages/demo/[...id].tsx => /demo/a/b/c => id = ["a","b","c"]

  Next.js有一个基于页面概念的基于文件系统的路由器。当一个文件被添加到pages目录中时,它会自动作为一个路径可用。

BFF层的文件式路由


  BFF,作为服务器构建包,不影响客户端构建bundle体积。
  相同的router生成方式,不过是作为API层访问,而不是page。

路由跳转

next / link跳转

import Link from "next/link";

<Link href={item.link} key={index}>
  <div className={styles.card}>
    <h2>{item.label} &rarr;</h2>
    <p>{item.info}</p>
  </div>
</Link>
useRouter跳转
import { useRouter } from 'netx/router'

function ActiveLink({ children, href}) {
  const router = useRouter()
  const style = {
    marginRight: 10,
    color: router.asPath === href ? 'red' : 'black',
  }
  
  const handleClick = (e) => {
    e.preventDefault()
    router.push(href)
  }
  
  return (
    <a href={href} onClick={handleClick} style={style}>
      {children}
    </a>
  )
}

export default ActiveLink

  除了这些之外,还可以使用原生方法跳转,不过原生的方法不会进行Diff对比渲染,性能上Nextjs提供的路由跳转会更好。

header的修改

  可用于修改TDK(title,description,keywords)

多媒体适配 ---- CSS适配

  1. 极小分辨率移动端设备
@mixin media-mini-mobile {
  @media screen and (max-width: 25.875rem){
    @content;
  }
}
  1. 介于极小分辨率和正常分辨率之间的移动端设备
@mixin media-between-mini-and-normal-mobile {
  @media screen and (min-width: 25.876rem) and (max-width: 47.9375rem){
    @content;
  }
}
  1. 移动端设备
@mixin media-mobile {
  @media screen and (max-width: 47.9375rem){
    @content;
  }
}
  1. ipad
@mixin media-ipad {
  @media screen and (min-width: 47.9375rem) and (max-width: 75rem){
    @content;
  }
}

多媒体适配 ---- JS适配

大图优化 - webp

// ./utils/index.ts
export const getIsSupportWebp = (context: AppContext ) => {
  const { headers = {} } = context.ctx.req || {};
  return headers.accept?.includes("image/webp");
}

Next.js 服务端开发

BFF层开发

  和Express等开发类似
  区别是并没有参数可以直接区别请求类型

调试方式

Strapi - headless CMS


  初始化:npx create-strapi-app my-project--quickstart

  一个接口的生成有以下几个过程:

  1. content-type builder 编辑结构体
  2. content manager 配置数据源,并且发布
  3. settings roles 里选择对应的角色并勾选要发布的接口类型
  4. 如果涉及嵌套,在接口后加上populate=deep参数(npm install strapi-plugin-populate-deep--save),没安装的需加参数populate=*,但只能嵌套一层。

核心功能讲解

首页功能实现

  1. 页面 & 动画 & 多媒体适配
  2. BFF
  3. Strapi

文章页实现

  1. 页面 & 动画 & 多媒体适配
  2. BFF
  3. Strapi分页(/api/articles?pagination[page]=1&pagination[pageSize]=10)//按10个/页分页,返回第一页的数据
  4. 多媒体格式的转换
  • markdown 转 html:npm install showdown--save
  • html 转 dom:dangerouslySetlnnerHTML
  • 公共样式的定义

主题化功能实现

  1. 基础样式和背景的抽离
  2. 主题化context全局注入
  3. 从注入数据中取出theme 和 setTheme
  4. 多进程间的主题同步