default.js
default.js
文件用于在 并行路由中渲染一个后备内容,当 Next.js 在完整页面加载后无法恢复 插槽的活动状态时使用。
在软导航期间,Next.js 会跟踪每个插槽的活动状态(子页面)。但是,对于硬导航(完整页面加载),Next.js 无法恢复活动状态。在这种情况下,对于与当前 URL 不匹配的子页面,可以渲染一个 default.js
文件。
考虑以下文件夹结构。@team
插槽有一个 settings
页面,但 @analytics
没有。
当导航到 /settings
时,@team
插槽将渲染 settings
页面,同时保持 @analytics
插槽的当前活动页面。
在刷新时,Next.js 将为 @analytics
渲染一个 default.js
。如果 default.js
不存在,则会渲染一个 404
页面。
此外,由于 children
是一个隐式插槽,当 Next.js 无法恢复父页面的活动状态时,你还需要创建一个 default.js
文件来为 children
渲染后备内容。
参考
params
(可选)
一个 Promise,解析后得到一个对象,包含从根段到插槽子页面的动态路由参数。例如:
示例 | URL | params |
---|---|---|
app/[artist]/@sidebar/default.js | /zack | Promise<{ artist: 'zack' }> |
app/[artist]/[album]/@sidebar/default.js | /zack/next | Promise<{ artist: 'zack', album: 'next' }> |
- 由于
params
属性是一个 Promise,你必须使用async/await
或 React 的use
函数来访问这些值。- 在第 14 版及更早版本中,
params
是一个同步属性。为了帮助向后兼容,你在 Next.js 15 中仍然可以同步访问它,但这个行为在将来会被弃用。
- 在第 14 版及更早版本中,