布局与页面
了解如何创建你的第一个页面和布局,以及如何使用 Link 组件在它们之间建立链接。
Next.js 使用基于文件系统的路由,这意味着你可以使用文件夹和文件来定义路由。本页将指导你如何创建布局和页面,以及如何在它们之间建立链接。
创建页面#
页面是在特定路由上渲染的 UI。要创建页面,请在 app 目录中添加一个 page 文件,并默认导出一个 React 组件。例如,要创建一个索引页面(/):
export default function Page() {
return <h1>Hello Next.js!</h1>
}export default function Page() {
return <h1>Hello Next.js!</h1>
}创建布局#
布局是在多个页面之间共享的 UI。在导航时,布局会保留状态、保持交互性,并且不会重新渲染。
你可以通过从 layout 文件中默认导出一个 React 组件来定义布局。该组件应接受一个 children prop,它可以是页面或另一个布局。
例如,要创建一个将你的索引页面作为子级的布局,请在 app 目录中添加一个 layout 文件:
export default function DashboardLayout({
children,
}: {
children: React.ReactNode
}) {
return (
<html lang="en">
<body>
<main>{children}</main>
</body>
</html>
)
}export default function DashboardLayout({ children }) {
return (
<html lang="en">
<body>
<main>{children}</main>
</body>
</html>
)
}上面的布局被称为根布局,因为它定义在 app 目录的根部。根布局是必需的,并且必须包含 html 和 body 标签。
创建嵌套路由#
嵌套路由是由多个 URL 段组成的路由。例如,/blog/[slug] 路由由三个段组成:
/(根段)blog(段)[slug](叶段)
在 Next.js 中:
- 文件夹用于定义映射到 URL 段的路由段。
- 文件(如
page和layout)用于创建在某个段上显示的 UI。
要创建嵌套路由,你可以将文件夹相互嵌套。例如,要为 /blog 添加路由,请在 app 目录中创建一个名为 blog 的文件夹。然后,要使 /blog 可公开访问,请添加一个 page.tsx 文件:
// 占位导入
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>
)
}// 占位导入
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 文件:
export function generateStaticParams() {}
export default function Page() {
return <h1>Hello, Blog Post Page!</h1>
}export function generateStaticParams() {}
export default function Page() {
return <h1>Hello, Blog Post Page!</h1>
}用方括号包裹文件夹名称(例如 [slug])会创建一个动态路由段,它用于根据数据生成多个页面,例如博客文章、产品页面等。
嵌套布局#
默认情况下,文件夹层级结构中的布局也是嵌套的,这意味着它们通过 children prop 包裹子布局。你可以通过在特定路由段(文件夹)中添加 layout 来嵌套布局。
例如,要为 /blog 路由创建布局,请在 blog 文件夹中添加一个新的 layout 文件。
export default function BlogLayout({
children,
}: {
children: React.ReactNode
}) {
return <section>{children}</section>
}export default function BlogLayout({ children }) {
return <section>{children}</section>
}如果将上面两个布局组合起来,根布局(app/layout.js)将包裹 blog 布局(app/blog/layout.js),而 blog 布局又会包裹 blog 页面(app/blog/page.js)和博客文章页面(app/blog/[slug]/page.js)。
创建动态段#
动态段允许你创建根据数据生成的路由。例如,你不必为每篇博客文章手动创建路由,而是可以创建一个动态段,根据博客文章数据生成路由。
要创建动态段,请用方括号包裹段(文件夹)名称:[segmentName]。例如,在 app/blog/[slug]/page.tsx 路由中,[slug] 就是动态段。
export default async function BlogPostPage({
params,
}: {
params: Promise<{ slug: string }>
}) {
const { slug } = await params
const post = await getPost(slug)
return (
<div>
<h1>{post.title}</h1>
<p>{post.content}</p>
</div>
)
}export default async function BlogPostPage({ params }) {
const { slug } = await params
const post = await getPost(slug)
return (
<div>
<h1>{post.title}</h1>
<p>{post.content}</p>
</div>
)
}动态段中的嵌套布局也可以访问 params props。
使用搜索参数渲染#
在 Server Component 页面中,你可以使用 searchParams prop 访问搜索参数:
export default async function Page({
searchParams,
}: {
searchParams: Promise<{ [key: string]: string | string[] | undefined }>
}) {
const filters = (await searchParams).filters
}export default async function Page({ searchParams }) {
const filters = (await searchParams).filters
}使用 searchParams 会使你的页面选择动态渲染,因为它需要传入的请求来读取搜索参数。
Client Component 可以使用 useSearchParams hook 读取搜索参数。
了解更多关于 useSearchParams 在预渲染和动态渲染路由中的信息。
何时使用哪种方式#
- 当你需要搜索参数来为页面加载数据时(例如分页、从数据库筛选),使用
searchParamsprop。 - 当搜索参数仅在客户端使用时(例如筛选已通过 props 加载的列表),使用
useSearchParams。 - 作为一项小优化,你可以在回调或事件处理程序中使用
new URLSearchParams(window.location.search)读取搜索参数,而不会触发重新渲染。
在页面之间建立链接#
你可以使用 <Link> 组件在路由之间导航。<Link> 是 Next.js 内置的组件,它扩展了 HTML <a> 标签,以提供预取和客户端导航。
例如,要生成博客文章列表,请从 next/link 导入 <Link>,并向该组件传递 href prop:
import Link from 'next/link'
import { getPosts } from '@/lib/posts'
export default async function Posts() {
const posts = await getPosts()
return (
<ul>
{posts.map((post) => (
<li key={post.slug}>
<Link href={`/blog/${post.slug}`}>{post.title}</Link>
</li>
))}
</ul>
)
}import Link from 'next/link'
import { getPosts } from '@/lib/posts'
export default async function Posts() {
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 中在路由之间导航的主要方式。你还可以使用useRouterhook进行更高级的导航。
路由 Props 辅助类型#
Next.js 提供了一些实用类型,可从你的路由结构推断 params 和命名插槽:
- PageProps:
page组件的 Props,包括params和searchParams。 - LayoutProps:
layout组件的 Props,包括children和任何命名插槽(例如像@analytics这样的文件夹)。
这些是全局可用的辅助类型,在运行 next dev、next build 或 next typegen 时生成。
export default async function Page(props: PageProps<'/blog/[slug]'>) {
const { slug } = await props.params
return <h1>Blog post: {slug}</h1>
}export default function Layout(props: LayoutProps<'/dashboard'>) {
return (
<section>
{props.children}
</section>
)
}小知识
- 静态路由将
params解析为{}。PageProps、LayoutProps是全局辅助类型 —— 无需导入。- 类型在
next dev、next build或next typegen期间生成。