Next.js

EricYangXD 2023/5/16

# Next.js

npx create-next-app@latest my-next-app
路由按文件结构自动设置
默认用 page 作为 index 入口。根目录下：page.js创建一个路由的独特 UI，并使路径可以公开访问；route.js为一个路由创建服务器端 API 端点。
文件夹用()包裹，可以做权限判断
文件夹用[]包裹，可以做路由传参
文件夹用[...xxx]的形式，可以做多层级路由传参：shopcart/1/phone/apple/14，都会在 props 的 params 中，返回数组。也可以app/[categoryId]/[itemId]/page.js -- { categoryId: string, itemId: string }
o: 静态
λ: 动态
export const dynamic = true; 在 page 中使用这种方法可以设置该页面为动态页面、静态页面等。
export const revalidate = 10; 在 page 中使用这种方法可以设置该页面中的请求缓存 10s？类似 fetch 中的第二个参数 next 的 revalidate。可以把页面转成静态的。
export async function generateStaticParams(){...}: 生成静态参数，也可以把页面转成 SSG：服务端生成页面。
在layout中可以配置export const metadata={title:'xxx',description:'xxx'};做 SEO。也可以配置页面输出布局结构、国际化等，类似 main，根目录下的 layout 不可删除，控制其所有的 children 显示（同层级）。
export async function generateMetadata(){...}:做 SEO
根目录下创建sitemap.ts，做 SEO

export default async function sitemap() {
  const res = await fetch("https://jsonplaceholder.typicode.com/todos/1");
  const allPosts = (await res.json()) as Post[];

  const posts = allPosts.map((post) => {
    return {
      url: `http://localhost:3000/post/${post.id}`,
      lastModified: new Date().toISOString(),
    };
  });

  const routes = ["", "/about", "/post"].map((route) => {
    return {
      url: `http://localhost:3000${route}`,
      lastModified: new Date().toISOString(),
    };
  });

  return [...posts, ...routes];
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

根目录下添加一张图片并命名为opengraph-image.png作为 Open Graph image。。。每个组下面都可以添加。
app/api/user/route.ts: route 是固定写法，访问http://localhost:3000/api/user即可获取 mock 接口数据
export const runtime = 'edge'; 定义运行的环境
template.js与layout.js类似，只是在导航时安装一个新的组件实例。除非你需要这种行为，否则请使用 layouts。
layout.js为一个段和它的子段创建共享的用户界面。一个布局包裹着一个页面或子段。类似 vue 中的router-view或者 react 中的<Layout></Layout>
loading.js将一个页面或子段包裹在React Suspense Boundary中，在它们加载时显示加载 UI。
error.js将一个页面或子段包裹在 React 错误边界中，如果发现错误，就会显示错误 UI。
global-error.js与error.js类似，但专门用于捕捉根layout.js中的错误。
not-found.js当 notFound 函数在一个路由段中被抛出时，或者当一个 URL 没有被任何路由匹配时，创建 UI 来显示。
Metadata 元数据可以通过在 layout.js 或 page.js 文件中导出一个元数据对象或 generateMetadata 函数来定义。
要使用<Link>，请从next/link中导入它，并向组件传递一个href，类似 react，用来跳转
获取 pathName：import { usePathname } from 'next/navigation'; const pathname = usePathname();
要使用useRouter hook，请从next/navigation导入，并在你的客户端组件中调用钩子：const router = useRouter(); router.push('/dashboard');
一个路径下有多个子路径时也是用 layout 来处理.
要创建多个根布局，移除顶层的 layout.js 文件，并在每个路由组内添加 layout.js 文件。这对于将一个应用程序分割成具有完全不同的用户界面或体验的部分很有用。<html>和<body>标签需要被添加到每个根布局中。
parallel routes或者一个路径下的同级子路径，要同时显示出来，那么子路径定义时要用@加在子路径名称之前。然后就可以同时在父路径下展示了。父路径的 layout 可以通过 props 接收子路径的 ReactNode。相当于 slot 插槽的功能。
值得注意的是：children prop是一个隐含的插槽，不需要映射到一个文件夹。这意味着app/page.js等同于app/@children/page.js。你可以定义一个default.js文件，在 Next.js 无法根据当前 URL 恢复槽的活动状态时，作为后备文件呈现。
layout 不能接受 searchParams 参数。
在客户端组件中使用 page 的 searchParams 属性或 useSearchParams 钩子，他们在客户端和最新的 searchParams 重新渲染了。

Jest Mock数据

木易的OT

Choose mode

Next.js

Next.js

# Next.js