Nextjs App Router：包含真实示例的综合指南

冬明小哥_4617

发布时间：2024-10-17 22:27:16

994人浏览过

来源于dev.to

转载

nextjs app router：包含真实示例的综合指南

next.js 以其强大的功能和直观的设计彻底改变了 react 开发。随着 next.js 13 的发布，新的 app router 占据了中心舞台，为开发人员提供了更灵活、更强大的方式来构建应用程序。在这份综合指南中，我们将深入研究 app router，探索其功能和最佳实践。为了说明这些概念，我们将使用一个真实的示例：求职信生成器项目。

了解应用程序路由器

next.js 13 中的 app router 代表了我们在 react 应用程序中处理路由方式的范式转变。与之前的 pages router 不同，app router 使用基于文件系统的方法，该方法更符合我们对应用程序结构进行心理建模的方式。

应用路由器的主要优点：

直观的基于文件的路由：路由由应用程序目录中的文件结构定义。
改进的性能：对 react 服务器组件的内置支持。
增强灵活性：更轻松地实现布局、嵌套路由等。
内置优化：自动代码分割和预取。

应用路由器入门

让我们首先使用 app router 设置一个新的 next.js 13 项目。打开终端并运行：

npx create-next-app@latest my-app
cd my-app

出现提示时，请务必为“您想使用 app router 吗？”选择“是”。

使用 app router 进行基本路由

在 app router 中，每个文件夹代表一个路由段。让我们为求职信生成器创建一个简单的结构：

app/
├── page.tsx
├── layout.tsx
├── cover-letter/
│   └── page.tsx
└── templates/
    └── page.tsx

这里，根应用程序文件夹中的 page.tsx 代表主页。求职信和模板文件夹为这些各自的页面创建路线。

在 app/page.tsx 中：

export default function home() {
  return <h1>welcome to the cover letter generator</h1>;
}

在 app/cover-letter/page.tsx 中：

export default function coverletter() {
  return <h1>create your cover letter</h1>;
}

通过此结构，您可以导航到 / 访问主页，导航到 /cover-letter 访问求职信创建页面。

布局和嵌套路由

app router 的强大功能之一是能够创建嵌套布局。让我们为我们的应用程序添加一个通用布局。

在 app/layout.tsx 中：

export default function rootlayout({
  children,
}: {
  children: react.reactnode
}) {
  return (
    <html lang="en">
      <body>
        <nav>
          <a href="/">home</a>
          <a href="/cover-letter">create cover letter</a>
          <a href="/templates">templates</a>
        </nav>
        {children}
      </body>
    </html>
  );
}

此布局将应用于我们应用程序中的所有页面，提供一致的导航结构。

动态路线

动态路由对于基于参数生成内容的应用程序至关重要。让我们实现一个动态路由来查看特定的求职信模板。

创建一个新文件：app/templates/[id]/page.tsx:

export default function template({ params }: { params: { id: string } }) {
  return <h1>template {params.id}</h1>;
}

现在，导航到 /templates/1 或 /templates/formal 将使用相应的 id 渲染此组件。

GitHub操作助手

用大白话操作当前项目的 Git/GitHub——配置 GitHub（装 gh CLI + 登录 + 建仓库）、备份、拉取下载、查询历史、回滚代码、管理分支。当用户用日常语言表达 git 意图时触发（例如"git备份一下""git下载项目""git拉下来""git看看我改了啥""git回退到上一个版本""git新建个分支搞新功能""git合并到主分支""git

下载

服务器组件和数据获取

next.js 13 引入了 react server 组件，允许我们在服务器上获取数据。让我们在求职信生成器中实现这一点。

在 app/cover-letter/page.tsx 中：

async function gettemplates() {
  // simulate api call
  return [
    { id: 1, name: 'professional' },
    { id: 2, name: 'creative' },
    { id: 3, name: 'academic' },
  ];
}

export default async function coverletter() {
  const templates = await gettemplates();

  return (
    <div>
      <h1>create your cover letter</h1>
      <ul>
        {templates.map(template => (
          <li key={template.id}>{template.name}</li>
        ))}
      </ul>
    </div>
  );
}

该组件在服务器上获取数据，从而提高性能和 seo。

链接和导航

对于客户端导航，请使用 next.js 中的 link 组件。更新您的 app/layout.tsx：

import Link from 'next/link';

export default function RootLayout({
  children,
}: {
  children: React.ReactNode
}) {
  return (
    <html lang="en">
      <body>
        <nav>
          <Link href="/">Home</Link>
          <Link href="/cover-letter">Create Cover Letter</Link>
          <Link href="/templates">Templates</Link>
        </nav>
        {children}
      </body>
    </html>
  );
}