NextJS中文文档 - Use Selected Layout Segments
useSelectedLayoutSegments
是一个客户端组件钩子,它允许你读取调用它的布局下方的活动路由段。
它对于在父布局中创建需要了解活动子段的 UI(如面包屑导航)非常有用。
tsx
'use client'
import { useSelectedLayoutSegments } from 'next/navigation'
export default function ExampleClientComponent() {
const segments = useSelectedLayoutSegments()
return (
<ul>
{segments.map((segment, index) => (
<li key={index}>{segment}</li>
))}
</ul>
)
}
jsx
'use client'
import { useSelectedLayoutSegments } from 'next/navigation'
export default function ExampleClientComponent() {
const segments = useSelectedLayoutSegments()
return (
<ul>
{segments.map((segment, index) => (
<li key={index}>{segment}</li>
))}
</ul>
)
}
须知:
参数
tsx
const segments = useSelectedLayoutSegments(parallelRoutesKey?: string)
useSelectedLayoutSegments
可选择性地接受一个 parallelRoutesKey
,它允许你读取该插槽内的活动路由段。
返回值
useSelectedLayoutSegments
返回一个字符串数组,包含从调用钩子的布局向下一级的活动段。如果不存在,则返回空数组。
例如,给定以下布局和 URL,返回的段将是:
布局 | 访问的 URL | 返回的段 |
---|---|---|
app/layout.js | / | [] |
app/layout.js | /dashboard | ['dashboard'] |
app/layout.js | /dashboard/settings | ['dashboard', 'settings'] |
app/dashboard/layout.js | /dashboard | [] |
app/dashboard/layout.js | /dashboard/settings | ['settings'] |
版本历史
版本 | 变更 |
---|---|
v13.0.0 | 引入 useSelectedLayoutSegments 。 |