Next.js 使用基于文件系統(tǒng)的路由,這意味著你可以通過(guò)文件夾和文件來(lái)定義路由。本頁(yè)將指導(dǎo)你如何創(chuàng)建布局和頁(yè)面,以及如何在它們之間鏈接。
頁(yè)面是在特定路由上渲染的 UI。要?jiǎng)?chuàng)建一個(gè)頁(yè)面,只需在 app
目錄中添加一個(gè) page
文件,并默認(rèn)導(dǎo)出一個(gè) React 組件。例如,要?jiǎng)?chuàng)建一個(gè)索引頁(yè)面(/
):
export default function Page() {
return <h1>Hello W3Cschool!</h1>
}
布局是在多個(gè)頁(yè)面之間共享的 UI。在導(dǎo)航時(shí),布局會(huì)保留狀態(tài)、保持交互性,并且不會(huì)重新渲染。
你可以通過(guò)從 layout
文件中默認(rèn)導(dǎo)出一個(gè) React 組件來(lái)定義布局。該組件應(yīng)接受一個(gè) children
屬性,該屬性可以是一個(gè)頁(yè)面或另一個(gè)布局。
例如,要?jiǎng)?chuàng)建一個(gè)接受索引頁(yè)面作為子元素的布局,在 app
目錄中添加一個(gè) layout
文件:
export default function DashboardLayout({
children,
}: {
children: React.ReactNode
}) {
return (
<html lang="zh">
<body>
{/* 布局 UI */}
{/* 在此處渲染頁(yè)面或嵌套布局 */}
<main>{children}</main>
</body>
</html>
)
}
上述布局被稱為根布局,因?yàn)樗?app
目錄的根部定義。根布局是必需的,并且必須包含 html
和 body
標(biāo)簽。
嵌套路由是由多個(gè) URL 段組成的路由。例如,/blog/[slug]
路由由三個(gè)段組成:
/
(根段)blog
(段)[slug]
(葉段)在 Next.js 中:
page
和 layout
)用于創(chuàng)建在段中顯示的 UI。
要?jiǎng)?chuàng)建嵌套路由,你可以將文件夾彼此嵌套。例如,要添加一個(gè) /blog
路由,在 app
目錄中創(chuàng)建一個(gè)名為 blog
的文件夾。然后,要使 /blog
公開訪問(wèn),添加一個(gè) page
文件:
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>
)
}
你可以繼續(xù)嵌套文件夾來(lái)創(chuàng)建嵌套路由。例如,要為特定博客文章創(chuàng)建一個(gè)路由,在 blog
文件夾中創(chuàng)建一個(gè)新 [slug]
文件夾,并添加一個(gè) page
文件:
function generateStaticParams() {}
export default function Page() {
return <h1>Hello, Blog Post Page!</h1>
}
小貼士:將文件夾名稱用方括號(hào)括起來(lái)(例如
[slug]
)會(huì)創(chuàng)建一個(gè)特殊的動(dòng)態(tài)路由段,用于從數(shù)據(jù)生成多個(gè)頁(yè)面。這對(duì)于博客文章、產(chǎn)品頁(yè)面等非常有用。
默認(rèn)情況下,文件夾層次結(jié)構(gòu)中的布局也會(huì)被嵌套,這意味著它們通過(guò) children
屬性包裹子布局。你可以在特定路由段(文件夾)中添加 layout
來(lái)嵌套布局。
例如,要為 /blog
路由創(chuàng)建一個(gè)布局,在 blog
文件夾中添加一個(gè)新 layout
文件。
export default function BlogLayout({
children,
}: {
children: React.ReactNode
}) {
return <section>{children}</section>
}
如果你將上述兩個(gè)布局結(jié)合起來(lái),根布局(app/layout.js
)將包裹博客布局(app/blog/layout.js
),而博客布局又將包裹博客頁(yè)面(app/blog/page.js
)和博客文章頁(yè)面(app/blog/[slug]/page.js
)。
你可以使用 <Link>
組件在路由之間導(dǎo)航。<Link>
是 Next.js 的內(nèi)置組件,它擴(kuò)展了 HTML 的 <a>
標(biāo)簽,提供了預(yù)取和客戶端導(dǎo)航功能。
例如,要生成博客文章列表,從 next/link
導(dǎo)入 <Link>
,并為組件傳遞一個(gè) href
屬性:
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 應(yīng)用程序中路由之間導(dǎo)航的主要和推薦方式。不過(guò),對(duì)于更高級(jí)的導(dǎo)航,你也可以使用 useRouter
鉤子。
閱讀 API 參考 ,了解有關(guān)本頁(yè)中提到的功能的更多信息。
layout.js
文件的 API 參考。page.js
文件的 API 參考。next/link
' 組件實(shí)現(xiàn)快速的客戶端導(dǎo)航。
更多建議: