LayoutHeader 布局头部

LayoutHeader 是一个通用的布局头部组件,通常与 AgenticLayout 或 ChatLayout 配合使用,提供标题显示、侧边栏折叠控制和分享功能。

代码演示

API Playground

通过控制面板调试 title / showShare / leftCollapsible / rightCollapsible / 受控折叠与 leftExtra / rightExtra 自定义内容。

API Playground - 全部核心 props

最小用法

import { LayoutHeader } from '@ant-design/agentic-ui';

export default () => (
  <LayoutHeader
    title="AI 助手"
    onLeftCollapse={() => console.log('左侧折叠')}
    onRightCollapse={() => console.log('右侧折叠')}
    onShare={() => console.log('分享')}
  />
);

API

LayoutHeaderProps (LayoutHeaderConfig)

属性说明类型默认值版本
title标题文本string--
showShare是否显示分享按钮booleantrue-
leftCollapsible左侧是否可折叠booleantrue-
rightCollapsible右侧是否可折叠booleantrue-
leftCollapsed左侧折叠状态(受控)boolean--
rightCollapsed右侧折叠状态(受控)boolean--
leftDefaultCollapsed左侧默认折叠状态(非受控)booleanfalse-
rightDefaultCollapsed右侧默认折叠状态(非受控)booleanfalse-
onLeftCollapse左侧折叠按钮点击事件(collapsed: boolean) => void--
onRightCollapse右侧折叠按钮点击事件(collapsed: boolean) => void--
onShare分享按钮点击事件() => void--
leftExtra自定义左侧内容(标题左侧)ReactNode--
rightExtra自定义右侧内容(分享按钮右侧)ReactNode--
className自定义类名string--

模式说明

LayoutHeader 使用 rc-util 的 useMergedState 来管理折叠状态,同时支持受控和非受控模式。

  • 受控模式: 提供 leftCollapsed / rightCollapsed 和对应的 onChange 回调。
  • 非受控模式: 提供 leftDefaultCollapsed / rightDefaultCollapsed 作为初始值,组件内部维护状态。

这使得 LayoutHeader 既可以独立使用,也可以轻松集成到如 AgenticLayout 这样的复杂布局组件中。