如何创建布局和页面

Next.js 使用基于文件系统的路由，这意味着你可以使用文件夹和文件来定义路由。本页将指导你如何创建布局和页面，以及如何在它们之间建立链接。

创建页面

页面是在特定路由上渲染的 UI。要创建页面，在 app 目录中添加一个 page 文件并默认导出一个 React 组件。例如，要创建一个索引页面（/）：

app/page.tsx

TypeScript

export default function Page() {
  return <h1>Hello Next.js!</h1>
}

创建布局

布局是在多个页面之间共享的 UI。在导航时，布局会保留状态，保持交互性，并且不会重新渲染。

你可以通过从 layout 文件中默认导出一个 React 组件来定义布局。该组件应接受一个 children 属性，它可以是一个页面或另一个布局。

例如，要创建一个接受索引页面作为子项的布局，在 app 目录中添加一个 layout 文件：

app/layout.tsx

TypeScript

export default function DashboardLayout({
  children,
}: {
  children: React.ReactNode
}) {
  return (
    <html lang="en">
      <body>
        {/* Layout UI */}
        {/* Place children where you want to render a page or nested layout */}
        <main>{children}</main>
      </body>
    </html>
  )
}

上面的布局被称为根布局，因为它定义在 app 目录的根部。根布局是必需的，且必须包含 html 和 body 标签。

创建嵌套路由

嵌套路由是由多个 URL 段组成的路由。例如，/blog/[slug] 路由由三个段组成：

/（根段）
blog（段）
[slug]（叶段）

在 Next.js 中：

文件夹用于定义映射到 URL 段的路由段。
文件（如 page 和 layout）用于创建为某个段显示的 UI。

要创建嵌套路由，你可以将文件夹嵌套在其他文件夹中。例如，要添加 /blog 路由，在 app 目录中创建一个名为 blog 的文件夹。然后，要使 /blog 公开可访问，添加一个 page 文件：

app/blog/page.tsx

TypeScript

import { getPosts } from '@/lib/posts'
import { Post } from '@/ui/post'
 
export default async function Page() {
  const posts = await getPosts()
 
  return (
    <ul>
      {posts.map((post) => (
        <Post key={post.id} post={post} />
      ))}
    </ul>
  )
}

你可以继续嵌套文件夹来创建嵌套路由。例如，要为特定博客文章创建一个路由，在 blog 内创建一个新的 [slug] 文件夹并添加一个 page 文件：

显示包含嵌套 slug 文件夹和 page.js 文件的 blog 文件夹的文件层次结构

app/blog/[slug]/page.tsx

TypeScript

function generateStaticParams() {}
 
export default function Page() {
  return <h1>Hello, Blog Post Page!</h1>
}

值得注意的是：将文件夹名称用方括号括起来（例如 [slug]）会创建一个特殊的动态路由段，用于从数据生成多个页面。这对博客文章、产品页面等非常有用。

嵌套布局

默认情况下，文件夹层次结构中的布局也是嵌套的，这意味着它们通过 children 属性包装子布局。你可以通过在特定路由段（文件夹）中添加 layout 来嵌套布局。

例如，要为 /blog 路由创建一个布局，在 blog 文件夹中添加一个新的 layout 文件。

app/blog/layout.tsx

TypeScript

export default function BlogLayout({
  children,
}: {
  children: React.ReactNode
}) {
  return <section>{children}</section>
}

如果将上面的两个布局组合起来，根布局（app/layout.js）将包装博客布局（app/blog/layout.js），而博客布局将包装博客页面（app/blog/page.js）和博客文章页面（app/blog/[slug]/page.js）。

页面之间的链接

你可以使用 <Link> 组件在路由之间导航。<Link> 是 Next.js 内置组件，它扩展了 HTML 的 <a> 标签，提供预取和客户端导航功能。

例如，要生成博客文章列表，从 next/link 导入 <Link> 并将 href 属性传递给组件：

app/ui/post.tsx

TypeScript

import Link from 'next/link'
 
export default async function Post({ post }) {
  const posts = await getPosts()
 
  return (
    <ul>
      {posts.map((post) => (
        <li key={post.slug}>
          <Link href={`/blog/${post.slug}`}>{post.title}</Link>
        </li>
      ))}
    </ul>
  )
}

<Link> 是在 Next.js 应用程序中路由之间导航的主要和推荐方式。但是，你也可以使用 useRouter 钩子进行更高级的导航。

如何创建布局和页面

创建页面

创建布局

创建嵌套路由

嵌套布局

页面之间的链接

API 参考

Link

layout.js

page.js