default.js
default.js 文件的 API 参考。
当 Next.js 在整页加载后无法恢复 slot 的活动状态时,default.js 文件用于在 Parallel Routes 中渲染回退内容。
在软导航期间,Next.js 会跟踪每个 slot 的活动状态(子页面)。但是,对于硬导航(整页加载),Next.js 无法恢复活动状态。在这种情况下,可以为与当前 URL 不匹配的子页面渲染 default.js 文件。
考虑以下文件夹结构。@team slot 有一个 settings 页面,但 @analytics 没有。
当导航到 /settings 时,@team slot 将渲染 settings 页面,同时保持 @analytics slot 当前活动的页面。
刷新时,Next.js 将为 @analytics 渲染一个 default.js。如果 default.js 不存在,则会为命名 slot(@team、@analytics 等)返回错误,并要求你定义 default.js 才能继续。如果你想保留在这些情况下返回 404 的旧行为,可以创建一个包含以下内容的 default.js:
app/@team/default.js
import { notFound } from 'next/navigation'
export default function Default() {
notFound()
}此外,由于 children 是一个隐式 slot,当 Next.js 无法恢复父页面的活动状态时,你还需要创建一个 default.js 文件来为 children 渲染回退内容。如果没有为 children slot 创建 default.js,它将为该路由返回 404 页面。
参考#
params(可选)#
一个 promise,解析为一个对象,其中包含从根片段到 slot 子页面的动态路由参数。例如:
app/[artist]/@sidebar/default.js
export default async function Default({
params,
}: {
params: Promise<{ artist: string }>
}) {
const { artist } = await params
}app/[artist]/@sidebar/default.js
export default async function Default({ params }) {
const { artist } = await params
}| 示例 | URL | params |
|---|---|---|
app/[artist]/@sidebar/default.js | /zack | Promise<{ artist: 'zack' }> |
app/[artist]/[album]/@sidebar/default.js | /zack/next | Promise<{ artist: 'zack', album: 'next' }> |
- 由于
paramsprop 是一个 promise。你必须使用async/await或 React 的use函数来访问这些值。- 在版本 14 及更早版本中,
params是一个同步 prop。为了帮助向后兼容,你仍然可以在 Next.js 15 中同步访问它,但此行为将在未来被弃用。
- 在版本 14 及更早版本中,