basic/.agents/skills/fa-framework-settings/references/menu-settings.md

导航菜单设置 (menu)

目录

• 导航菜单模式 (mode)
• 主导航点击模式 (mainMenuClickMode)
• 次导航展开行为
• 快捷键 (hotkeys)

导航菜单模式 (mode)

• 类型: 'side' | 'head' | 'single'
• 默认值: 'side'
• 说明: 设置导航菜单的显示模式
  • 'side' - 侧边栏模式(有主导航菜单)
  • 'head' - 顶部模式
  • 'single' - 侧边栏模式(无主导航菜单)

主导航菜单点击模式 (mainMenuClickMode)

• 类型: 'switch' | 'jump' | 'smart'
• 默认值: 'switch'
• 说明: 设置主导航菜单项的点击行为
  • 'switch' - 切换
  • 'jump' - 跳转
  • 'smart' - 智能选择,判断次导航是否只有且只有一个可访问的菜单进行切换或跳转操作

次导航菜单展开行为

subMenuUniqueExpand

• 类型: boolean
• 默认值: true
• 说明: 次导航菜单是否只保持一个子项的展开

subMenuCollapse

• 类型: boolean
• 默认值: false
• 说明: 次导航菜单是否收起

subMenuCollapseButton

• 类型: boolean
• 默认值: false
• 说明: 是否开启次导航菜单的展开/收起按钮

快捷键 (hotkeys)

• 类型: boolean
• 默认值: false
• 说明: 控制是否启用导航菜单相关的快捷键功能

完整示例

menu: {
  mode: 'side',
  mainMenuClickMode: 'switch',
  subMenuUniqueExpand: true,
  subMenuCollapse: false,
  subMenuCollapseButton: true,
  hotkeys: true,
}

常见配置

顶部导航菜单模式:

menu: {
  mode: 'head',
}

智能主导航菜单点击:

menu: {
  mainMenuClickMode: 'smart',
}

启用次导航菜单收起按钮:

menu: {
  subMenuCollapseButton: true,
}