useSelectedLayoutSegment

useSelectedLayoutSegment 是一个客户端组件 (Client Component) 钩子，用于读取调用它的布局下一层级的活动路由片段。

这对于导航 UI 非常有用，例如父布局中的选项卡可以根据活动子片段改变样式。

'use client'

import { useSelectedLayoutSegment } from 'next/navigation'

export default function ExampleClientComponent() {
  const segment = useSelectedLayoutSegment()

  return <p>活动片段: {segment}</p>
}

须知:

由于 useSelectedLayoutSegment 是一个客户端组件 (Client Component) 钩子，而布局默认是服务端组件 (Server Component)，因此 useSelectedLayoutSegment 通常通过导入到布局中的客户端组件调用。

useSelectedLayoutSegment 仅返回下一层级的片段。要返回所有活动片段，请参阅 useSelectedLayoutSegments

参数

const segment = useSelectedLayoutSegment(parallelRoutesKey?: string)

useSelectedLayoutSegment 可选接受一个 parallelRoutesKey，允许你读取该插槽内的活动路由片段。

返回值

useSelectedLayoutSegment 返回活动片段的字符串，如果不存在则返回 null。

例如，给定以下布局和访问的 URL，返回的片段如下：

布局	访问的 URL	返回的片段
`app/layout.js`	`/`	`null`
`app/layout.js`	`/dashboard`	`'dashboard'`
`app/dashboard/layout.js`	`/dashboard`	`null`
`app/dashboard/layout.js`	`/dashboard/settings`	`'settings'`
`app/dashboard/layout.js`	`/dashboard/analytics`	`'analytics'`
`app/dashboard/layout.js`	`/dashboard/analytics/monthly`	`'analytics'`

示例

创建活动链接组件

你可以使用 useSelectedLayoutSegment 创建一个活动链接组件，根据活动片段改变样式。例如，博客侧边栏中的精选文章列表：

'use client'

import Link from 'next/link'
import { useSelectedLayoutSegment } from 'next/navigation'

// 这个*客户端*组件将被导入到博客布局中
export default function BlogNavLink({
  slug,
  children,
}: {
  slug: string
  children: React.ReactNode
}) {
  // 导航到 `/blog/hello-world` 将返回 'hello-world'
  // 作为选中的布局片段
  const segment = useSelectedLayoutSegment()
  const isActive = slug === segment

  return (
    <Link
      href={`/blog/${slug}`}
      // 根据链接是否活动改变样式
      style={{ fontWeight: isActive ? 'bold' : 'normal' }}
    >
      {children}
    </Link>
  )
}

版本历史

版本	变更
`v13.0.0`	引入 `useSelectedLayoutSegment`。

参数

返回值

示例

创建活动链接组件

版本历史

On this page